POP3 New transporter
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:
| ||||||||||||||||||
| 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.