4D Doc Center : SMTP

4D Internet Commands v14

SMTP_QuickSend


SMTP_QuickSend ( nomServidor ; msgDe ; msgA ; msgObjeto ; mensaje {; paramSesion}{; puerto}{; nomUsuario ; contrasena} ) -> resultado

Parámetro	Tipo	Descripción
nomServidor	Cadena	Nombre o dirección IP del servidor
msgDe	Texto	Dirección electrónica o Lista de direcciones
msgA	Texto	Dirección electrónica o Lista de direcciones
msgObjeto	Texto	Asunto del mensaje (UTF-8 por defecto)
mensaje	Texto	Mensaje (UTF-8 por defecto)
paramSesion	Entero largo	0 o se omite = No utilizar SSL sino switchover, 1 = Utilizar SSL, 2 = Nunca utilizar SSL (switchover no permitido), 4 = Enviar texto HTML sin SSL, 5 = Enviar texto HTML con SSL
puerto	Entero largo	Número de puerto a utilizar
nomUsuario	Texto	Nombre de usuario para la autenticación
contrasena	Texto	Contraseña para la autenticación
resultado	Entero	Código de error

Descripción

El comando SMTP_QuickSend permite crear y enviar un mensaje con un solo comando.
Si requiere un mayor control sobre el mensaje o si el mensaje es más complejo, utilice el comando SMTP_New.

nomServidor contiene el nombre o la dirección IP del servidor SMTP que se encargará de la distribución del mensaje.

msgDe contiene una o más direcciones electrónicas completas indicando quien envió el mensaje originalmente. Todas las direcciones que figuran en el encabezado De son visibles para todos los destinatarios del mensaje.

msgA contiene una o más direcciones electrónicas completas. Las direcciones identificadas en el encabezado msgA reciben una copia original del mensaje. Cada destinatario del mensaje puede ver las otras direcciones electrónicas a las cuales fue enviado el mensaje.

asunto es un valor texto que describen de forma concisa el tema tratado en detalle por el cuerpo del mensaje.

Nota: por defecto, el asunto y el cuerpo del mensaje están codificados en UTF-8, lo que garantiza que los caracteres enviados serán interpretados correctamente por casi todos los clientes de correo electrónico. Si desea utilizar un conjunto de caracteres específicos, consulte los comandos SMTP_SetPrefs y SMTP_Charset.

mensaje es un valor texto que contiene el cuerpo del mensaje. Por razones históricas, el tamaño del mensaje está limitado a 32 KB.

El parámetro opcional paramSesion establece el formato del mensaje (texto estándar o HTML) y el modo de activación del protocolo SSL para la conexión:

Si pasa 0 u omite este parámetro, el mensaje será formateado en texto y enviado en modo estándar no seguro. Si el servidor propone una actualización a SSL/TLS después de la autenticación, la báscula se efectúa automáticamente (funcionamiento del SSL/TLS en modo explícito).
Si pasa 1, el mensaje será formateado en texto y enviado enn SSL (modo síncrono),
Si pasa 2, el mensaje será formateado en texto y enviado pero sin soporte de actualización en SSL/TLS.
Si pasa 4, el mensaje será formateado en HTML y enviado en modo estándar.
Si pasa 5, el mensaje será formateado en HTML y enviado en modo SSL/TLS.

El parámetro opcional puerto especifica el número de puerto SMTP a utilizar para la conexión con el servidor. Los valores utilizados con más frecuencia son:

25 = puerto STMP estándar no seguro (puerto por defecto si el parámetro se omite)
465 = puerto SMTPS (SSL/TLS)
587 = puerto STMP estándar (seguro); pase este puerto para conexiones con un servidor MS Exchange (modo explícito).

Los parámetros opcionales nomUsuario y contrasena se utilizan para autenticar el remitente con el servidor de correo. Estos parámetros deben pasarse en conjunto. Note que el modo de autenticación más seguro soportado pro el servidor será el utilizado (como el modo por defecto del comando SMTP_Auth).

Ejemplo 1

Ejemplo de uso de este comando:

 $Host:="www.4d.com"

 $ToAddress:="adupont@4d.fr"

 $FromAddress:="jsmith@4d.com"

 $Subject:="Informes de ventas"

 $Message:="¿Podría enviarme el informe de ventas de enero de 2009? Gracias."

 $Error:=SMTP_QuickSend($Host;$FromAddress;$ToAddress;$Subject;$Message;1)

 If($Error#0)

    ALERT("Error: SMTP_QuickSend"+Char(13)+IT_ErrorText($Error))

 End If

Ejemplo 2

Ejemplo de utilización del comando para un envío de mensaje seguro vía un servidor MS Exchange:

 $ServerName:="exchange.4d.com"

 $MsgTo:="adupont@gmail.com"

 $MsgFrom:="a.user@4d.com"

 $Subject:="Test message"

 $Message:="This is a test for sending a message in secure mode. Please do not reply."

 $Error:=SMTP_QuickSend($ServerName;$MsgFrom;$MsgTo;$Subject;$Message;0;587;"a.user";"@!password@!")

Ejemplo 3

Envío de un mensaje en HTML con SSL/TLS:

 $Host:="smtp.gmail.com"

 $ToAddress:="john@4d.com"

 $FromAddress:="harry@gmail.com"

 $Subject:="Message HTML"

 $Message:="Let’s meet at <b>Joe’s Coffee Shop</b>!"

 $Param:=5 //HTML with SSL

 $Port:=465 //SSL port of gmail

 $User:="harry@gmail.com"

 $Password:="xyz&@!&@"

 $Error:=SMTP_QuickSend($Host;$FromAddress;$ToAddress;$Subject;$Message;$Param;$Port;$User;$Password)