SMTPTransporter

La clase SMTPTransporter permite configurar conexiones SMTP y enviar correos electrónicos a través de objetos SMTP transporter.

Objeto SMTP Transporter

Los objetos SMTP Transporter son instanciados con el comando SMTP New transporter. Ofrecen las siguientes propiedades y funciones:

4D.SMTPTransporter.new()

4D.SMTPTransporter.new*( server : Object ) : 4D.SMTPTransporter

Parámetros	Tipo		Descripción
server	Object	->	Información del servidor de correo
Resultado	4D.SMTPTransporter	<-	Objeto SMTP Transporter

Descripción

La función 4D.SMTPTransporter.new() crea y devuelve un nuevo objeto del tipo 4D.SMTPTransporter. Es idéntico al comando SMTP New transporter (acceso directo).

Para obtener información sobre los códigos de estado SMTP, por favor consulte esta página.

Ejemplo

 var $pw : Text
 var $options : Object
 var $transporter : 4D.SMTPTransporter
 $options:=New object

 $pw:=Request("Please enter your password:")
 $options.host:="smtp.gmail.com"

 $options.user:="test@gmail.com"
 $options.password:=$pw

 $transporter:=SMTP New transporter($options)

 $status:=$transporter.checkConnection()
 If($status.success=True)
    ALERT("SMTP connection check successful!")
 Else
    ALERT("Error # "+String($status.status)+", "+$status.statusText)
 End if

.keepAlive

Historia

Lanzamiento	Modificaciones
17 R4	Añadidos

.keepAlive* : Boolean

Descripción

La propiedad .keepAlive contiene True si la conexión SMTP debe permanecer activa hasta que el objeto transporter sea destruido, y False en caso contrario. Por defecto, si la propiedad keepAlive no se ha definido en el objeto server (utilizado para crear el objeto transporter con SMTP New transporter), es True.

La conexión SMTP se cierra automáticamente:

• cuando el objeto transporter es destruido si la propiedad .keepAlive es true,
• después de cada función .send( ) si la propiedad .keepAlive está en false.

.send()

Historia

Lanzamiento	Modificaciones
17 R5	Soporte de contenidos Mime
17 R4	Añadidos

.send*( mail : Object ) : Object

Parámetros	Tipo		Descripción
mail	Object	->	Email a enviar
Resultado	Object	<-	Estado SMTP

Descripción

La función .send() envía el objeto mail al servidor SMTP definido en el objeto transporter y devuelve un objeto estado.

El objeto transporter debe haber sido creado con el comando SMTP New transporter.

El método crea la conexión SMTP si no está ya activa. Si la propiedad .keepAlive del objeto transporter es false, la conexión SMTP se cierra automáticamente después de la ejecución de . end(), de lo contrario permanece viva hasta que el objeto transporter sea destruido. Para más información, consulte la descripción del comando SMTP New transporter.

En mail, pase un objeto Email válido para enviar. Las propiedades origen (de dónde viene el correo electrónico) y destino (uno o varios destinatarios) deben incluirse, el resto de propiedades son opcionales.

Objeto devuelto

La función devuelve un objeto que describe el estado SMTP de la operación. Este objeto puede contener las siguientes propiedades:

Propiedad	Tipo	Descripción
success	boolean	True si el envío tiene éxito, false en caso contrario
status	number	Código de estado devuelto por el servidor SMTP (0 en caso de un problema no relacionado con el procesamiento del correo)
statusText	text	Mensaje de estado devuelto por el servidor SMTP

En caso de un problema no relacionado con el procesamiento SMTP (por ejemplo, si falta una propiedad obligatoria en el correo), 4D genera un error que puede interceptar utilizando un método instalado por el comando ON ERR CALL. Utilice el comando Últimos errores para obtener información sobre el error.

En este caso, el objeto estado resultante contiene los siguientes valores:

Propiedad	Valor
success	False
status	0
statusText	"Failed to send email"