Classe Transporter
Descrição
.acceptUnsecureConnection
Histórico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.acceptUnsecureConnection : Boolean
Descrição
A propriedade .acceptUnsecureConnection contém Verdadeiro se 4D for permitido estabelecer uma ligação não encriptada quando a ligação encriptada não é possível.
Contém False se conexões cifradas não forem permitidas, neste caso um erro é retornado quando a conexão criptografada não for possível.
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órico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.authenticationMode : Text
Descrição
A propriedade .authenticationMode< contém o modo de autenticação utilizado para abrir a sessão no servidor de correio.
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órico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.authenticationMode : Text
Descrição
A propriedade .authenticationMode contém o modo de autenticação utilizado para abrir a sessão no servidor de correio.
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 | Autenticação POP3 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órico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.authenticationMode : Text
Descrição
A propriedade .authenticationMode contém o modo de autenticação utilizado para abrir a sessão no servidor de correio.
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órico
| Release | Mudanças |
|---|---|
| 18 | Suporte de UTF8 base64 |
| 17 R5 | Adicionado |
.bodyCharset : Text
Descrição
A propriedade .bodyCharset contém o charset e a codificação utilizados para a parte do corpo do e-mail.
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 por defeito) |
| modo de correio UTF8 na base64 | US-ASCII_UTF8_B64 | headerCharset & bodyCharset: US-ASCII se possível, senão UTF-8 & base64 |
.connectionTimeOut
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.connectionTimeOut : Integer
Descrição
A propriedade .sendTimeOut contém o tempo máximo de espera (em segundos) de uma chamada para .send( ) antes de ocorrer um timeout. .
.headerCharset
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.headerCharset : Text
Descrição
A propriedade .headerCharset contém o charset e a codificação utilizados para o cabeçalho do correio eletrônico. 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 se possível, caso contrário UTF-8 & Quoted-printable (valor por defeito) |
| modo de correio UTF8 na base64 | US-ASCII_UTF8_B64 | headerCharset & bodyCharset: US-ASCII se possível, senão UTF-8 & base64 |
.host
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.host : Text
Descrição
A propriedade .host contém o nome ou o endereço IP do servidor anfitrião. Utilizado para transacções postais (SMTP, POP3, IMAP).
.logFile
Histórico
| Release | Mudanças |
|---|---|
| 17 R5 | Adicionado |
.logFile : Text
Descrição
A propriedade .logFile contém o caminho do arquivo de registo alargado definido (se existir) para a ligação de correio. Pode ser relativo (à pasta atual de Logs) ou absoluto.
Ao contrário dos arquivos de registo regulares (ativados através do comando SET DATABASE PARAMETER ), os arquivos de registo armazenam o conteúdo MIME de todos os e-mails enviados e não têm qualquer limite de tamanho. Para mais informações sobre arquivos de registo estendidos, consultar:
- SMTP connections - 4DSMTPLog.txt
- POP3 connections - 4DPOP3Log.txt
- IMAP connections - 4DIMAPLog.txt
.port
Histórico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.port : Integer
Descrição
A propriedade .port contém o número do porto utilizado para as transações postais. Por padrão, se a propriedade port não tiver sido definida no objeto server (utilizado para criar o objecto transportador com SMTP New transporter, POP3 New transporter, IMAP New transporter), a porta utilizada é:
- SMTP - 587
- POP3 - 995
- IMAP - 993
.sendTimeOut
Histórico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.sendTimeOut : Integer
Descrição
A propriedade .connectionTimeOut contém o tempo máximo de espera (em segundos) de uma chamada para .send( ) antes de ocorrer um timeout. Por padrão, se a propriedade .sendTimeOut não tiver sido definida no objecto server, é utilizado o valor 100.
.user
Histórico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.user : Text
Descrição
A propriedade .user contém o nome de usuário utilizado para autenticação no servidor de correio.
.checkConnection()
Histórico
| Release | Mudanças |
|---|---|
| 17 R4 | Adicionado |
.checkConnection() : Object
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| Resultados | Object | <- | Estado da ligação do objecto transportador |
|
Descrição
A função .checkConnection() verifica a ligação utilizando a informação armazenada no objeto de transporte, recria a ligação, se necessário, e devolve o estado. 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 |