Funciones de correo electrónico en Jitterbit Integration Studio

Las funciones de correo electrónico permiten enviar mensajes de correo electrónico desde scripts, ya sea mediante una especificación completa de opciones o utilizando una notificación por correo electrónico configurada.

Validar direcciones de correo electrónico

Para validar una dirección de correo electrónico, se puede utilizar una expresión regular para comprobar que una dirección de correo electrónico sigue reglas específicas. Verifique si coincide (la función RegExMatch() devuelve más de 0 coincidencias) y, si es así, devuelva "válido". Las reglas son que la dirección consista en:

un nombre compuesto de caracteres específicos (alfanuméricos, punto, guion bajo, porcentaje, más, guion), seguido de
un símbolo @, seguido de
un nombre de dominio compuesto de caracteres específicos (alfanuméricos, punto, guion), seguido de
un único punto, seguido de
un nombre de dominio de nivel superior compuesto de caracteres alfabéticos, de dos a cuatro caracteres de longitud.

Toda la expresión está encerrada entre paréntesis para crear una subexpresión marcada; si coincide, se devolverá "1".

Tenga en cuenta que las barras invertidas en la cadena de expresión regular deben ser escapadas duplicándolas.

If(RegExMatch(emailaddress, "([A-z0-9._%+-]+@[A-z0-9.-]+\\.[A-z]{2,4})") > 0,
    "valid",
    "invalid");
// An email address "first.last@example.com" will return "valid"

Para información adicional, consulte Funciones de cadena y la función RegExMatch().

`SendEmail`

Declaración

string SendEmail(string from, string to, string subject, string message[, string smtpServers, string account, string accountPassword, string cc, string bcc, string replyTo, bool useSSL])

Sintaxis

SendEmail(<from>, <to>, <subject>, <message>[, <smtpServers>, <account>, <accountPassword>, <cc>, <bcc>, <replyTo>, <useSSL>])

Parámetros requeridos

from: La dirección de correo electrónico que se utilizará para el campo "de"
to: Una lista de direcciones de correo electrónico delimitadas por comas a las que se enviará el mensaje de correo electrónico
subject: El asunto del mensaje de correo electrónico
message: El mensaje del mensaje de correo electrónico

Parámetros opcionales

smtpServers: Una lista delimitada por comas de servidores SMTP en la forma servidor:puerto, como smtp.example.com:465. El puerto es opcional, y se intentarán los puertos SMTP estándar si no se incluye. Se utilizará el primer servidor exitoso.

Nota

Los puntos finales creados utilizando el parámetro smtpServers se incluyen en informe de uso de puntos finales y cuentan para su licencia.
account: Nombre de la cuenta que se utilizará en los servidores SMTP
accountPassword: Contraseña para la cuenta en los servidores SMTP
cc: Una lista delimitada por comas de direcciones de correo electrónico para enviar una copia del correo electrónico
bcc: Una lista delimitada por comas de direcciones de correo electrónico para "copia oculta"
replyTo: Una dirección de correo electrónico para el campo de respuesta
useSSL: Bandera booleana que indica si se debe usar SSL/TLS al autenticarse con los servidores SMTP.

Descripción

Envía un correo electrónico utilizando la información proporcionada. En caso de éxito, se devuelve una cadena vacía; de lo contrario, se devuelven los mensajes de error.

Solo se requieren los primeros cuatro parámetros; el resto son opcionales. Si no se especifica información, se leerá del archivo de configuración del servidor. Si no está disponible en el archivo de configuración, el correo electrónico no se enviará.

Ejemplos

Ejemplo 1

// Sending an email
// From address
// To address
// Subject
// Message
// SMTP servers
// Account
// Account password
// CC list
// BCC list
// Reply-to address
// Using SSL
SendEmail("john.doe@example.com",
    "jane.doe@example.com,firstname.lastname@example.com",
    "Weird data in PO input",
    "There was some weird data in this incoming PO, could you have a look at it?",
    "http://mail.example.com",
    "john.doe@example.com",
    "mymailpwd",
    "jennifer@example.com",
    "svennis@example.com, urban@example.com",
    "jd@example.com",
    1);

Ejemplo 2

// Sending email, showing port configuration
SendEmail("myname@example.com",
    "othername@example.com",
    "Sendmail TEST",
    "A Sendmail TEST message.",
    "smtp.example.com:587",
    "myname@example.com",
    "mypassword", '', '', '', 1);

En el último ejemplo, se utiliza un servidor SMTP que escucha en el puerto. Como no hay direcciones copiadas o copiadas en blanco en el mensaje de correo electrónico, se muestran como cadenas vacías. Como no hay una dirección de correo electrónico de "respuesta", también es una cadena vacía.

[Volver al inicio]

`SendEmailMessage`

Declaración

string SendEmailMessage(string emailMessageId)

Sintaxis

SendEmailMessage(<emailMessageId>)

Parámetros requeridos

emailMessageId: Una ruta de referencia de cadena a una notificación por correo electrónico en el proyecto actual

Descripción

Envía un correo electrónico utilizando una notificación por correo electrónico predefinida. Si tiene éxito, se devuelve una cadena vacía; de lo contrario, se devuelven los mensajes de error.

El mensaje de correo electrónico utilizado en esta llamada a la función debe estar definido como una notificación por correo electrónico en el proyecto actual. Para más información, consulte las instrucciones sobre cómo insertar mensajes de correo electrónico en la sección de Notificaciones en Jitterbit Script.

Ejemplos

// Send a predefined email message
SendEmailMessage("<TAG>email:My Email Message<TAG>");

[Back to top]

`SendSystemEmail`

Declaración

string SendSystemEmail(string to, string subject, string message)

Sintaxis

SendSystemEmail(<to>, <subject>, <message>)

Parámetros requeridos

to: Una lista de direcciones de correo electrónico delimitadas por comas a las que se enviará el mensaje de correo electrónico
subject: El asunto del mensaje de correo electrónico
message: El mensaje del mensaje de correo electrónico

Descripción

Envía un correo electrónico utilizando una dirección "De" preconfigurada, servidores SMTP e información de cuenta. Estos están definidos en el archivo de configuración del servidor. Si no se han definido, utilice una de las otras funciones de correo electrónico. Si tiene éxito, se devuelve una cadena vacía; de lo contrario, se devuelven los mensajes de error.

Nota

Los puntos finales creados utilizando esta función con el archivo de configuración del agente privado [SMTPClient] definición para DefaultSMTPServers están incluidos en informe de uso de puntos finales y cuentan para su licencia.

Ejemplos

SendSystemEmail(Get("manager_email"),
    "FYI",
    "About to process a new purchase order with POID = " +
        Get("POID") +
        ". Will be available for review in a few minutes.");

// Examples entries in a jitterbit.conf file for sending system emails:
[SmtpClient]
DefaultSmtpServers=mail.example.com
DefaultFromEmail=auser@example.com
# If your SMTP server needs authentication the account and password can be specified:
DefaultAccount=auser
DefaultAccountPassword=apassword
# If your SMTP server uses SSL/TLS, set this to true:
UseSSL=true

[Volver al inicio]