PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE

Este contenido proviene de una traducción automática.. Haga clic aquí para ver la versión original en inglés.
  • Presentación
  • Las diferentes variables de la estructura del correo electrónico
  • Acuse de recibo
  • Variables de la estructura del correo electrónico que pertenecen a la cabecera del correo electrónico
  • ¿Qué funciones utilizan la estructura del correo electrónico?
  • Los valores de la variable Email.Error
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 AppWindows Mobile
Otros
Procedimientos almacenados
Presentación
La estructura de correo electrónico es una estructura preestablecida de WLanguage (no se requiere declaración). Esta estructura está acostumbrada:
  • crear un correo electrónico,
  • recuperar el contenido de los correos electrónicos.
Para restablecer todas las variables de la estructura del correo electrónico a cero, utilice EmailReset.
Versiones 15 y posteriores
La estructura del correo electrónico propone un método simple para manejar un correo electrónico. También tiene la posibilidad de utilizar los tipos avanzados para manejar los correos electrónicos:
Estos tipos avanzados se lo permiten:
Nueva funcionalidad versión 15
La estructura del correo electrónico propone un método simple para manejar un correo electrónico. También tiene la posibilidad de utilizar los tipos avanzados para manejar los correos electrónicos:
Estos tipos avanzados se lo permiten:
La estructura del correo electrónico propone un método simple para manejar un correo electrónico. También tiene la posibilidad de utilizar los tipos avanzados para manejar los correos electrónicos:
Estos tipos avanzados se lo permiten:
WINDEV Mobile Observación: La estructura del correo electrónico es utilizada por EmailRunApp/EmailOpenMail para inicializar:
  • Versiones 16 y posteriores
    AndroidWidget Android la aplicación nativa para enviar correos electrónicos que se encuentran en el dispositivo Android.
    Nueva funcionalidad versión 16
    AndroidWidget Android la aplicación nativa para enviar correos electrónicos que se encuentran en el dispositivo Android.
    AndroidWidget Android la aplicación nativa para enviar correos electrónicos que se encuentran en el dispositivo Android.
  • Versiones 17 y posteriores
    iPhone/iPad la aplicación nativa para enviar correos electrónicos que se encuentran en el iPhone o iPad.
    Nueva funcionalidad versión 17
    iPhone/iPad la aplicación nativa para enviar correos electrónicos que se encuentran en el iPhone o iPad.
    iPhone/iPad la aplicación nativa para enviar correos electrónicos que se encuentran en el iPhone o iPad.
  • Versiones 21 y posteriores
    Universal Windows 10 App la aplicación nativa para el envío de correos electrónicos que se encuentra en el móvil en modo Universal Windows 10 App.
    Nueva funcionalidad versión 21
    Universal Windows 10 App la aplicación nativa para el envío de correos electrónicos que se encuentra en el móvil en modo Universal Windows 10 App.
    Universal Windows 10 App la aplicación nativa para el envío de correos electrónicos que se encuentra en el móvil en modo Universal Windows 10 App.
Versiones 21 y posteriores
Universal Windows 10 App La estructura del correo electrónico está ahora disponible en el modo Universal Windows 10 App.
Nueva funcionalidad versión 21
Universal Windows 10 App La estructura del correo electrónico está ahora disponible en el modo Universal Windows 10 App.
Universal Windows 10 App La estructura del correo electrónico está ahora disponible en el modo Universal Windows 10 App.
Las diferentes variables de la estructura del correo electrónico
La estructura contiene los siguientes miembros:
Observación: Los límites especificados en esta tabla sólo se aplican al cliente de MS Exchange. Cuando se utiliza el protocolo POP3/SMTP, los límites son los que da el servidor.
Email.ReturnReceiptBooleano (False predeterminado).

En modo saliente, solicita un acuse de recibo de entrega al destinatario. El destinatario no tiene que enviar necesariamente un acuse de recibo de entrega.

En modo de entrada, se utiliza para averiguar si el remitente ha solicitado un acuse de recibo de entrega.
Si se solicita un recibo de lectura, tiene prioridad sobre el acuse de recibo.
Este miembro es compatible con Outlook on Pocket (y no con Outlook on Windows).
AndroidWidget Android iPhone/iPad No disponible.
Email.SenderAddressCadena de caracteres que contiene la dirección del remitente.

En Outlook, esta variable es ignorada. El nombre de la cuenta para la sesión actual se utiliza para rellenar esta variable.

En LotusSi no se especifica el remitente, se utiliza el inicio de sesión de Lotus.
Observación: Si la dirección contiene caracteres especiales o acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
AndroidWidget Android iPhone/iPad No disponible.
Email.AttachArray de cadenas que contienen el nombre de los archivos adjuntos.
El número de archivos adjuntos es ilimitado.
Para obtener más información, consulte
Email.KeywordsCadena de caracteres que contiene una lista de palabras clave asociadas con el correo electrónico. Las palabras clave están separadas por punto y coma.
Observación: Si una palabra clave contiene caracteres especiales o acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
AndroidWidget Android iPhone/iPad No disponible.
Email.CcArray de las cadenas que contienen las direcciones de los destinatarios copiados por copiar: su nombre no se muestra en el correo electrónico recibido por los destinatarios oficiales (variable Email.Recipient).
Las direcciones están limitadas a 127 caracteres.
El número de beneficiarios no oficiales se limita a 200. Este límite puede ser excedido en el modo SMTP. Sin embargo, algunos servidores no soportan los correos electrónicos con un número importante de destinatarios.
Email.BccArray de cadenas que contienen las direcciones de los destinatarios no oficiales de non-official recipients: su nombre no se muestra en el correo electrónico recibido por los destinatarios oficiales (variable Email.Recipient).
Las direcciones están limitadas a 127 caracteres.
El número de beneficiarios no oficiales se limita a 200. Este límite puede ser excedido en el modo SMTP. Sin embargo, algunos servidores no soportan los correos electrónicos con un número importante de destinatarios.
Versiones 16 y posteriores
Email.Certificate
Nueva funcionalidad versión 16
Email.Certificate
Email.Certificate
Certificado variable que contiene el certificado que se utilizará para firmar el correo electrónico antes de enviarlo.
LinuxAndroidWidget Android iPhone/iPadUniversal Windows 10 AppWindows Mobile No disponible.
Email.SensitivityConstante entera que contiene el tipo de confidencialidad del correo electrónico. Los valores posibles son los siguientes:
  • emailEmpresaConfidencial: Utilizado para los correos electrónicos internos, por ejemplo.
  • emailNoSensitivity (Valor predeterminado): Sin confidencialidad.
  • emailPersonal: Utilizado para los correos electrónicos personales, por ejemplo.
  • emailPrivado: Usado para los correos electrónicos privados, por ejemplo.
Este miembro no es compatible con Lotus Notes.
AndroidWidget Android iPhone/iPad No disponible.
Email.DispositionNotificationBooleano (False predeterminado)

Salientepara solicitar una confirmación de que el destinatario ha leído el mensaje de correo electrónico.. El destinatario no tiene que enviar necesariamente un recibo de lectura.

Recepciónpara averiguar si el remitente ha solicitado un recibo de lectura..
Si se solicita un recibo de lectura, tiene prioridad sobre el acuse de recibo..

Este miembro no es compatible con Lotus Notes.
Este miembro es compatible con Outlook para Windows y Outlook on Pocket.
AndroidWidget Android iPhone/iPad No disponible.
Email.ReceiveDateFecha de recepción del mensaje (128 caracteres).
Si la sesión de correo electrónico fue iniciada por:
  • EmailStartSession: el formato de la fecha depende del idioma utilizado por Windows en el ordenador actual.
  • EmailStartOutlookSession: el formato de la fecha es el siguiente: YYYYYMMDDDHHSSCCmmm. La hora está en formato UTC.
AndroidWidget Android iPhone/iPad No disponible.
Email.RecipientArray de strings de caracteres que contienen las direcciones de los destinatarios principales de main. Se ignoran los destinatarios copiados y los destinatarios copiados a ciegas.. El número de beneficiarios está limitado a 20. Este límite puede ser excedido en el modo SMTP. Sin embargo, algunos servidores no soportan los correos electrónicos con un número importante de destinatarios.
Email.OutBooleano que indica si se ha leído un mensaje. Email.Out devuelve False si se leyó un mensaje y True si no se leyó ningún mensaje.
AndroidWidget Android iPhone/iPad No disponible.
Email.ErrorCadena de caracteres que contiene el mensaje de error.
AndroidWidget Android iPhone/iPad No disponible.
Email.SenderCadena de caracteres que contiene la dirección a la que debe enviarse la respuesta al mensaje (hasta 127 caracteres)..
En Lotus, el inicio de sesión de Lotus se utiliza si no se especifica el remitente.
Observación: Si el remitente contiene caracteres especiales o acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
AndroidWidget Android iPhone/iPad No disponible.
Email.HTMLCadena de caracteres que contiene el mensaje con formato HTML. Limitado a 4 GB.
Este miembro sólo es compatible con POP3/SMTP.
AndroidWidget Android iPhone/iPad No disponible.
Email.IDIdentificador único de correo electrónico (cadena de caracteres). Este identificador permanece constante durante toda la vida útil del correo electrónico.. Este identificador se inicializa al enviar el correo electrónico (EmailSendMessage).
Observación: Si el identificador contiene caracteres especiales o acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
Sólo software de mensajería de Outlook y Lotus Notes
AndroidWidget Android iPhone/iPadUniversal Windows 10 App No disponible.
Email.AttachIdentifierArray de strings de caracteres que contienen los identificadores de los anexos incluidos en un mensaje HTML.
Esta variable se rellena al recibir un correo electrónico.
AndroidWidget Android iPhone/iPad No disponible.
Identificador de correo electrónicoIdentificador de correo electrónico (sólo en modo asíncrono)
Solo WEBDEV
AndroidWidget Android iPhone/iPadUniversal Windows 10 App No disponible.
Email.MessageCadena de caracteres que contiene el texto del mensaje (con formato de texto simple). Limitado a 2 GB (64 KB para Lotus Notes).
Observación: Si el mensaje contiene caracteres especiales o acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
Email.MessageIDIdentificador único de correo electrónico (cadena de caracteres). Este identificador permanece constante durante toda la vida útil del correo electrónico.. Este identificador se utiliza para seguir una conversación.

Al enviar un correo electrónicoesta variable especifica el identificador de correo electrónico. Si esta variable corresponde a una cadena vacía, el identificador será dado por el servidor. La aplicación que genera el identificador debe gestionar la unicidad de este identificador..
Esta variable se tiene en cuenta sólo si se utiliza la constante EmailOptionMessageID en EmailSendMessage.

Al recibir un correo electrónicoesta variable especifica el identificador de correo electrónico.
Este identificador debe tener el siguiente formato: <Identifier@domain>.. Por ejemplo: 1@192.168.2.210
Este miembro no es compatible con Lotus Notes.
Este miembro es compatible con Outlook on Pocket (y no con Outlook on Windows).
AndroidWidget Android iPhone/iPad No disponible.
Email.NbAttachEntero que indica el número de archivos adjuntos al mensaje. El número de archivos adjuntos es ilimitado.
Versiones 17 y posteriores
iPhone/iPad No disponible.
Nueva funcionalidad versión 17
iPhone/iPad No disponible.
iPhone/iPad No disponible.
Email.NbCcEntero correspondiente al número de destinatarios copiados (limitado a 200).
Este límite puede ser excedido en el modo SMTP. Sin embargo, algunos servidores no soportan los correos electrónicos con un número importante de destinatarios.
Email.NbBccNúmero entero correspondiente al número de beneficiarios no oficiales (limitado a 200).
Este límite puede ser excedido en el modo SMTP. Sin embargo, algunos servidores no soportan los correos electrónicos con un número importante de destinatarios.
Email.NbRecipienteEntero que contiene el número de destinatarios del mensaje. El número de beneficiarios está limitado a 20.
Este límite puede ser excedido en el modo SMTP. Sin embargo, algunos servidores no soportan los correos electrónicos con un número importante de destinatarios.
Email.PriorityConstante entera que contiene el tipo de prioridad para el correo electrónico. Los valores posibles son los siguientes:
  • emailBajoPrioridad: usado para los emails que no son urgentes.
  • emailAlta Prioridad: usado para los correos electrónicos urgentes.
  • emailNormalPriority (Valor predeterminado): usado para los correos electrónicos no urgentes.
Atención: Este miembro sólo es compatible con POP3/SMTP.
AndroidWidget Android iPhone/iPad No disponible.
Email.ReferenceCadena de caracteres. Identificador único de uno o más correos electrónicos de referencia relacionado a la conversación actual.
Este miembro no es compatible con Lotus Notes.
Este miembro es compatible con Outlook on Pocket (y no con Outlook on Windows).
AndroidWidget Android iPhone/iPad No disponible.
Versiones 16 y posteriores
Email.Signature
Nueva funcionalidad versión 16
Email.Signature
Email.Signature
Constante entera correspondiente al estado de la firma de correo electrónico:
  • certificadoVencido: Firma válida pero certificado caducado.
  • certificateInvalid: Firma o certificado no válido.
  • certificateUntrusted: Firma válida pero raíz de certificado no fiable.
  • certificadoOK: Firma y certificado de confianza.
LinuxAndroidWidget Android iPhone/iPadUniversal Windows 10 AppWindows Mobile No disponible.
Email.SourceCadena de caracteres que contiene la fuente del mensaje entrante (asunto, remitente, destino, contenido, ....).
Este miembro es compatible con Outlook on Pocket (y no con Outlook on Windows).
iPhone/iPadJava No disponible.
Email.SubjectCadena de caracteres que contiene el asunto del mensaje.
Observación: Si el asunto contiene caracteres especiales o acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
Email.PlainTextCadena de caracteres que contiene el texto sin formato del mensaje. Esta variable sólo está disponible para los correos electrónicos entrantes.
AndroidWidget Android iPhone/iPad No disponible.

Gestión avanzada de correos electrónicos (Sólo en modo SMTP): Para realizar una descripción avanzada de los correos electrónicos, tiene la posibilidad de acceder a los controles MIME Content-Type y Content-Description para cada archivo adjunto suministrado con el correo electrónico.
Las variables correspondientes son las siguientes:
Email.AttachContentTypeSólo en modo SMTP

Array de las cadenas correspondientes al contenido de MIME Control de tipo Contenido de cada archivo adjunto. El número de archivos adjuntos es ilimitado.
Descripción del contenido de los archivos adjuntos por correo electrónicoSólo en modo SMTP

Array de cadenas que corresponde al contenido del control MIME Content-description de cada archivo adjunto. El número de archivos adjuntos es ilimitado.

Estas variables son accesibles en modo de sólo lectura cuando se recibe un correo electrónico y en modo de lectura/escritura cuando se envía un correo electrónico.
Observaciones:
  • Si Email.Message y Email.HTML están vacíos y si el correo electrónico tiene un solo archivo adjunto, los controles MIME content-Type y Content-description se corresponderán con las características del archivo adjunto.
Versiones 17 y posteriores
  • Usted tiene la habilidad de usar caracteres no latinos en las siguientes variables:
    • Asunto del correo electrónico
    • Mensaje de correo electrónico
    • Palabras clave de Email
    • Dirección de correo electrónico del remitente
    • Email.Sender
    • ID de correo electrónico
    En este caso, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
Nueva funcionalidad versión 17
  • Usted tiene la habilidad de usar caracteres no latinos en las siguientes variables:
    • Asunto del correo electrónico
    • Mensaje de correo electrónico
    • Palabras clave de Email
    • Dirección de correo electrónico del remitente
    • Email.Sender
    • ID de correo electrónico
    En este caso, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.
  • Usted tiene la habilidad de usar caracteres no latinos en las siguientes variables:
    • Asunto del correo electrónico
    • Mensaje de correo electrónico
    • Palabras clave de Email
    • Dirección de correo electrónico del remitente
    • Email.Sender
    • ID de correo electrónico
    En este caso, utilice la constante emailOptionEncodeHeader cuando el mensaje sea enviado por EmailSendMessage.

Acuse de recibo

Se pueden utilizar dos variables para gestionar un acuse de recibo: Email.DispositionNotification y Email.ReturnReceipt.
Algunos programas de mensajería solo reconocen Email.DispositionNotification, y otros reconocen ambas variables y realizan operaciones específicas según la variable utilizada.
Email.DispositionNotification es la variable más reconocida, mientras que Email.ReturnReceipt cada vez es menos reconocida.
Para mantener la compatibilidad con el software de mensajería que utiliza la segunda variable, se mantienen y diferencian las 2 variables. Le recomendamos utilizar las dos variables (la variable principal es Email.DispositionNotification).

Variables de la estructura del correo electrónico que pertenecen a la cabecera del correo electrónico

Al leer el encabezado del correo electrónico, la estructura del correo electrónico se actualiza automáticamente de acuerdo con el contenido del encabezado del mensaje..
Las siguientes variables están vacías:
  • Mensaje de correo electrónico
  • Email.Attach
  • Email.NbAttach
  • Correo electrónico.HTML
  • Correo electrónico: PlainText
Estas variables requieren una lectura completa del mensaje (EmailReadMessage). Las variables Email.Bcc y Email.NbBcc sólo se pueden utilizar para enviar correos electrónicos.
¿Qué funciones utilizan la estructura del correo electrónico?
Las siguientes funciones utilizan la estructura del correo electrónico:
Nombre de la funciónVariables utilizadas
EmailSendAl enviar el correo electrónico, sólo se tienen en cuenta las variables de la estructura de correo electrónico requeridas por el protocolo SMTP.. Las otras variables son ignoradas.
Variables utilizadas:
Email.CC, Email.Recipient, Email.Sender, Email.NbCc, Email.NbRecipient.
EmailSendMessageVariables utilizadas en modo escritura para crear el correo electrónico:
Email.Attach, Email.Message, Email.Recipient, Email.NbAttach, Email.NbRecipient y Email.Subject
EmailReadFirstVariables utilizadas en el modo de sólo lectura:
Email.SenderAddress, Email.Attach, Email.ReceiveDate, Email.Out, Email.Message, Email.NbAttach y Email.Subject
EmailReadNextVariables utilizadas en modo escritura:
Email.SenderAddress, Email.Attach, Email.ReceiveDate, Email.Out, Email.Message, Email.NbAttach y Email.Subject
EmailUpdateError de correo electrónico
EmailStartSessionError de correo electrónico
EmailDeleteMessageCorreo electrónico
Los valores de la variable Email.Error
Después de cada función, la variable Email.Error contiene el error reporte de la función:
ValorSignificado
0Ningún error
1Cancelación solicitada por el usuario
2Error desconocido
3No se puede establecer la conexión
4Disco lleno
5No hay memoria disponible
6Acceso denegado
8Demasiadas sesiones abiertas
9Demasiados archivos adjuntos (hasta 10 archivos)
10Demasiados destinatarios (hasta 20 destinatarios)
11Archivo adjunto no encontrado
12No se puede abrir el archivo adjunto
13Incapaz de escribir el archivo adjunto
14Destinatario desconocido
17Mensaje no válido
18Texto del mensaje demasiado largo
19Sesión no válida
21Dirección del destinatario ambigua
23Error de red
Versión mínima requerida
  • Versión 11
Esta página también está disponible para…
Comentarios
Email.Recipient: UNICODE vs ANSI
Email.Recipient, as well as other recipient arrays, are UNICODE and not ANSI arrays.
So, assuming to have a local parameter arrListaDestinatari of strings, the following instructions will go into error:

1:
Email.Recipient = arrListaDestinatari

2:
FOR EACH sDestinatario OF arrListaDestinatari
   ArryAdd (Email.Recipient, sDestinatario)
END

Only these instructions will be fine:

i is int
FOR EACH sDestinatario OF arrListaDestinatari
   i ++
   Email.Recipient [i] = sDestinatario
END
Email.NbRecipient = i

In the end it is better to define a local variable:

MiaEmail is Email
MiaEmail.Recipient = arrListaDestinatari
Mister PAOLO
18 06 2018