AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Comunicación / Gestión de correos electrónicos
  • Presentación
  • Las diferentes variables de la estructura de Email
  • Acuse de recibo
  • Variables de la estructura de Email que pertenecen a la cabecera de Email
  • ¿Qué funciones utilizan la estructura de Email?
  • Los valores de los Email.Error Variable
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Advertencia
La estructura Email se mantiene por compatibilidad con versiones anteriores, y para ser utilizada en PHP. En la mayoría de los casos, se recomienda utilizar una Variable de tipo Email.
Presentación
La estructura de Email es una estructura preestablecida de WLanguage (no se requiere declaración). Esta estructura está acostumbrada:
  • crear un Email,
  • recuperar el contenido de los correos electrónicos.
Para poner a cero todas las variables de la estructura Email, utilice EmailReset.
La estructura de Email propone un método simple para manejar un Email. 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 Email es utilizada por EmailRunApp/EmailOpenMail para inicializar:
  • AndroidWidget Android la aplicación nativa para el envío de correos electrónicos que se encuentra en el dispositivo Android.
  • iPhone/iPadIOS Widget la aplicación nativa para enviar correos electrónicos que se encuentran en el iPhone o iPad.
  • 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.
Las diferentes variables de la estructura de Email
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 .Adjuntar IdentificadorArray de strings de caracteres que contienen los identificadores de los anexos incluidos en un mensaje HTML.
Este Variable se llena al recibir un Email.
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email .MailIdentifierIdentificador Email (sólo en modo asíncrono)
Solo WEBDEV
Universal Windows 10 AppAndroidWidget Android iPhone/iPadIOS Widget 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.BccArray de cadenas que contienen las direcciones de los destinatarios no oficiales: su nombre no aparece en el correo electrónico recibido por los destinatarios oficiales (Email.Recipiente Variable).
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.CcArray de cadenas que contienen las direcciones de los destinatarios copiados: su nombre no aparece en el correo electrónico recibido por los destinatarios oficiales (Email.Recipiente Variable).
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.CertificateVariable Certificate que contiene el Certificate que se utilizará para firmar el Email antes de enviarlo.
Universal Windows 10 AppAndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.DispositionNotificationBooleano (False predeterminado)

Saliente , utilizado para solicitar una confirmación de que el destinatario leyó el Email. El destinatario no tiene que enviar necesariamente un recibo de lectura.

Entrante , utilizado para averiguar si el remitente solicitó una confirmación de lectura.
Si se solicita un acuse de recibo de lectura, éste tiene prioridad sobre el acuse de recibo de entrega.

Este miembro no es compatible con Lotus Notes.
Este miembro es compatible con Outlook en Windows.
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.ErrorCadena de caracteres que contiene el mensaje de error.
AndroidWidget Android iPhone/iPadIOS Widget 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/iPadIOS Widget No disponible.
Email.IDIdentificador único Email (cadena de caracteres). Este identificador permanece constante durante toda la vida de Email. Este identificador se inicializa al enviar el Email (EmailSendMessage).
Observación: Si el identificador contiene caracteres especiales o caracteres acentuados, use la constante emailOptionEncodeHeader cuando el mensaje se envía por EmailSendMessage .
Solo software de mensajería de Outlook y Lotus Notes
Universal Windows 10 AppAndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.KeywordsCadena de caracteres que contiene una lista de palabras clave associated con el Email. Las palabras clave están separadas por punto y coma.
Observación: Si una palabra clave contiene caracteres especiales o caracteres acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje se envía mediante EmailSendMessage 0045004c0054003000300030003000300030002f002300 .
AndroidWidget Android iPhone/iPadIOS Widget 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 caracteres acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje se envía mediante EmailSendMessage 0045004c0054003000300030003000300030002f002300 .
Email.MessageIDIdentificador único Email (cadena de caracteres). Este identificador permanece constante durante toda la vida de Email. Este identificador se utiliza para seguir una conversación.

Al enviar un Email , este Variable especifica el identificador Email. Si este 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 solo si se usa la constante emailOptionMessageID en EmailSendMessage 00030003000300030002f002300.

Al recibir un Email , este Variable especifica el identificador Email.
Este identificador debe tener el siguiente formato . Por ejemplo: 1@192.168.2.210
Este miembro no es compatible con Lotus Notes.
Este miembro no es compatible con Outlook en Windows.
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.NbAttachEntero que indica el número de archivos adjuntos al mensaje. El número de archivos adjuntos es ilimitado.
iPhone/iPadIOS Widget No disponible.
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.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.NbRecipientEntero 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.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/iPadIOS Widget No disponible.
Email.PlainTextCadena de caracteres que contiene el texto sin formato del mensaje. Este Variable está disponible sólo para los correos electrónicos entrantes.
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.PriorityConstante entera que contiene el tipo de prioridad para el Email. Los valores posibles son los siguientes:
  • emailLowPriority: usado para los emails que no son urgentes.
  • emailHighPriority: 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/iPadIOS Widget No disponible.
Email.ReceiveDateFecha de recepción del mensaje (128 caracteres).
Si la sesión de Email 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/iPadIOS Widget No disponible.
Email.RecipientArray de cadenas de caracteres que contienen las direcciones de los destinatarios principales. 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.ReferenceCadena de caracteres. El identificador único de uno o más correos electrónicos de reference relacionado a la conversación actual.
Este miembro no es compatible con Lotus Notes.
Este miembro no es compatible con Outlook en Windows.
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.ReturnReceiptBooleano (False predeterminado).

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

En modo entrante , determina si el remitente solicitó un recibo de entrega.
Si se solicita un acuse de recibo de lectura, éste tiene prioridad sobre el acuse de recibo de entrega.
Este miembro no es compatible con Outlook en Windows.
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.SenderCadena de caracteres que contiene el emisor Address.
En Lotus, se utiliza el nombre de usuario de Lotus si no se especifica el remitente.
Observación: Si el remitente contiene caracteres especiales o caracteres acentuados, use la constante emailOptionEncodeHeader cuando el mensaje se envía por EmailSendMessage .
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.SenderAddressCadena de caracteres que contiene la Address donde debe enviarse la respuesta al mensaje (hasta 127 caracteres). Corresponde a Responder a.


En Outlook , este Variable se ignora. El nombre de la cuenta de la sesión actual se utiliza para especificar esta Variable.

En Lotus , se utiliza el nombre de usuario de Lotus si no se especifica el remitente.
Observación: Si la dirección contiene caracteres especiales o caracteres acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje se envía mediante EmailSendMessage .
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.SensitivityConstante entera que contiene el tipo de confidencialidad para el Email. Los valores posibles son los siguientes:
  • emailCompanyConfidential: Utilizado para los correos electrónicos internos, por ejemplo.
  • emailNoSensitivity (Valor predeterminado): Sin confidencialidad.
  • emailPersonal: Utilizado para los correos electrónicos personales, por ejemplo.
  • emailPrivate: Se utiliza, por ejemplo, para los correos electrónicos de private.
Este miembro no es compatible con Lotus Notes.
AndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.SignatureConstante entera correspondiente al estado de la firma de Email:
  • certificateExpired: La firma es válida, pero ha caducado Certificate.
  • certificateInvalid: Firma inválida o Certificate.
  • certificateUntrusted: Firma válida pero raíz de Certificate no confiable.
  • certificateOk: Firma de confianza y Certificate.
Universal Windows 10 AppAndroidWidget Android iPhone/iPadIOS Widget No disponible.
Email.SourceCadena de caracteres que contiene la fuente del mensaje entrante (asunto, remitente, destino, contenido, ....).
Este miembro no es compatible con Outlook en Windows.
iPhone/iPadIOS Widget No disponible.
Email.SubjectCadena de caracteres que contiene el asunto del mensaje.
Observación: Si el asunto contiene caracteres especiales o caracteres acentuados, utilice la constante emailOptionEncodeHeader cuando el mensaje se envía mediante EmailSendMessage .

Gestión avanzada de correos electrónicos (solo modo SMTP): Para realizar un description avanzado de los Email s, tienes la posibilidad de acceder a los controles MIME Content-Type y Content-description para cada accesorio suministrado con el Email.
Las variables correspondientes son las siguientes:
Email.AttachContentTypeSólo en modo SMTP

Array de cuerdas correspondientes al contenido de MIME Content-tipo control de cada archivo adjunto. El número de archivos adjuntos es ilimitado.
Email.AttachDescripción del contenidoSó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 sólo lectura cuando se recibe un Email y en lectura/escritura cuando se envía un Email.
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 corresponderán a las características del archivo adjunto.
  • Puede utilizar caracteres no latinos en las siguientes variables:
    • Email. Asunto
    • Email. Mensaje
    • Email.keywords
    • Email.SenderAddress
    • Email.Sender
    • Email.ID
    En este caso, use la constante emailOptionEncodeHeader cuando el mensaje es 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 correo electrónico solo reconocen Email.DispositionNotification , otros reconocen ambos Variable y realizan operaciones específicas de acuerdo con el Variable utilizado.
Email.DispositionNotification es la variable más reconocida, mientras que Email.ReturnReceipt cada vez es menos reconocida.
Para seguir siendo compatible con el software de correo electrónico que utiliza el segundo Variable , los 2 Variable se mantienen y diferencian. Le recomendamos utilizar las dos variables (la variable principal es Email.DispositionNotification).

Variables de la estructura de Email que pertenecen a la cabecera de Email

Al leer el encabezamiento del Email, la estructura del Email se actualiza automáticamente según el contenido del encabezamiento del mensaje.
Las siguientes variables están vacías:
  • Email. Mensaje
  • Email.Attach
  • Email.NbAttach
  • Email.HTML
  • Email.PlainText
Estas variables requieren una lectura completa del mensaje (EmailReadMessage). Las variables Email.Bcc y Email.NbBcc sólo pueden usarse para enviar Email s.
¿Qué funciones utilizan la estructura de Email?
Las siguientes funciones utilizan la estructura de Email:
Nombre de la funciónVariables utilizadas
EmailDeleteMessageEmail.Out
EmailReadFirstVariables utilizadas en solo lectura:
Email.Dirección del remitente, Email.Adjuntar, Email.RecibirFecha, Email.Fuera, Email.Mensaje, Email.NbAdjuntar y Email.Asunto
EmailReadNextVariables utilizadas en el modo de escritura:
Email.Dirección del remitente, Email.Adjuntar, Email.RecibirFecha, Email.Fuera, Email.Mensaje, Email.NbAdjuntar y Email.Asunto
EmailSendCuando se envía el Email, sólo se tienen en cuenta las variables de la estructura Email 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 de escritura para crear el Email:
Email.Attach, Email.Message, Email.Recipient, Email.NbAttach, Email.NbRecipient y Email.Subject
EmailStartSessionEmail. Error
EmailUpdateEmail. Error
Los valores de los Email.Error Variable
Después de cada función, el Email.Error Variable 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
21La dirección del destinatario es 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

Última modificación: 24/06/2023

Señalar un error o enviar una sugerencia | Ayuda local