Clase Transporter
Descripción
.acceptUnsecureConnection
Histórico
| Lanzamiento | Modificaciones |
|---|---|
| 17 R4 | Añadidos |
.acceptUnsecureConnection: Boolean
Descripción
La propiedad .acceptUnsecureConnection contiene True si 4D está autorizado a establecer una conexión no cifrada cuando la conexión encriptada 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
Histórico
| 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
Histórico
| 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
Histórico
| 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
Histórico
| 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 |
|
| mail mode ISO88591 | ISO-8859-1 |
|
| mail mode UTF8 | US-ASCII_UTF8_QP | headerCharset & bodyCharset: US-ASCII si es posible, de lo 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
Histórico
| Lanzamiento | Modificaciones |
|---|---|
| 17 R5 | Añadidos |
.connectionTimeOut : Integer
Descripción
La propiedad .connectionTimeOut contiene el tiempo de espera máximo (en segundos) autorizado 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
Histórico
| Lanzamiento | Modificaciones |
|---|---|
| 17 R5 | Añadidos |
.headerCharset : Text
Descripción
La propriété .headerCharset contient 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 |
|
| mail mode ISO88591 | ISO-8859-1 |
|
| mail mode UTF8 | US-ASCII_UTF8_QP | headerCharset & bodyCharset: US-ASCII si es posible, de lo 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
Histórico
| 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
Histórico
| Lanzamiento | Modificaciones |
|---|---|
| 17 R5 | Añadidos |
.logFile : Text
Descripción
La propiedad .logFile contiene la ruta del archivo de historial extendido definido (si lo hay) para la conexión de correo. Puede ser relativo (a la carpeta actual Logs) o absoluto.
A diferencia de los archivos de registro clásicos (habilitados mediante el comando SET DATABASE PARAMETER), los archivos de registro extendidos almacenan el contenido MIME de todos los correos enviados y no tienen ningún límite de tamaño. Para más información sobre los archivos de registro extendidos, consulte:
- Conexiones SMTP - 4DSMTPLog.txt
- **Conexiones POP3 ** - 4DSMTPLog.txt
- Conexiones IMAP - 4DIMAPLog.txt
.port
Histórico
| 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
Histórico
| Lanzamiento | Modificaciones |
|---|---|
| 17 R4 | Añadidos |
.sendTimeOut : Integer
Descripción
La propiedad .sendTimeOut contiene el tiempo de espera máximo (en segundos) de una llamada a .send( ) antes de que se produzca un timeout. .
.user
Histórico
| Lanzamiento | Modificaciones |
|---|---|
| 17 R4 | Añadidos |
.user : Text
Descripción
La propiedad .user contiene el nombre del usuario utilizado para la autenticación en el servidor de correo.
.checkConnection()
Histórico
| 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() verifica la conexión utilizando la información almacenada en el objeto transportador, 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 |