Versão: 20 R5 BETA

Email

Creating, sending or receiving emails in 4D is done by handling an Email object.

Email objects are created when receiving mails through a transporter class function:

IMAP - .getMail() and .getMails() functions to get emails from an IMAP server
POP3 - .getMail() function to get an email from a POP3 server.

You can also create a new, blank Email object and then fill it with Email object properties.

You send Email objects using the SMTP .send() function.

MAIL Convert from MIME and MAIL Convert to MIME commands can be used to convert Email objects to and from MIME contents.

Objeto Email

Objetos de e-mail fornecem as seguintes propriedades:

4D follows the JMAP specification to format the Email object.


.attachments : Collection    collection of `4D.MailAttachment` object(s)
.bcc : Text .bcc : Object .bcc : Collection    Blind Carbon Copy (BCC) hidden email recipient addresse(s) of the email
.bodyStructure : Object    EmailBodyPart object, i.e. the full MIME structure of the message body (optional)
.bodyValues : Object    EmailBodyValue object, containing an object for each \<partID> of `bodyStructure` (optional)
.cc : Text .cc : Object .cc : Collection    Carbon Copy (CC) additional email recipient addresse(s) of the email
.comments : Text    additional comments header
.from : Text .from : Object .from : Collection    Originating address(es) of the email
.headers : Collection    collection of `EmailHeader` objects, in the order they appear in the message
.htmlBody : Text    HTML representation of the email message (default charset is UTF-8) (optional, SMTP only)
.id : Text    unique ID from the IMAP server
.inReplyTo : Text    message identifier(s) of the original message(s) to which the current message is a reply
.keywords : Object    set of keywords as an object, where each property name is a keyword and each value is true
.messageId : Text    message identifier header ("message-id")
.receivedAt : Text    timestamp of the email's arrival on the IMAP server in ISO 8601 UTC format (ex: 2020-09-13T16:11:53Z)
.references : Collection    Collection of all message-ids of messages in the preceding reply chain
.replyTo : Text .replyTo : Object .replyTo : Collection    addresse(s) for responses
.sendAt : Text    Email timestamp in ISO 8601 UTC format
.sender : Text .sender : Object .sender : Collection    email source addresse(s) of the email
.size : Integer    size (expressed in bytes) of the Email object returned by the IMAP server
.subject : Text    description of topic
.textBody : Text    Plain text representation of the email message (default charset is UTF-8) (optional, SMTP only)
.to : Text .to : Object .to : Collection    primary recipient addresse(s) of the email

Endereços de Email

All properties that contain email addresses (from, cc, bcc, to, sender, replyTo) accept a value of text, object, or collection type.

Text

e-mail único: "somebody@domain.com"
single display name+email: "Somebody somebody@domain.com"
several 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)
email	Text	Endereço de Email

Collection

Uma coleção de objetos de endereço.

Gesttão do corpo do correio eletrônico

The textBody and htmlBody properties are only used with the SMTP.send() function to allow sending simple mails. 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 and bodyValues are used for SMTP when the Email object is built from a MIME document, e.g. when generated by the MAIL Convert from MIME command. In this case, both bodyStructure and bodyValues properties must be passed together, and it is not recommended to use textBody and 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 .attachments property contains a collection of 4D.MailAttachment object(s).

Attachment objects are defined through the MAIL New attachment command. Attachment objects have specific properties and functions.

.bcc

.bcc : Text
.bcc : Object
.bcc : Collection

Descrição

The .bcc property contains the Blind Carbon Copy (BCC) hidden email recipient addresse(s) of the email.

.bodyStructure

.bodyStructure : Object

Descrição

The .bodyStructure property contains the EmailBodyPart object, i.e. the full MIME structure of the message body (optional). See Handling body part section.

The .bodyStructure object contains the following properties:

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	If `isEncodingProblem=true`, the Content-Transfer-Encoding value is added (by default undefined)
disposition	Text	Valor do campo de cabeçalho Conteúdo - Disposição da parte
Línguagem	Coleção de textos	List of language tags, as defined in RFC3282, in the Content-Language header field of the part, if present.
location	Text	URI, as defined in RFC2557, in the Content-Location header field of the part, if present.
subParts	Uma coleção de objetos	Body parts of each child (collection of EmailBodyPart objects)
headers	Uma coleção de objetos	List of all header fields in the part, in the order they appear in the message (collection of EmailHeader objects, see headers property)

.bodyValues

.bodyValues : Object

Descrição

The .bodyValues property contains the EmailBodyValue object, containing an object for each \<partID> of bodyStructure (optional). See Handling body part section.

The .bodyValues object contains the following properties:

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

The .cc property contains the Carbon Copy (CC) additional email recipient addresse(s) of the email.

.comments

.comments : Text

Descrição

The .comments property contains an additional comments header.

Os comentários só aparecem na seção de cabeçalho da mensagem (mantendo o corpo da mensagem intocado).

For specific formatting requirements, please consult the RFC#5322.

.from

.from : Text
.from : Object
.from : Collection

Descrição

The .from property contains the Originating address(es) of the email.

Each email you send out has both the sender and from addresses:

o domínio do remetente é o que o servidor de e-mail de recebimento recebe ao abrir a sessão,
o endereço a partir é o que o(s) destinatário(s) verá(s).

Para uma melhor capacidade de entrega, é recomendado usar o mesmo endereço de e para o remetente.

.headers

.headers : Collection

Descrição

The .headers property contains a collection of EmailHeader objects, in the order they appear in the message. Esta propriedade permite que usuários adicionem cabeçalhos estendidos (registrados) ou definidos pelo usuário (não registrados, começando com cabeçalhos "X").

If an EmailHeader object property defines a header such as "from" or "cc" which is already set as a property at the mail level, the EmailHeader property is ignored.

Cada objeto da coleção de cabeçalhos pode conter as propriedades abaixo:

Propriedade	Tipo	Valor
[].name	text	(mandatory) Header field name as defined in RFC#5322. Caso seja nulo ou indefinido, o campo cabeçalho não será adicionado ao cabeçalho MIME.
[].value	text	Header field values as defined in RFC#5322

.htmlBody

.htmlBody : Text

Descrição

The .htmlBody property contains the HTML representation of the email message (default charset is UTF-8) (optional, SMTP only). See Handling body part section.

.id

.id : Text

Descrição

IMAP transporter only.

The .id property contains the unique ID from the IMAP server.

.inReplyTo

.inReplyTo : Text

Descrição

The .inReplyTo property contains the message identifier(s) of the original message(s) to which the current message is a reply.

For specific formatting requirements, please consult the RFC#5322.

.keywords

.keywords : Object

Descrição

The .keywords property contains a set of keywords as an object, where each property name is a keyword and each value is true.

This property is the "keywords" header (see RFC#4021).

Propriedade	Tipo	Valor
.\<keyword>	boolean	Palavra-chave a definir (valor deve ser verdadeiro)

Palavra-chave reservada.

$draft - Indica que uma mensagem é um rascunho
$seen - Indica uma mensagem que foi lida
$flagged - Indica uma mensagem que requer atenção especial (por exemplo, Urgent)
$answered - Indica uma mensagem que foi respondida
$deleted - Indica uma mensagem para deletar

Exemplo

 $mail.keywords["$flagged"]:=True
 $mail.keywords["4d"]:=True

.messageId

.messageId : Text

Descrição

The .messageId property contains a message identifier header ("message-id").

Este cabeçalho geralmente é "lettersOrNumbers@domainname", por exemplo, "abcdef.123456@4d.com". Este ID exclusivo é usado em particular em fóruns ou listas públicas de e-mail. Em geral, os servidores de email adicionam automaticamente este cabeçalho às mensagens que enviam.

.receivedAt

.receivedAt : Text

Descrição

IMAP transporter only.

The .receivedAt property contains the timestamp of the email's arrival on the IMAP server in ISO 8601 UTC format (ex: 2020-09-13T16:11:53Z).

.references

.references : Collection

Descrição

The .references property contains the Collection of all message-ids of messages in the preceding reply chain.

For specific formatting requirements, please consult the RFC#5322.

.replyTo

.replyTo : Text
.replyTo : Object
.replyTo : Collection

Descrição

The .replyTo property contains the addresse(s) for responses.

.sendAt

.sendAt : Text

Descrição

The .sendAt property contains the Email timestamp in ISO 8601 UTC format.

.sender

.sender : Text
.sender : Object
.sender : Collection

Descrição

The .sender property contains the email source addresse(s) of the email.

Each email you send out has both the sender and from addresses:

o domínio do remetente é o que o servidor de e-mail de recebimento recebe ao abrir a sessão,
o endereço a partir é o que o(s) destinatário(s) verá(s).

Para uma melhor capacidade de entrega, é recomendado usar o mesmo endereço de e para o remetente.

.size

.size : Integer

Descrição

IMAP transporter only.

The .size property contains the size (expressed in bytes) of the Email object returned by the IMAP server.

.subject

.subject : Text

Descrição

The .subject property contains the description of topic.

.textBody

.textBody : Text

Descrição

The .textBody property contains the Plain text representation of the email message (default charset is UTF-8) (optional, SMTP only). See Handling body part section.

.to

.to : Text
.to : Object
.to : Collection

Descrição

The .to property contains the primary recipient addresse(s) of the email.

MAIL Convert from MIME

História

Release	Mudanças
18	Adicionado

MAIL Convert from MIME( mime : Blob ) : Object
MAIL Convert from MIME( mime : Text ) : Object

Parâmetro	Tipo		Descrição
mime	Blob, Text	->	E-mail no MIME
Resultados	Object	<-	Objeto Email

Descrição

The MAIL Convert from MIME command converts a MIME document into a valid email object.

4D follows the JMAP specification to format the returned email object.

Pass in mime a valid MIME document to convert. Pode ser fornecido por qualquer servidor de correio ou aplicativo. You can pass a BLOB or a text mime parameter. Se o MIME vier de um arquivo, é recomendado utilizar um parâmetro BLOB para evitar problemas relacionados ao conjunto de caracteres e conversões de quebra de linha.

Objeto devolvido

Objeto Email.

Exemplo 1

Se quiser carregar um modelo de e-mail salvo como MIME em um documento de texto e enviar um e-mail:

var $mime: Blob
var $mail;$server;$transporter;$status: Object

$mime:=File("/PACKAGE/Mails/templateMail.txt").getContent())

$mail:=MAIL Convert from MIME($mime)
$mail.to:="smith@mail.com"
$mail.subject:="Hello world"

$server:=New object
$server.host:="smtp.gmail.com"
$server.port:=465
$server.user:="test@gmail.com"
$server.password:="XXXX"

$transporter:=SMTP New transporter($server)
$status:=$transporter.send($mail)

Exemplo 2

Neste exemplo, você envia diretamente um documento 4D Write Pro contendo fotos:

var $mime: Blob
var $email;$server;$transporter;$status: Object

// Mime export of the 4D Write Pro document WP EXPORT VARIABLE(WParea;$mime;wk mime html)

// convert 4D Write Pro Mime variable in mail object
$email:=MAIL Convert from MIME($mime)

// Fill your mail object headers
$email.subject:="4D Write Pro HTML body"
$email.from:="YourEmail@gmail.com"
$email.to:="RecipientEmail@mail.com"

$server:=New object
$server.host:="smtp.gmail.com"
$server.port:=465
$server.user:="YourEmail@gmail.com"
$server.password:="XXXX"

$transporter:=SMTP New transporter($server)
$status:=$transporter.send($email)

MAIL Convert to MIME

História

Release	Mudanças
17 R4	Adicionado
17 R5	Modificado

MAIL Convert to MIME( mail : Object { ; options : Object } ) : Text

Parâmetro	Tipo		Descrição
mail	Object	->	Objeto Email
options	Object	->	Opções de codificação e Charset
Resultados	Text	<-	Email objeto convertido em MIME

Descrição

The MAIL Convert to MIME command converts an email object into MIME text. This command is called internally by SMTP_transporter.send( ) to format the email object before sending it. Ele pode ser usado para analisar o formato MIME do objeto.

In mail, pass the content and the structure details of the email to convert. Isso inclui informações como os endereços de e-mail (remetente e destinatário(s)), a própria mensagem e o tipo de exibição para a mensagem.

4D follows the JMAP specification to format the email object.

In options, you can set a specific charset and encoding configuration for the mail. As seguintes propriedades estão disponíveis:

Propriedade

Tipo

Descrição

headerCharset

Text

Charset e codificação usados para as seguintes partes do e-mail: assunto, nomes de arquivos de anexo e atributos de nome de e-mail. Possible values:

Constant	Value	Comment
mail mode ISO2022JP	US-ASCII_ISO-2022-JP_UTF8_QP	headerCharset: US-ASCII if possible, Japanese (ISO-2022-JP) & Quoted-printable if possible, otherwise UTF-8 & Quoted-printable bodyCharset: US-ASCII if possible, Japanese (ISO-2022-JP) & 7-bit if possible, otherwise UTF-8 & Quoted-printable
mail mode ISO88591	ISO-8859-1	headerCharset: ISO-8859-1 & Quoted-printable bodyCharset: ISO-8859-1 & 8-bit
mail mode UTF8	US-ASCII_UTF8_QP	headerCharset & bodyCharset: US-ASCII if possible, otherwise UTF-8 & Quoted-printable (default value)
mail mode UTF8 in base64	US-ASCII_UTF8_B64	headerCharset & bodyCharset: US-ASCII if possible, otherwise UTF-8 & base64

bodyCharset

Text

Charset e codificação usados para o conteúdo html e corpo do e-mail. Valores possíveis: o mesmo que para headerCharset (ver acima)

If the options parameter is omitted, the mail mode UTF8 configuration is used for header and body parts.

Exemplo

var $mail: Object
var $mime: Text
$mail:=New object

// Creation of a mail
$mail.from:="tsales@massmarket.com"
$mail.subject:="Terrific Sale! This week only!"
$mail.textBody:="Text format email"
$mail.htmlBody:="<html><body>HTML format email</body></html>"
$mail.to:=New collection
$mail.to.push(New object ("email";"noreply@4d.com"))
$mail.to.push(New object ("email";"test@4d.com"))

// transform the mail object in MIME
$mime:=MAIL Convert to MIME($mail)

// Contents of $mime:
// MIME-Version: 1.0
// Date: Thu, 11 Oct 2018 15:42:25 GMT
// Message-ID: <7CA5D25B2B5E0047A36F2E8CB30362E2>
// Sender: tsales@massmarket.com
// From: tsales@massmarket.com
// To: noreply@4d.com
// To: test@4d.com
// Content-Type: multipart/alternative; boundary="E0AE5773D5E95245BBBD80DD0687E218"
// Subject: Terrific Sale! This week only!
//
// --E0AE5773D5E95245BBBD80DD0687E218
// Content-Type: text/plain; charset="UTF-8"
// Content-Transfer-Encoding: quoted-printable
//
// Text format email
// --E0AE5773D5E95245BBBD80DD0687E218
// Content-Type: text/html; charset="UTF-8"
// Content-Transfer-Encoding: quoted-printable
//
// <html><body>HTML format email</body></html>
// --E0AE5773D5E95245BBBD80DD0687E218--

Objeto Email​

Endereços de Email​

Text​

Object​

Collection​

Gesttão do corpo do correio eletrônico​

Exemplo de objetos bodyStructure e bodyValues​

.attachments​

Descrição​

.bcc​

Descrição​

.bodyStructure​

Descrição​

.bodyValues​

Descrição​

.cc​

Descrição​

.comments​

Descrição​

.from​

Descrição​

.headers​

Descrição​

.htmlBody​

Descrição​

.id​

Descrição​

.inReplyTo​

Descrição​

.keywords​

Descrição​

Exemplo​

.messageId​

Descrição​

.receivedAt​

Descrição​

.references​

Descrição​

.replyTo​

Descrição​

.sendAt​

Descrição​

.sender​

Descrição​

.size​

Descrição​

.subject​

Descrição​

.textBody​

Descrição​

.to​

Descrição​

MAIL Convert from MIME​

Descrição​

Objeto devolvido​

Exemplo 1​

Exemplo 2​

MAIL Convert to MIME​

Descrição​

Exemplo​

Objeto Email

Endereços de Email

Text

Object

Collection

Gesttão do corpo do correio eletrônico

Exemplo de objetos bodyStructure e bodyValues

.attachments

Descrição

.bcc

Descrição

.bodyStructure

Descrição

.bodyValues

Descrição

.cc

Descrição

.comments

Descrição

.from

Descrição

.headers

Descrição

.htmlBody

Descrição

.id

Descrição

.inReplyTo

Descrição

.keywords

Descrição

Exemplo

.messageId

Descrição

.receivedAt

Descrição

.references

Descrição

.replyTo

Descrição

.sendAt

Descrição

.sender

Descrição

.size

Descrição

.subject

Descrição

.textBody

Descrição

.to

Descrição

MAIL Convert from MIME

Descrição

Objeto devolvido

Exemplo 1

Exemplo 2

MAIL Convert to MIME

Descrição

Exemplo