PC SOFT

AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

  • Properties specific to the description of Email variables
  • Functions
  • Limits
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 App
Otros
Procedimientos almacenados
Email (Type of variable)
 
The Email type is used to handle the email content as well as the associated information. The email characteristics can be defined and modified by several WLanguage properties.
This type replaces and extends the Email structure by giving you the ability to handle several messages at the same time.
Note: See Declaring a variable for more details.
Versiones 17 y posteriores
iPhone/iPad This type of variable is now available for the iPhone and iPad applications.
Nueva funcionalidad versión 17
iPhone/iPad This type of variable is now available for the iPhone and iPad applications.
iPhone/iPad This type of variable is now available for the iPhone and iPad applications.
Versiones 21 y posteriores
Universal Windows 10 App This type of variable is now available in Universal Windows 10 App mode.
Nueva funcionalidad versión 21
Universal Windows 10 App This type of variable is now available in Universal Windows 10 App mode.
Universal Windows 10 App This type of variable is now available in Universal Windows 10 App mode.
Versiones 22 y posteriores
Widget Android This type of variable is now available in Android Widget mode.
Android This type of variable is now available for the Android applications.
Nueva funcionalidad versión 22
Widget Android This type of variable is now available in Android Widget mode.
Android This type of variable is now available for the Android applications.
Widget Android This type of variable is now available in Android Widget mode.
Android This type of variable is now available for the Android applications.
Ejemplo
// Send an email
 
// Build the message
MyMessage is Email
 
// Sender
MyMessage..Sender = sSender
 
// Recipients
sRecipient_1 is string = "aaa@gmail.com"
sRecipient_2 is string = "bbb@gmail.com"
Add(MyMessage..Recipient, sRecipient_1)
Add(MyMessage..Recipient, sRecipient_2)
 
 
// Message content
MyMessage..Subject = EDT_Subject
MyMessage..Message = RTFToText(sNote)
MyMessage..HTML = RTFToHTML(sNote)
 
// Start an SMTP session
MySession is emailSMTPSession
MySession..ServerAddress = sServer
IF EmailStartSession(MySession) = False THEN RETURN
 
// Send the message (the emailOptionEncodeHeader constant is used to
// take the accented characters into account)
EmailSendMessage(MySession, MyMessage, emailOptionEncodeHeader)
 
// Close the session
EmailCloseSession(MySession)
Observaciones

Properties specific to the description of Email variables

The following properties can be used to handle an Email variable:
NameType usedEffect
ReturnReceiptBooleanOutbound, 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 return receipt.
This property is set to False by default.
WINDEVWEBDEV - Código Servidor This property is not supported by Outlook in Windows.
SenderAddressCharacter stringAddress of sender.
Note: If the address contains special characters or accented characters, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
WINDEVWEBDEV - Código Servidor In Outlook, this variable is ignored. The name of account for the current session is used to fill this variable.
WINDEVWEBDEV - Código Servidor In Lotus, the Lotus login is used if the sender is not specified.
AttachArray of emailAttachContains the description of attached files.
The number of attached files is unlimited.
See emailAttach for more details.
Note: If the attachment is filled manually, don't forget to specify ..Name otherwise the image will not be transmitted in the email. Example:
oEmail..Attach[1]..Content = fLoadBuffer(fDataDir() +
 ["\"] + "Email\" + sCompanyLogo)
oEmail..Attach[1]..ContentType = "image/gif"
oEmail..Attach[1]..Name = "logo.gif"
CategoryCharacter stringList of keywords associated with the email. The keywords are separated by semicolons.
Note: If one of the keywords contains special characters or accented characters, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
CcArray of character stringsContains 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.
BccArray of character stringsContains 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.
Versiones 16 y posteriores
Certificate
Nueva funcionalidad versión 16
Certificate
Certificate
CertificateCertificate used to sign the email (header, content and attachments) before sending it.
Versiones 16 y posteriores
LinuxUniversal Windows 10 AppAndroidWidget Android iPhone/iPad This property is not available.
Nueva funcionalidad versión 16
LinuxUniversal Windows 10 AppAndroidWidget Android iPhone/iPad This property is not available.
LinuxUniversal Windows 10 AppAndroidWidget Android iPhone/iPad This property is not available.
SensitivityInteger constantType 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.
DispositionNotificationBooleanOutbound, 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 return receipt.
This property is set to False by default.
WINDEVWEBDEV - Código Servidor This property is not supported in Lotus Notes.
This property is supported by Outlook in Windows and by Outlook in Pocket.
ReceiveDateCharacter string or DateTime variableDate when the message was received.
RecipientArray of character stringsContains 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.
OutBooleanSpecifies whether a message was read on the server:
  • False if the message was read.
  • True if the message was not read.
Versiones 19 y posteriores
Header
Nueva funcionalidad versión 19
Header
Header
Array of emailHeaderHeaders of email.
SenderCharacter stringAddress to which the answer to the message will be sent (up to 127 characters).
Note: If the sender contains special characters or accented characters, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
WINDEVWEBDEV - Código Servidor In Outlook, this variable is ignored. The name of account for the current session is used to fill this variable.
WINDEVWEBDEV - Código Servidor In Lotus, the Lotus login is used if the sender is not specified.
HTMLCharacter stringMessage with HTML formatting. Limited to 4 GB.
This property is supported in POP3/SMTP only.
IDCharacter stringUnique email identifier. This identifier remains constant for the entire email lifetime. This identifier is initialized when sending the email (EmailSendMessage).
Note: If the identifier contains special characters or accented characters, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
WINDEVWEBDEV - Código Servidor This property is supported by the Outlook messaging and by the Lotus Notes messaging only.
MessageCharacter stringText of message (with simple text formatting). Limited to 2 GB (64 KB for Lotus Notes).
Note: If the message contains special characters or accented characters, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
MessageIDCharacter stringUnique 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
WINDEVWEBDEV - Código Servidor This property is not supported in Lotus Notes.
WINDEVWEBDEV - Código Servidor This property is not supported by Outlook in Windows.
PriorityInteger constantType 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.
ReferenceCharacter stringUnique identifier of one or more reference emails linked to the current conversation.
WINDEVWEBDEV - Código Servidor This property is not supported in Lotus Notes.
WINDEVWEBDEV - Código Servidor This property is not supported by Outlook in Windows.
Versiones 16 y posteriores
Signature
Nueva funcionalidad versión 16
Signature
Signature
Integer constantStatus 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 available in read-only.
Versiones 16 y posteriores
LinuxUniversal Windows 10 AppAndroidWidget Android iPhone/iPad This property is not available.
Nueva funcionalidad versión 16
LinuxUniversal Windows 10 AppAndroidWidget Android iPhone/iPad This property is not available.
LinuxUniversal Windows 10 AppAndroidWidget Android iPhone/iPad This property is not available.
SourceCharacter stringContains the source of incoming message (subject, sender, recipient, content, ...).
SubjectCharacter stringMessage subject.
Note: If the subject contains special characters or accented characters, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
PlainTextCharacter stringPlain text of message. This variable is available for the incoming emails only.

Notes:
  • These properties can be used via one of the following syntaxes:
    • <Variable Name>..<Property Name>
    • <Variable Name>.<Property Name>
  • Versiones 17 y posteriores
    You have the ability to use non-Latins characters in the following properties: ..Subject, ..Message, ..Category, ..SenderAddress, ..Sender, ..ID. In this case, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
    Nueva funcionalidad versión 17
    You have the ability to use non-Latins characters in the following properties: ..Subject, ..Message, ..Category, ..SenderAddress, ..Sender, ..ID. In this case, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.
    You have the ability to use non-Latins characters in the following properties: ..Subject, ..Message, ..Category, ..SenderAddress, ..Sender, ..ID. In this case, use the emailOptionEncodeHeader constant when the message is sent by EmailSendMessage.

Functions

The following functions can be used to handle an Email variable:
Versiones 12 y posteriores
EmailBuildSource
Nueva funcionalidad versión 12
EmailBuildSource
EmailBuildSource
Genera el código fuente del correo electrónico saliente de los Variable que se encuentran actualmente en la estructura de correo electrónico o en un Correo electrónico Variable ].
Versiones 15 y posteriores
EmailChangeStatus
Nueva funcionalidad versión 15
EmailChangeStatus
EmailChangeStatus
Cambia el estado de una Email en un servidor de mensajería.
Versiones 17 y posteriores
EmailCopy
Nueva funcionalidad versión 17
EmailCopy
EmailCopy
Copia una Email encontrada en un directorio a otro directorio de un servidor IMAP.
Versiones 09 y posteriores
EmailDeleteMessage
Nueva funcionalidad versión 09
EmailDeleteMessage
EmailDeleteMessage
Le permite borrar la actual Email a través de un protocolo específico:
  • Protocolo POP3: el Email se borra del servidor de Email.
  • protocolo IMAP: el Email está marcado como "borrado/borrado".
Versiones 20 y posteriores
EmailGetIndicator
Nueva funcionalidad versión 20
EmailGetIndicator
EmailGetIndicator
Recupera los indicadores definidos en una sesión de Email de IMAP.
Versiones 10 y posteriores
EmailImportHTML
Nueva funcionalidad versión 10
EmailImportHTML
EmailImportHTML
Importa, en la estructura del correo electrónico o en un correo Variable, el contenido de un archivo HTML para enviarlo por Email.
Versiones 12 y posteriores
EmailImportSource
Nueva funcionalidad versión 12
EmailImportSource
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.
Versiones 15 y posteriores
EmailLoadAttachment
Nueva funcionalidad versión 15
EmailLoadAttachment
EmailLoadAttachment
Añade un archivo adjunto a una Email.
Versiones 09 y posteriores
EmailReadFirst
Nueva funcionalidad versión 09
EmailReadFirst
EmailReadFirst
Lee el primer Email entrante según el protocolo utilizado (POP3 o IMAP, MS Exchange, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReadFirstHeader
Nueva funcionalidad versión 09
EmailReadFirstHeader
EmailReadFirstHeader
Lee la cabecera del primer Email entrante según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReadLast
Nueva funcionalidad versión 09
EmailReadLast
EmailReadLast
Lee el último Email entrante según el protocolo utilizado (POP3 o IMAP, MS Exchange, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReadLastHeader
Nueva funcionalidad versión 09
EmailReadLastHeader
EmailReadLastHeader
Lee la cabecera del último Email entrante según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReadMessage
Nueva funcionalidad versión 09
EmailReadMessage
EmailReadMessage
Lee un mensaje entrante de acuerdo con el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReadMessage Header
Nueva funcionalidad versión 09
EmailReadMessage Header
EmailReadMessage Header
Lee la cabecera de un Email entrante según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReadNext
Nueva funcionalidad versión 09
EmailReadNext
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).
Versiones 09 y posteriores
EmailReadNextHeader
Nueva funcionalidad versión 09
EmailReadNextHeader
EmailReadNextHeader
Lee la cabecera del Email encontrado después del Email actual según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReadPrevious
Nueva funcionalidad versión 09
EmailReadPrevious
EmailReadPrevious
Lee el correo electrónico encontrado antes del correo electrónico actual de acuerdo con el protocolo utilizado (POP3 o IMAP, MS Exchange, Lotus Notes u Outlook)..
Versiones 09 y posteriores
EmailReadPreviousHeader
Nueva funcionalidad versión 09
EmailReadPreviousHeader
EmailReadPreviousHeader
Lee la cabecera del Email encontrado antes del Email actual según el protocolo utilizado (POP3 o IMAP, Lotus Notes o Outlook).
Versiones 09 y posteriores
EmailReset
Nueva funcionalidad versión 09
EmailReset
EmailReset
Reinicializa todos los Variable s de la estructura del correo electrónico o todos los Variable s de un Variable.
Versiones 11 y posteriores
EmailSeekFirst
Nueva funcionalidad versión 11
EmailSeekFirst
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, ....).
Versiones 11 y posteriores
EmailSeekFirstNotes
Nueva funcionalidad versión 11
EmailSeekFirstNotes
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.
Versiones 09 y posteriores
EmailSendMessage
Nueva funcionalidad versión 09
EmailSendMessage
EmailSendMessage
Envía un Email utilizando un protocolo determinado (SMTP, MS Exchange, Lotus Notes, Outlook).
AndroidWidget Android

Limits

This type of variable is available for the devices equipped with ARM processors. A fatal error occurs if this type of variable is used with devices not equipped with ARM processors (x86, mips, ...). This type of variable is available for the devices equipped with ARM processors or using an ARM emulation. Otherwise (and on the Samsung Galaxy Tab 3 tablet), a fatal error will occur.
Versión mínima requerida
  • Versión 15
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario