SMTP New transporter
SMTP New transporter( server : Object ) : 4D.SMTPTransporter
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| server | Object | → | Informação de servidor de correio |
| Resultado | 4D.SMTPTransporter | ← | Objeto SMTP transporter |
História
| Release | Mudanças |
|---|---|
| 18 | Nova propriedade logFile |
| 17 R5 | Novas propriedades bodyCharset e headerCharset |
| 17 R4 | Adicionado |
Descrição
The SMTP New transporter command configures a new SMTP connection according to the server parameter and returns a new SMTP transporter object object. O objecto transportador devolvido será então normalmente utilizado para enviar mensagens de correio electrónico.
Este comando não abre qualquer ligação com o servidor SMTP. Este comando não abre qualquer ligação com o servidor SMTP.
A coleção SMTP é automaticamente fechada:
No parâmetro server, passe um objeto contendo as propriedades abaixo:
| server | Valor padrão (se omitido) |
|---|---|
| .acceptUnsecureConnection : Boolean True se o 4D tiver permissão para estabelecer uma conexão não criptografada | False |
| .accessTokenOAuth2: Text .accessTokenOAuth2: Objeto Cadeia ou objeto token que representa as credenciais de autorização OAuth2. Usado somente com OAUTH2 authenticationMode. Se accessTokenOAuth2 for usado, mas authenticationMode for omitido, o protocolo OAuth 2 será usado (se permitido pelo servidor). Não retornado no objeto SMTP transporter. | nenhum |
| .authenticationMode : Text o modo de autenticação usado para abrir a sessão no servidor de e-mail | o modo de autenticação mais seguro disponível no servidor é usado |
| .bodyCharset : Text o conjunto de caracteres e a codificação usados para a parte do corpo do e-mail | mail mode UTF8 (US-ASCII_UTF8_QP) |
| .connectionTimeOut : Integer o tempo máximo de espera (em segundos) permitido para estabelecer uma conexão com o servidor | 30 |
| .headerCharset : Text o conjunto de caracteres e a codificação usados para o cabeçalho de e-mail | mail mode UTF8 (US-ASCII_UTF8_QP) |
| .host : Text o nome ou o endereço IP do servidor host | mandatory |
| .keepAlive : Boolean Verdadeiro se a conexão SMTP deve ser mantida viva até que o objeto transportador seja destruído | True |
| .logFile : Text o caminho do arquivo de registro estendido definido (se houver) para a conexão de correio | nenhum |
| password : Text Senha do usuário para autenticação no servidor. Não retornado no objeto SMTP transporter. | nenhum |
| .port : Integer o número da porta utilizada para transações de email | 587 |
| .sendTimeOut : Integer o tempo máximo de espera (em segundos) de uma chamada para .send( ) antes que ocorra um timeout | 100 |
| .user : Text o nome de usuário usado para autenticação no servidor de email | nenhum |
Resultados
A função retorna um objeto SMTP transporter. Todas as propriedades retornadas são apenas leitura.
Exemplo
$server:=New object
$server.host:="smtp.gmail.com" //Mandatory
$server.port:=465
$server.user:="4D@gmail.com"
$server.password:="XXXX"
$server.logFile:="LogTest.txt" //Extended log to save in the Logs folder
var $transporter : 4D.SMTPTransporter
$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>There are many variations of passages of Lorem Ipsum available."\
+"The generated Lorem Ipsum is therefore always free from repetition, injected humour, or non-characteristic words etc.</p>"
$status:=$transporter.send($email)
If(Not($status.success))
ALERT("An error occurred sending the mail: "+$status.message)
End if
Propriedades
| Número de comando | 1608 |
| Thread safe | ✓ |