|
|
|
|
- Properties specific to Email variables
- Correspondence between the properties and the RFC standard
- WLanguage functions
Correo electrónico (Tipo de Variable)
The Email type is used to handle the email content as well as the associated information. The characteristics of an email can be defined and changed using different WLanguage properties. This type replaces and extends the Email structure by giving you the ability to handle several messages at the same time. Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
MonMessage is Email
MonMessage.Sender = sExpediteur
sDestinataire_1 is string = "aaa@gmail.com"
sDestinataire_2 is string = "bbb@gmail.com"
Add(MonMessage.Recipient, sDestinataire_1)
Add(MonMessage.Recipient, sDestinataire_2)
MonMessage.Subject = SAI_Sujet
MonMessage.Message = RTFToText(sNote)
MonMessage.HTML = RTFToHTML(sNote)
MaSession is emailSMTPSession
MaSession.ServerAddress = sServeur
IF EmailStartSession(MaSession) = False THEN RETURN
EmailSendMessage(MaSession, MonMessage, emailOptionEncodeHeader)
EmailCloseSession(MaSession)
Observaciones Properties specific to Email variables The following properties can be used to handle Email variables: | | | Name | Type used | Effect |
---|
Novedad versión 23AsynchronousEmailIdentifier | Character string | Email identifier (asynchronous mode only). WEBDEV only | Attach | Array of emailAttach | Contains the description of attached files. The number of attached files is unlimited. For more details, see emailAttach.Remark: If the file is attached manually, do not forget to specify the Name property, otherwise the image will not be sent along with the email. Example: oEmail.Attach[1].Contenu = fLoadBuffer(fDataDir() +
["\"] + "Email\" + sLogoSociété)
oEmail.Attach[1].ContentType = "image/gif"
oEmail.Attach[1].Nom = "logo.gif"
| Bcc | Array of character strings | Contains the addresses of non-official recipients: their name is not displayed in the email received by the official recipients (Recipient property). The addresses are limited to 127 characters. The number of non-official recipients is limited to 200. This limit can be exceeded in SMTP mode. However, some servers do not support the emails with an important number of recipients. | Category | Character string | List of keywords associated with the email. The keywords are separated by semicolons.Remark: If one of the keywords contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage. | Cc | Array of character strings | Contains the addresses of recipients in copy: their name is displayed in the email received by the official recipients (Recipient property). The addresses are limited to 127 characters. The number of recipients in copy is limited to 200. This limit can be exceeded in SMTP mode. However, some servers do not support the emails with an important number of recipients. | Certificate | Certificate | Certificate used to sign the email (header, content and attachments) before sending it. | DispositionNotification | Boolean | Outbound, used to request a confirmation that the email was read by the recipient (True). The recipient does not necessarily have to send a read receipt. Inbound, used to find out whether a read receipt was requested by the sender (True) or not. If a read receipt is requested, it has priority over the delivery receipt. This property is set to False by default. This property is supported by Outlook in Windows. | Header | Array of emailHeader | Headers of email. | HTML | Character string | Message with HTML formatting. Limited to 4 GB. This property is supported in POP3/SMTP only. | ID | Character string | Unique email identifier. This identifier remains constant for the entire email lifetime. This identifier is initialized when sending the email (EmailSendMessage).Remark: If the identifier contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage. | Message | Character string | Text of message (with simple text formatting). Limited to 2 GB (64 KB for Lotus Notes). Remarks: - If the message contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage.
- It is recommended not to exceed 98 characters per row in the text part of the message.. If an row exceeds 998 characters, the message may be considered spam..
| MessageID | Character string | Unique email identifier. This identifier remains constant for the entire email lifetime. This identifier is used to follow a conversation.
When sending an email, this variable specifies the email identifier. If this variable corresponds to an empty string, the identifier will be given by the server. The application that generates the identifier must check whether this identifier is unique.
When receiving an email, this variable specifies the email identifier.
This identifier must have the following format: <Identifier@domain>. For example: 1@192.168.2.210
| Out | Boolean | Specifies whether a message was read on the server: - False if the message was read.
- True if the message was not read.
| PlainText | Character string | Plain text of message. This variable is available for the incoming emails only. | Priority | Integer constant | Type of priority for the email. The possible values are as follows:- emailLowPriority: used for the really non-urgent emails.
- emailHighPriority: used for the urgent emails.
- emailNormalPriority (Default value): used for the non-urgent emails.
| ReceiveDate | Character string or DateTime variable | Date when the message was received. | Recipient | Array of character strings | Contains the addresses of main recipients. The number of recipients is limited to 20. This limit can be exceeded in SMTP mode. However, some servers do not support the emails with an important number of recipients. | Reference | Character string | Unique identifier of one or more reference emails linked to the current conversation.
| Versiones 24 y posterioresReturnAddressError | Character string | Return address if an error occurred. This address is managed by the POP3, IMAP and SMTP protocols. For more details, see Correspondence between the properties and the RFC standard. Remark: If the address contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage. | ReturnReceipt | Boolean | Outbound, used to request a delivery receipt from the recipient (True). The recipient does not necessarily have to send a delivery receipt. Inbound, used to find out whether a delivery receipt was requested by the sender (True) or no (False).
If a read receipt is requested, it has priority over the delivery receipt. This property is set to False by default. | Sender | Character string | Sender's address. This address must be a unique, valid email address. For more details, see Correspondence between the properties and the RFC standard.Remark: If the sender contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage. | SenderAddress | Character string | Address to which the answer to the message will be sent (up to 127 characters). Corresponds to Reply-To. For more details, see Correspondence between the properties and the RFC standard.Remark: If the address contains special characters or accented characters, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage. | Sensitivity | Integer constant | Type of confidentiality for the email. The possible values are as follows:- emailCompanyConfidential: Used for the in-house emails for example.
- emailNoSensitivity (Default value): No confidentiality.
- emailPersonal: Used for the personal emails for example.
- emailPrivate: Used for the private emails for example.
This property is not supported in Lotus Notes. | Signature | Integer constant | Status of email signature: - certificateExpired: Valid signature but expired certificate.
- certificateInvalid: Invalid signature or certificate.
- certificateUntrusted: Valid signature but untrusted certificate root.
- certificateOK: Trusted signature and certificate.
This property is read-only. | Source | Character string | Contains the source of incoming message (subject, sender, recipient, content, ...). | Subject | Character string | Message subject. Remark: If the subject contains special characters or accented characters, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage. | Remark: You can use non-Latin characters in the following properties: Subject, Message, Category, SenderAddress, Sender, ID. In this case, use the constant emailOptionEncodeHeader when the message is sent by EmailSendMessage.Correspondence between the properties and the RFC standard | | | | | | Version 23 and earlier | From version 24 | | Envoi | Reception | Envoi | Reception | From | Sender property | Populates the Sender property. | Sender property | Populates the Sender property. | Reply-To | SenderAddress property | Populates the SenderAddress property. | SenderAddress property | Populates the SenderAddress property. | Return-Path | SenderAddress property | Populates the SenderAddress property if "Reply-To" is empty. | ReturnAddressError property | Populates the ReturnAddressError property. | Return-Receipt-To (ReturnReceipt) | SenderAddress if specified, Sender property otherwise. | Sets the ReturnReceipt property to True if the received value is not empty. | SenderAddress if specified, Sender property otherwise. | Sets the ReturnReceipt property to True if the received value is not empty. | Disposition-Notification-To (DispositionNotification) | SenderAddress if specified, Sender property otherwise. | Sets the DispositionNotification property to True if the received value is not empty. | SenderAddress if specified, Sender property otherwise. | Sets the DispositionNotification property to True if the received value is not empty. |
WLanguage functions The following functions can be used to handle Email variables:
| | EmailBuildSource | Genera el código fuente del mensaje de correo electrónico que se enviará desde los Variable s en la estructura Email o en un Email Variable. | EmailChangeStatus | Cambia el estado de una Email en un servidor de mensajería. | EmailCopy | Copia una Email encontrada en un directorio a otro directorio de un servidor IMAP. | EmailDeleteMessage | Borra el Email actual utilizando el protocolo actual (POP3, IMAP, MS Exchange, Lotus Notes o Outlook). | EmailGetIndicator | Recupera los indicadores definidos en una sesión de Email de IMAP. | EmailImportHTML | Importa, en la estructura del correo electrónico o en un correo Variable, el contenido de un archivo HTML para enviarlo por Email. | EmailImportSource | Rellena un Email Variable utilizando el contenido de su Source Property o los diferentes Variable s de la estructura del email utilizando el contenido del Email.Source Variable. | EmailLoadAttachment | Añade un archivo adjunto a una Email. | EmailReadFirst | Lee el primer Email entrante según el protocolo utilizado (POP3 o IMAP, MS Exchange, Lotus Notes o Outlook). | EmailReadFirstHeader | Lee la cabecera del primer Email entrante según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook). | EmailReadLast | Lee el último Email entrante según el protocolo utilizado (POP3 o IMAP, MS Exchange, Lotus Notes o Outlook). | EmailReadLastHeader | Lee la cabecera del último Email entrante según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook). | EmailReadMessage | Lee un mensaje entrante de acuerdo con el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook). | EmailReadMessage Header | Lee la cabecera de un Email entrante según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook). | EmailReadNext | Lee la Email entrante encontrada después de la Email actual según el protocolo (POP3 o IMAP, MS Exchange, Lotus Notes o Outlook). | EmailReadNextHeader | Lee la cabecera del Email encontrado después del Email actual según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook). | EmailReadPrevious | Lee el Email encontrado antes del Email actual según el protocolo utilizado (POP3 o IMAP, MS Exchange, Lotus Notes o Outlook). | EmailReadPreviousHeader | Lee la cabecera del Email encontrado antes del Email actual según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook). | EmailReset | Restablece todos los Variable s de la estructura del correo electrónico o todos los Variable s de un correo electrónico Variable. | EmailSeekFirst | Encuentra uno o más correos electrónicos según los criterios especificados en el software de mensajería (Outlook, software de mensajería que utiliza el protocolo IMAP, ....). | EmailSeekFirstNotes | Busca uno o más correos electrónicos de acuerdo con los criterios especificados, en una base de datos Lotus Notes o Domino local o remota. | EmailSendMessage | Envía un Email utilizando un protocolo determinado (SMTP, MS Exchange, Lotus Notes, Outlook). |
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|