Clase Transporter

Descripción

.acceptUnsecureConnection

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.acceptUnsecureConnection : Boolean

Descripción

La propiedad .acceptUnsecureConnection contiene True si se autoriza a 4D establecer una conexión no cifrada cuando la conexión cifrada no es posible.

Contiene False si no se permiten las conexiones no cifradas, en cuyo caso se devuelve un error cuando no es posible la conexión cifrada.

Los puertos seguros disponibles son:

• SMTP

  • 465: SMTPS
  • 587 o 25: SMTP con actualización STARTTLS si lo soporta el servidor.

• IMAP

  • 143: Puerto IMAP no encriptado
  • 993: IMAP con actualización STARTTLS si lo soporta el servidor

• POP3

  • 110: Puerto POP3 no encriptado
  • 995: POP3 con actualización STARTTLS si lo soporta el servidor.

---

.authenticationMode

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.authenticationMode : Text

Descripción

La propiedad .authenticationMode contiene el modo de autenticación utilizado para abrir la sesión en el servidor de correo.

Por defecto, se utiliza el modo más seguro soportado por el servidor.

Los valores posibles son:

Valor	Constantes	Comentario
CRAM-MD5	IMAP authentication CRAM MD5	Autenticación utilizando el protocolo CRAM-MD5
LOGIN	IMAP authentication login	Autenticación utilizando el protocolo LOGIN
OAUTH2	IMAP authentication OAUTH2	Autenticación utilizando el protocolo OAuth2
PLAIN	IMAP authentication plain	Autenticación utilizando el protocolo PLAIN

---

.authenticationMode

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.authenticationMode : Text

Descripción

La propiedad .authenticationMode contiene el modo de autenticación utilizado para abrir la sesión en el servidor de correo.

Por defecto, se utiliza el modo más seguro soportado por el servidor.

Los valores posibles son:

Valor	Constantes	Comentario
APOP	POP3 authentication APOP	Authentication using APOP protocol (POP3 only)
CRAM-MD5	POP3 authentication CRAM MD5	Autenticación utilizando el protocolo CRAM-MD5
LOGIN	POP3 authentication login	Autenticación utilizando el protocolo LOGIN
OAUTH2	POP3 authentication OAUTH2	Autenticación utilizando el protocolo OAuth2
PLAIN	POP3 authentication plain	Autenticación utilizando el protocolo PLAIN

---

.authenticationMode

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.authenticationMode : Text

Descripción

La propiedad .authenticationMode contiene el modo de autenticación utilizado para abrir la sesión en el servidor de correo.

Por defecto, se utiliza el modo más seguro soportado por el servidor.

Los valores posibles son:

Valor	Constantes	Comentario
CRAM-MD5	SMTP authentication CRAM MD5	Autenticación utilizando el protocolo CRAM-MD5
LOGIN	SMTP authentication login	Autenticación utilizando el protocolo LOGIN
OAUTH2	SMTP authentication OAUTH2	Autenticación utilizando el protocolo OAuth2
PLAIN	SMTP authentication plain	Autenticación utilizando el protocolo PLAIN

---

.bodyCharset

Historia

Lanzamiento	Modificaciones
18	Soporte de UTF8 base64
17 R5	Añadidos

.bodyCharset : Text

Descripción

La propiedad .bodyCharset contiene el conjunto de caracteres y la codificación utilizados para la parte del cuerpo del correo electrónico.

Valores posibles:

Constante	Valor	Comentario
mail mode ISO2022JP	US-ASCII_ISO-2022-JP_UTF8_QP	headerCharset: US-ASCII si es posible, Japanese (ISO-2022-JP) &Quoted-printable si es posible, de lo contrario UTF-8 & Quoted-printable bodyCharset: US-ASCII si es posible, Japanese (ISO-2022-JP) & 7-bit si es posible, de lo contrario 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 si es posible, en caso contrario UTF-8 & Quoted-printable (valor por defecto)
mail mode UTF8 in base64	US-ASCII_UTF8_B64	headerCharset & bodyCharset: US-ASCII si es posible, de lo contrario UTF-8 & base64

---

.connectionTimeOut

Historia

Lanzamiento	Modificaciones
17 R5	Añadidos

.connectionTimeOut : Integer

Descripción

La propiedad .connectionTimeOut contiene el tiempo máximo de espera (en segundos) permitido para establecer una conexión con el servidor. Por defecto, si la propiedad no se ha definido en el objeto servidor (utilizado para crear el objeto transportador con SMTP New transporter, POP3 New transporter, o IMAP New transporter), el valor es 30.

---

.headerCharset

Historia

Lanzamiento	Modificaciones
17 R5	Añadidos

.headerCharset : Text

Descripción

La propiedad .headerCharset contiene el conjunto de caracteres y la codificación utilizados para el encabezado del correo electrónico. El encabezado incluye las siguientes partes del correo electrónico:

• asunto,
• attachment filename(s),
• email name.

Valores posibles:

Constante	Valor	Comentario
mail mode ISO2022JP	US-ASCII_ISO-2022-JP_UTF8_QP	headerCharset: US-ASCII si es posible, Japanese (ISO-2022-JP) &Quoted-printable si es posible, de lo contrario UTF-8 & Quoted-printable bodyCharset: US-ASCII si es posible, Japanese (ISO-2022-JP) & 7-bit si es posible, de lo contrario 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 si es posible, en caso contrario UTF-8 & Quoted-printable (valor por defecto)
mail mode UTF8 in base64	US-ASCII_UTF8_B64	headerCharset & bodyCharset: US-ASCII si es posible, de lo contrario UTF-8 & base64

---

.host

Historia

Lanzamiento	Modificaciones
17 R5	Añadidos

.host : Text

Descripción

La propiedad .host contiene el nombre o la dirección IP del servidor local. Se utiliza para las transacciones de correo (SMTP, POP3, IMAP).

---

.logFile

Historia

Lanzamiento	Modificaciones
17 R5	Añadidos

.logFile : Text

Descripción

La propiedad .logFile contiene la ruta del archivo de registro extendido definido (si existe) para la conexión de correo. Puede ser relativo (a la carpeta actual Logs) o absoluto.

A diferencia de los archivos log habituales (activados mediante el comando SET DATABASE PARAMETER), los archivos log extendidos almacenan el contenido MIME de todos los correos enviados y no tienen límite de tamaño. Para más información sobre los archivos de registro extendidos, consulte:

• SMTP connections - 4DSMTPLog.txt
• POP3 connections - 4DPOP3Log.txt
• IMAP connections - 4DIMAPLog.txt

---

.port

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.port : Integer

Descripción

La propiedad .port contiene el número de puerto utilizado para las transacciones de correo. Por defecto, si la propiedad port no se ha definido en el objeto server (utilizado para crear el objeto transportador con SMTP New transporter, POP3 New transporter, IMAP New transporter), el puerto utilizado es:

• SMTP - 587
• POP3 - 995
• IMAP - 993

---

.sendTimeOut

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.sendTimeOut : Integer

Descripción

La propiedad .sendTimeOut contiene el tiempo máximo de espera (en segundos) de una llamada a .send( ) antes de que se produzca un timeout. Por defecto, si no se ha definido la propiedad .sendTimeOut en el objeto server, se utiliza el valor 100.

---

.user

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.user : Text

Descripción

La propiedad .user contiene el nombre de usuario utilizado para la autenticación en el servidor de correo.

---

.checkConnection()

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.checkConnection() : Object

Parámetros	Tipo		Descripción
Resultado	Object	<-	Estado de la conexión del objeto transportador

Descripción

La función .checkConnection() comprueba la conexión utilizando la información almacenada en el objeto transporter, recrea la conexión si es necesario y devuelve el estado. Esta función permite verificar que los valores proporcionados por el usuario son válidos y coherentes.

Objeto devuelto

La función envía una solicitud al servidor de correo y devuelve un objeto que describe el estado del correo. Este objeto puede contener las siguientes propiedades:

Propiedad		Tipo	Descripción
success		boolean	True si la verificación es exitosa, False en caso contrario
status		number	(sólo SMTP) Código de estado devuelto por el servidor de correo (0 en caso de un problema no relacionado con el procesamiento del correo)
statusText		text	Mensaje de estado devuelto por el servidor de correo, o último error devuelto en la pila de errores de 4D
errors		collection	Pila de errores 4D (no se devuelve si se recibe una respuesta del servidor de correo)
	[ ].errCode	number	Código de error 4D
	[ ].message	text	Descripción del error 4D
	[ ].componentSignature	text	Firma del componente interno que ha devuelto el error