POP3 New transporter

4D v20.6

Mail


POP3 New transporter ( server ) -> Resultado

Parámetro	Tipo	Descripción
server	Objeto	Mail server information
Resultado	Objeto	POP3 transporter object

Descripción

El comando POP3 New transporter configura una nueva conexión POP3 de acuerdo con el parámetro servidor y devuelve un nuevo objeto transportado. El objeto transportador devuelto generalmente se utilizará para recibir correos electrónicos.

En el parámetro servidor, pase un objeto que contenga las siguientes propiedades:

Propiedad

Tipo

Descripción

host

Texto

Nombre o dirección IP del servidor local que se utilizará para las transacciones POP3.

port

Número

(opcional) Puerto a utilizar para transacciones POP3. Valor predeterminado = 995

authenticationMode

Texto

Modo de autenticación utilizado para abrir la sesión en el servidor POP3 (*). Valores posibles:

Constante	Valor	Comentario
POP3 authentication APOP	APOP	Autenticación POP3 utilizando el protocolo APOP
POP3 authentication CRAM-MD5	CRAM-MD5	Autenticación POP3 utilizando el protocolo CRAM-MD5
POP3 authentication login	LOGIN	Autenticación POP3 utilizando el protocolo LOGIN
POP3 authentication OAUTH2	OAUTH2	Autenticación POP3 utilizando el protocolo OAuth 2
POP3 authentication plain	PLAIN	Autenticación POP3 utilizando el protocolo PLAIN

accessTokenOAuth2

Texto

Cadena de texto que representa las credenciales de autorización OAuth 2. Se utiliza sólo con el authenticationMode OAUTH2. Si se utiliza accessTokenOAuth2 pero se omite el authenticationMode, se utiliza el protocolo OAuth 2 (si el servidor lo permite).

Nota: un token de acceso tiene una vida limitada y normalmente caduca después de una hora. Una vez que un token de acceso expira, no es posible la reconexión automática (por ejemplo, en caso de desconexión del servidor).

user

Texto

Nombre de usuario para la autenticación en el servidor

password

Texto

Contraseña de usuario para autenticación en el servidor

acceptUnsecureConnection

Booleano

True para permitir que 4D establezca una conexión no encriptada si la conexión encriptada no es posible (**). Si es False, se devuelve un error si la conexión cifrada no es posible. Valor predeterminado=False

connectionTimeOut

Número

(opcional) Tiempo máximo de espera (en segundos) para establecer una conexión con el servidor. Valor predeterminado=30

logFile

Texto

(opcional) Ruta del archivo para el archivo de registro. Puede ser relativo (a la carpeta de registros actual) o absoluto

(*) Si authenticationMode es nulo o indefinido, se utiliza el modo de autenticación más seguro soportado por el servidor.

(**) Los puertos POP3 seguros disponibles son:

110: puerto no encriptado POP3
995: POP3 con actualización STARTTLS si es soportado por el servidor.

Objeto devuelto

El objeto transportador devuelto contiene las siguientes propiedades y métodos de solo lectura:

Propiedad	Tipo	Descripción
transporter.host	Texto	Nombre o dirección IP del servidor local utilizado para las transacciones de correo
transporter.port	Número	Puerto utilizado para transacciones de correo
transporter.connectionTimeOut	Número	Tiempo máximo de espera (en segundos) para establecer una conexión con el servidor
transporter.acceptUnsecureConnection	Booleano	True si se permite a 4D establecer una conexión no cifrada cuando no es posible la conexión cifrada, de lo contrario False
transporter.authenticationMode	Texto	Modo de autenticación realmente utilizado para abrir la sesión en el servidor de correo
transporter.user	Texto	Nombre de usuario para autenticación en el servidor
transporter.logFile	Texto	Ruta completa del archivo de historial (si lo hay)

Método	Descripción
POP3_transporter.checkConnection( )	Verifica la autenticación
POP3_transporter.delete( )	Marca un correo electrónico específico para su eliminación
POP3_transporter.getBoxInfo( )	Devuelve información sobre la bandeja de entrada de correo
POP3_transporter.getMail( )	Devuelve un correo electrónico específico
POP3_transporter.getMailInfo( )	Devuelve información sobre un correo electrónico específico
POP3_transporter.getMailInfoList( )	Devuelve una colección de información de correo electrónico
POP3_transporter.undeleteAll( )	Elimina la marca de eliminación de todos los correos electrónicos

Nota: la conexión POP3 se cierra automáticamente cuando se destruye el objeto transportador.