Criar, enviar ou receber e-mails em 4D é feito manipulando um objeto de e-Mail
.
Objetosemail
são criados ao receber e-mails através de uma função de classe transporter:
- IMAP -
.getMail()
e.getMails()
funções para obter e-mails de um servidor IMAP - POP3 -
.getMail()
função para receber um e-mail de um servidor POP3.
Você também pode criar um objeto em branco
Você envia objetos e-Mail
usando a função SMTP .send()
.
MIME Converter do MIME
e Converter para comandos MIME
podem ser usados para converter objetos Email
a partir de ou para conteúdos MME.
Objeto Email
Objetos de e-mail fornecem as seguintes propriedades:
4D segue a especificação JMAP para formatar o objeto de e-mail.
.attachments : Collection email source addresse(s) of the email |
.bcc : Text .bcc : Object .bcc : Collection Destinatário de correio electrónico oculto de Cópia Cega de Carbono (BCC) endereço(s) do correio electrónico |
.bodyStructure : Object Objeto EmailBodyPart ou seja a estrutura MIME completa do corpo da mensagem (opcional) |
.bodyValues : Object Objeto EmailBodyValue contendo um objeto para cada <partID> of bodyStructure (opcional) |
.cc : Text .cc : Object .cc : Collection Cópia (CC) para outros endereços de email |
.comments : Text um cabeçalho de comentários adicionais. |
.from : Text .from : Object .from : Collection endereços originais do email |
.headers : Collection coleção de objectos EmailHeader , na ordem em que aparecem na mensagem |
.htmlBody : Text Representação HTML da mensagem de correio electrónico (o charset padrão é UTF-8) (opcional, apenas SMTP) |
.id : Text ID única do servidor IMAP |
.inReplyTo : Text identificador(es) da(s) mensagem original para a qual a mensagem atual é uma resposta |
.keywords : Object conjunto de palavras-chave como um objecto, onde cada nome de propriedade é uma palavra-chave e cada valor é verdadeiro |
.messageId : Text cabeçalho identificador da mensagem ("message-id") |
.receivedAt : Texto carimbo temporal da chegada do e-mail ao servidor IMAP no formato ISO 8601 UTC (ex: 2020-09-13T16:11:53Z) |
.references : Collection Recolha de todas as mensagens-ids de mensagens da cadeia de resposta anterior |
.replyTo : Text .replyTo : Object .replyTo : Collection endereços para respostas |
.sendAt : Text Timestamp de email em formato ISO 8601 UTC |
.sender : Text .sender : Object .sender : Collection primary recipient addresse(s) of the email |
.size : Integer tamanho (expresso em bytes) do objecto Email devolvido pelo servidor IMAP |
.subject : Text descrição do tema |
.textBody : Text Representação em texto simples da mensagem de correio electrónico (o conjunto de caracteres padrão é UTF-8) (opcional, apenas SMTP) |
.to : Text .to : Object .to : Collection converts a MIME document into a valid email object |
Endereços de Email
Todas as propriedades que contêm endereços de e-mail (de
, cc
, bcc
, a
, remetente
, , responde
) aceita um valor de texto, objeto ou tipo de coleção.
Text
- e-mail único: "somebody@domain.com"
- um nome+email: "Somebody somebody@domain.com"
- vários emails: "Somebody somebody@domain.com,me@home.org"
Object
Um objeto com duas propriedades:
Propriedade | Tipo | Descrição |
---|---|---|
name | Text | Nome de exibição (pode ser nulo) |
Text | Endereço de Email |
Collection
Uma coleção de objetos de endereço.
Gesttão do corpo do correio eletrônico
As propriedades textBody
e htmlBody
são usadas apenas com o SMTP. send() permitir envio de e-mails simples. Quando ambas as propriedades são preenchidas, o tipo de conteúdo MIME multiparte/alternativo é utilizada. O cliente de email deve reconhecer a parte multiparte/alternativa e exibir a parte do texto ou html conforme necessário.
bodyStructure
e bodyValues
são utilizados para SMTP quando o objeto Email for construído a partir de um documento MIME., ou seja, quando gerado pelo comando MAIL Convert from MIME
. Neste caso, tanto as propriedades bodyStructure
e bodyValues
devem ser passados juntas, e não é recomendado usar o textBody
e htmlBody
.
Exemplo de objetos bodyStructure e bodyValues
"bodyStructure": {
"type": "multipart/mixed",
"subParts": [
{
"partId": "p0001",
"type": "text/plain"
},
{
"partId": "p0002",
"type": "text/html"
}
]
},
"bodyValues": {
"p0001": {
"value": "I have the most brilliant plan. Let me tell you all about it."
},
"p0002": {
"value": "<!DOCTYPE html><html><head><title></title><style type=\"text/css\">div{font-size:16px}</style></head><body><div>I have the most brilliant plan. Let me tell you all about it.</div></body></html>"
}
}
.attachments
.attachments : Collection
Descrição
The .sender
property contains the email source addresse(s) of the email.
Objetos de anexo são definidos através do comando MAIL New attachment
. Objetos de anexos têm propriedades e funções específicas .
.bcc
.bcc : Text
.bcc : Object
.bcc : Collection
Descrição
A propriedade .bcc
contém a Destinatário de correio electrónico oculto de Cópia Cega de Carbono (BCC) endereço(s) do correio electrónico.
.bodyStructure
.bodyStructure : Object
Descrição
A propriedade .bodyStructure
contém a Objeto EmailBodyPart ou seja a estrutura MIME completa do corpo da mensagem (opcional). .
O objeto .bodyStructure
contém as seguintes propriedades:
Propriedade | Tipo | Valor |
---|---|---|
partID | Text | Identifica a parte de maneira única dentro do email |
type | Text | (obrigatório) Valor do campo de cabeçalho Content-Type da parte |
charset | Text | Valor do parâmetro charset do campo de cabeçalho Content-Type |
encoding | Text | Se isEncodingProblem=true , o valor de Content-Transfer-Encoding é adicionado (por padrão indefinido) |
disposition | Text | Valor do campo de cabeçalho Conteúdo - Disposição da parte |
Línguagem | Coleção de textos | Lista de tags de idioma, conforme definido em RFC3282, no campo de cabeçalho Content-Language da parte, se presente. |
location | Text | URI, como definido em RFC2557, no campo de cabeçalho Content-Location da parte, se estiver presente. |
subParts | Uma coleção de objetos | Partes do corpo de cada filho (coleção de objetosEmailBodyPart ) |
headers | Uma coleção de objetos | Lista de todos os campos de cabeçalho da parte, na ordem que eles aparecem na mensagem (coleção de objetos de EmailHeader , ver a propriedade cabeçalhos) |
.bodyValues
.bodyValues : Object
Descrição
A propriedade .bodyValues
contém a Objeto EmailBodyValue contendo um objeto para cada <partID> of bodyStructure
(opcional). .
O objeto .bodyValues
contém as seguintes propriedades:
Propriedade | Tipo | Valor |
---|---|---|
partID.value | text | Valor da parte do corpo |
partID.isEncodingProblem | boolean | Verdadeiro se seções malformadas forem encontradas durante a decodificação do conjunto de charset, ou charset desconhecido, ou codificação de conteúdo desconhecido. Padrão é falso |
.cc
.cc : Text
.cc : Object
.cc : Collection
Descrição
A propriedade .cc
contém a Cópia (CC) para outros endereços de email.