SMTPTransporter

A classe SMTPTransporter permite-lhe configurar ligações SMTP e enviar correios eletrónicos através de objetos SMTP transporter.

Objecto SMTP Transporter

Os objetos SMTP Transporter são instanciados com o comando SMTP New transporter. Eles oferecem as propriedades abaixo e funções:

4D.SMTPTransporter.new()

4D.SMTPTransporter.new*( server : Object ) : 4D.SMTPTransporter

Parâmetro	Tipo		Descrição
server	Object	->	Informação de servidor de correio
Resultados	4D.SMTPTransporter	<-	Objeto SMTP Transporter

Descrição

A função 4D.SMTPTransporter.new() cria e retorna um novo objeto do tipo 4D.SMTPTransporter. É idêntico ao comando SMTP New transporter (atalho).

Para obter informações sobre os códigos de estado SMTP, consulte esta página.

Exemplo

 var $pw : Text
 var $options : Object
 var $transporter : 4D.SMTPTransporter
 $options:=New object

 $pw:=Request("Please enter your password:")
 $options.host:="smtp.gmail.com"

 $options.user:="test@gmail.com"
 $options.password:=$pw

 $transporter:=SMTP New transporter($options)

 $status:=$transporter.checkConnection()
 If($status.success=True)
    ALERT("SMTP connection check successful!")
 Else
    ALERT("Error # "+String($status.status)+", "+$status.statusText)
 End if

.keepAlive

História

Release	Mudanças
17 R4	Adicionado

.keepAlive* : Boolean

Descrição

A propriedade .keepAlive contém Verdadeiro se a conexão SMTP deve ser mantida viva até que o objeto transportador seja destruído, e Falso caso contrário. Por padrão, se a propriedade keepAlive não tiver sido definida no objeto server (usado para criar o objeto transporter com SMTP New transporter), ela será True.

A coleção SMTP é automaticamente fechada:

• quando o objeto transporter é destruído se a propriedade .keepAlive for true,
• após cada execução da função .send( ) se a propriedade .keepAlive estiver definida como false.

.send()

História

Release	Mudanças
17 R5	Suporte de conteúdo Mime
17 R4	Adicionado

.send*( mail : Object ) : Object

Parâmetro	Tipo		Descrição
mail	Object	->	Email para enviar
Resultados	Object	<-	Status SMTP

Descrição

A função .send() envia o objeto mail para o servidor SMTP definido no objeto transporter e retorna um objeto de status.

O objeto transporter já deve ter sido criado com o comando SMTP New transporter.

O método cria a ligação SMTP se esta ainda não estiver viva. Se a propriedade .keepAlive do objeto transporter for false, a conexão SMTP será automaticamente fechada após a execução de .send(); caso contrário, ela permanecerá ativa até que o objeto transporter seja destruído. Para obter mais informações, consulte a descrição do comando SMTP New transporter.

Em mail, passe um objeto Email válido para enviar. As propriedades de origem (de onde vem o e-mail) e de destino (um ou mais destinatários) devem ser incluídas, as restantes propriedades são opcionais.

Objeto devolvido

A função devolve um objecto que descreve o estado SMTP da operação. Este objeto pode conter as seguintes propriedades:

Propriedade	Tipo	Descrição
success	boolean	Verdadeiro se o envio for bem sucedido, False caso contrário
status	number	Código de estado devolvido pelo servidor SMTP (0 no caso de um problema não relacionado com o processamento de correio)
statusText	text	Mensagem de estado devolvida pelo servidor SMTP

No caso de um problema não relacionado ao processamento SMTP (por exemplo, uma propriedade obrigatória está faltando no e-mail), 4D gera um erro que pode ser interceptado usando um método instalado pelo comando ON ERR CALL. Use o comando Últimos Erros para obter informações sobre o erro.

Neste caso, o objecto de estatuto resultante contém os seguintes valores:

Propriedade	Valor
success	False
status	0
statusText	"Failed to send email"