4D v18
SMTP New transporter
- Manual de linguagem 4D
-
-
- attachment.cid
- attachment.disposition
- attachment.name
- attachment.path
- attachment.type
- transporter.acceptUnsecureConnection
- transporter.authenticationMode
- transporter.bodyCharsetUpd
- transporter.connectionTimeOut
- transporter.headerCharsetUpd
- transporter.host
- transporter.keepAlive
- transporter.logFile
- transporter.port
- transporter.sendTimeOut
- transporter.user
- SMTP_transporter.send( )
- SMTP_transporter.checkConnection( )
- attachment.getContent( )New
- MAIL Convert from MIMENew
- MAIL Convert to MIME
- MAIL New attachment
- SMTP New transporterUpd
SMTP New transporter
| SMTP New transporter ( servidor ) -> Resultado | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| servidor | Objeto |
|
Informação de servidor de email | |||||
| Resultado | Objeto |
|
objeto transporter SMTP | |||||
O comando SMTP New transporter configura uma nova conexão SMTP de acordo com o parâmetro servidor e devolve um novo objeto transportador. O objeto transportador devolvido geralmente será usado para enviar correios.
No parâmetro servidor, passe um objeto que contenha as propriedades abaixo:
| Propriedade | Tipo | Descrição | ||||||||||||
| host | Texto | Nome ou endereço IP do servidor local para usar em transações SMTP. | ||||||||||||
| port | Número | (opcional) Porta a utilizar para transações SMTP. Valor pré-determinado=587 | ||||||||||||
| keepAlive | Booleano | para manter a conexão ativa até que se destrua o objeto transportador. Valor padrão=True | ||||||||||||
| connectionTimeOut | Número | (opcional) Tempo de espera máximo (em segundos) para estabelecer uma conexão com o servidor. Valor pré-determinado=30 | ||||||||||||
| sendTimeOut | Número | (opcional) Tempo máximo de espera (em segundos) de uma chamada sendMail antes do tempo de espera. Valor pré-determinado=100 | ||||||||||||
| authenticationMode | Texto | Modo de autenticação utilizado para abrir a sessão no servidor SMTP (*). Valores possíveis:
| ||||||||||||
| user | Texto | Nome de usuário para a autenticação no servidor | ||||||||||||
| password | Texto | Senha de usuário para a autenticação no servidor | ||||||||||||
| acceptUnsecureConnection | Booleano | True para permitir que 4D estabeleça uma conexão não cifrada se a conexão cifrada não for possível (**). Se for False, um erro é devolvido se a conexão cifrada não for possível. Valor pré-determinado=False | ||||||||||||
| logFile | Text | (optional) Rota para o arquivo histórico ampliado(***). Pode ser relativo (à pasta atual de Logs) ou absoluto | ||||||||||||
| headerCharset | Texto | (opcional) Charset e codificação utilizada para as seguintes parte do email: assunto, nomes de arquivos adjuntos, e atributos de nome de email. Valores possíveis:
| ||||||||||||
| bodyCharset | Texto | (opcional) Charset e codificación utilizada para o conteúdo html e corpo de texto de email. Valores possíveis: igual que para headerCharset (ver acima) |
(*) Se authenticationMode for nulo ou não definido é utilizado o modo de autenticação mais seguro permitido pelo servidor.
(**) As portas seguras SMTP disponíveis são:
- 465: SMTPS
- 587 ou 25: SMTP com atualização STARTTLS se o servidor admitir.
(***) Ao contrário de arquivos histórico normais (ativados com o comando SET DATABASE PARAMETER), arquivos de log estendidos armazenam conteúdos MIME de todos os emails enviados e não tem um tamanho limite. Para saber mais, veja a seção 4DSMTPLog.txt.
Objeto Retornado
O objeto transportador devolvido contém as propriedades e métodos abaixo de apenas leitura:
| Propriedade | Tipo | Descrição |
| transporter.host | Texto | Nome ou endereço IP do servidor local utilizado para as transações SMTP. |
| transporter.port | Número | Porta utilizada para transações SMTP. |
| transporter.keepAlive | Booleano | True se a conexão for mantida ativa até que se destrua o objeto transportador. |
| transporter.connectionTimeOut | Número | Tempo de espera máximo (em segundos) para estabelecer uma conexão com o servidor. |
| transporter.sendTimeOut | Número | Tempo de espera máximo (em segundos) de uma chamada sendMail antes do tempo de espera |
| transporter.acceptUnsecureConnectionn | Booleano | True se for permitido que 4D estableça uma conexão não cifrada quando a conexão cifrada não for possível. False se não for permitido, em cujo caso um erro é devolvido quando a conexão cifrada não for possível. |
| transporter.authenticationMode | Texto | Modo de autenticação realmente utilizado para abrir a sessão no servidor SMTP. |
| transporter.user | Texto | Nome usuário para autenticação no servidor |
| transporter.logFile | Texto | Rota para o arquivo histórico (se algum) |
| transporter.headerCharset | Texto | Charset e codificação utilizada para o cabeçalho e os nomes de mail |
| transporter.bodyCharset | Texto | Charset e codificação utilizada para o corpo de mail |
| Method | Descrição | Envia mensagens. |
| SMTP_transporter.checkConnection( ) | Checar autenticação. |
Lembre que este comando não abre nenhuma conexão ao servidor SMTP. A conexão SMTP é aberta realmente quando o método for executado SMTP_transporter.send( ).
A conexão SMTP é fechada automaticamente:
- quando o objeto transportador é destruido se a propriedade keepAlive for verdadeira (como padrão),
- depois de cada execução do método SMTP_transporter.send( ) se a propriedade keepAlive for definida como falsa.
$server:=New object
$server.host:="smtp.gmail.com" //Mandatory
$server.port:=465
$server.user:="4D@gmail.com"
$server.password:="XXXX"
$server.logFile:="LogTest.txt" //Amplia o histórico para salvar a pasta Logs
$transporter:=SMTP New transporter($server)
$email:=New object
$email.subject:="my first mail "
$email.from:="4d@gmail.com"
$email.to:="4d@4d.com;test@4d.com"
$email.textBody:="Hello World"
$email.htmlBody:="<h1>Hello World</h1><h4>'Neque porro quisquam est qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit...'</h4>\
<p>Hámuitas variações de passagens de Lorem Ipsum disponíveis."\
+"O Lorem Impsum gerado é portanto sempre livre de repetição, humor ou palavras não características,. etc.</p>"
$status:=$transporter.send($email)
If(Not($status.success))
ALERT("An error occurred sending the mail: "+$status.statusText)
End if
MAIL Convert to MIME
SMTP_transporter.checkConnection( )
SMTP_transporter.send( )
transporter.acceptUnsecureConnection
transporter.authenticationMode
transporter.connectionTimeOut
transporter.host
transporter.keepAlive
transporter.logFile
transporter.port
transporter.sendTimeOut
transporter.user
Produto: 4D
Tema: Mail
Número
1608
Criado por: 4D v17 R4
Modificado: 4D v17 R5
Modificado: 4D v18
Manual de linguagem 4D ( 4D v18)
