Classe Transporter
Descrição
.acceptUnsecureConnection
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.acceptUnsecureConnection : Boolean
Descrição
The .acceptUnsecureConnection property contains True if 4D is allowed to establish an unencrypted connection when encrypted connection is not possible.
It contains False if unencrypted connections are unallowed, in which case an error in returned when encrypted connection is not possible.
Estão disponíveis portos seguros:
-
SMTP
- 465: SMTPS
- 587 ou 25: SMTP com atualização STARTTLS se for compat[ivel com o servidor.
-
IMAP
- 143: IMAP non-encrypted port
- 993: IMAP com atualização STARTTLS se for compatível com o servidor
-
POP3
- 110: Porta não criptografada POP3
- 995: POP3 com atualização STARTTLS se suportado pelo servidor.
.authenticationMode
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.authenticationMode : Text
Descrição
The .authenticationMode property contains the authentication mode used to open the session on the mail server.
Por padrão, o modo mais seguro suportado pelo servidor é usado.
Valores possíveis:
| Valor | Constantes | Comentário |
|---|---|---|
| CRAM-MD5 | IMAP authentication CRAM MD5 | Autenticação usando o protocolo CRAM-MD5 |
| LOGIN | IMAP authentication login | Autenticação usando o protocolo LOGIN |
| OAUTH2 | Autenticação IMAP OAUTH2 | Autenticação usando o protocolo OAuth2 |
| PLAIN | IMAP authentication plain | Autenticação usando o protocolo PLAIN |
.authenticationMode
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.authenticationMode : Text
Descrição
The .authenticationMode property contains the authentication mode used to open the session on the mail server.
Por padrão, o modo mais seguro suportado pelo servidor é usado.
Valores possíveis:
| Valor | Constantes | Comentário |
|---|---|---|
| APOP | Autenticação POP3 APOP | Autenticação usando o protocolo APOP (POP3 apenas) |
| CRAM-MD5 | POP3 authentication CRAM MD5 | Autenticação usando o protocolo CRAM-MD5 |
| LOGIN | POP3 authentication login | Autenticação usando o protocolo LOGIN |
| OAUTH2 | POP3 authentication OAUTH2 | Autenticação usando o protocolo OAuth2 |
| PLAIN | Autenticação POP3 simples | Autenticação usando o protocolo PLAIN |
.authenticationMode
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.authenticationMode : Text
Descrição
The .authenticationMode property contains the authentication mode used to open the session on the mail server.
Por padrão, o modo mais seguro suportado pelo servidor é usado.
Valores possíveis:
| Valor | Constantes | Comentário |
|---|---|---|
| CRAM-MD5 | SMTP authentication CRAM MD5 | Autenticação usando o protocolo CRAM-MD5 |
| LOGIN | SMTP authentication login | Autenticação usando o protocolo LOGIN |
| OAUTH2 | SMTP authentication OAUTH2 | Autenticação usando o protocolo OAuth2 |
| PLAIN | SMTP authentication plain | Autenticação usando o protocolo PLAIN |
.bodyCharset
História
| Release | Mudanças |
|---|---|
| 18 | Suporte de UTF8 base64 |
| 17 R5 | Adicionado |
.bodyCharset : Text
Descrição
The .bodyCharset property contains the charset and encoding used for the body part of the email.
Valores possíveis:
| Parâmetros | Valor | Comentário |
|---|---|---|
| mail mode ISO2022JP | US-ASCII_ISO-2022-JP_UTF8_QP |
|
| mail mode ISO88591 | ISO-8859-1 |
|
| mail mode UTF8 | US-ASCII_UTF8_QP | headerCharset & bodyCharset: US-ASCII se possível, caso contrário UTF-8 & Quoted-printable (valor padrão) |
| modo de correio UTF8 na base64 | US-ASCII_UTF8_B64 | headerCharset & bodyCharset: US-ASCII if possible, otherwise UTF-8 & base64 |
.connectionTimeOut
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.connectionTimeOut : Integer
Descrição
The .connectionTimeOut property contains the maximum wait time (in seconds) allowed to establish a connection to the server. By default, if the property has not been set in the server object (used to create the transporter object with SMTP New transporter, POP3 New transporter, or IMAP New transporter), the value is 30.
.headerCharset
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.headerCharset : Text
Descrição
A propriedade .headerCharset contém o conjunto de caracteres e a codificação usados para o cabeçalho de e-mail. O cabeçalho inclui as seguintes partes do e-mail:
- assunto,
- nome(s) de arquivo anexo,
- email name.
Valores possíveis:
| Parâmetros | Valor | Comentário |
|---|---|---|
| mail mode ISO2022JP | US-ASCII_ISO-2022-JP_UTF8_QP |
|
| mail mode ISO88591 | ISO-8859-1 |
|
| mail mode UTF8 | US-ASCII_UTF8_QP | headerCharset & bodyCharset: US-ASCII if possible, otherwise UTF-8 & Quoted-printable (default value) |
| modo de correio UTF8 na base64 | US-ASCII_UTF8_B64 | headerCharset & bodyCharset: US-ASCII if possible, otherwise UTF-8 & base64 |
.host
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.host : Text
Descrição
A propriedade .host contém o nome ou o endereço IP do servidor host. Utilizado para transacções postais (SMTP, POP3, IMAP).
.logFile
História
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.logFile : Text
Descrição
The .logFile property contains the path of the extended log file defined (if any) for the mail connection. Pode ser relativo (à pasta atual de Logs) ou absoluto.
Unlike regular log files (enabled via the SET DATABASE PARAMETER command), extended log files store MIME contents of all sent mails and do not have any size limit. Para mais informações sobre arquivos de registo estendidos, consultar:
- Conexões SMSTP - 4DSMTPLog.txt
- Conexões POP3 - 4DPOP3Log.txt
- Conexões IMAP - 4DIMAPLog.txt
.port
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.port : Integer
Descrição
A propriedade .port contém o número da porta utilizada para transações de email. By default, if the port property has not been set in the server object (used to create the transporter object with SMTP New transporter, POP3 New transporter, IMAP New transporter), the port used is:
- SMTP - 587
- POP3 - 995
- IMAP - 993
.sendTimeOut
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.sendTimeOut : Integer
Descrição
The .sendTimeOut property contains the maximum wait time (in seconds) of a call to .send( ) before a timeout occurs. By default, if the .sendTimeOut property has not been set in the server object, the value 100 is used.
.user
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.user : Text
Descrição
A propriedade .user contém o nome de usuário usado para autenticação no servidor de email .
.checkConnection()
História
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.checkConnection() : Object
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| Resultados | Object | <- | Estado da ligação do objecto transportador |
Descrição
The .checkConnection() function checks the connection using information stored in the transporter object, recreates the connection if necessary, and returns the status. Esta função permite verificar se os valores fornecidos pelo utilizador são válidos e consistentes.
Objeto devolvido
A função envia um pedido para o servidor de correio e devolve um objecto descrevendo o estado do correio. Este objeto pode conter as seguintes propriedades:
| Propriedade | Tipo | Descrição | |
|---|---|---|---|
| success | boolean | Verdadeiro se a verificação for bem sucedida, Falso de outra forma | |
| status | number | (apenas SMTP) Código de estado devolvido pelo servidor de correio (0 no caso de um problema não relacionado com o processamento de correio) | |
| statusText | text | Mensagem de estado devolvida pelo servidor de correio, ou último erro devolvido na pilha de erros 4D | |
| errors | collection | pilha de erros 4D (não devolvida se for recebida uma resposta do servidor de correio) | |
| [ ].errCode | number | Código de erro 4D | |
| [ ].message | text | Descrição do erro 4D | |
| [ ].componentSignature | text | Assinatura da componente interna que devolveu o erro |