Funciones de Correo¶

Las funciones de Correo permiten enviar mensajes de correo desde secuencias de comandos, ya sea mediante una especificación completa de opciones o mediante una notificación de correo configurada.

Validar Direcciones de Correo¶

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

• un nombre compuesto por caracteres específicos (alfanuméricos, punto, guión bajo, porcentaje, más, guión), seguido de
• un símbolo @, seguido de
• un nombre de dominio compuesto por caracteres específicos (alfanuméricos, punto, guión), seguidos de
• un solo período, seguido de
• un nombre de dominio de nivel superior compuesto por caracteres alfabéticos, de dos a cuatro caracteres de longitud.

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

Tenga en cuenta que es necesario duplicar las barras invertidas en la cadena de expresión regular.

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 obtener 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 que se utilizará para el campo "de"
• to: Una lista delimitada por comas de direcciones de correo a las que enviar el mensaje de correo
• subject: El asunto del mensaje de correo
• message: El mensaje del mensaje de correo

Parámetros Opcionales¶

• smtpServers: Una lista delimitada por comas de servidores SMTP en el formato servidor:puerto, como smtp.example.com:465. El puerto es opcional y se probarán los puertos SMTP estándar si no están incluidos. Se utilizará el primer servidor exitoso.
• account: Nombre de cuenta que se utilizará en los servidores SMTP
• accountPassword: Contraseña de la cuenta en los servidores SMTP
• cc: Una lista delimitada por comas de direcciones de correo para enviar una copia del correo a
• bcc: Una lista delimitada por comas de direcciones de correo para "copiar" ciegamente
• replyTo: Una dirección de correo para el campo de respuesta
• useSSL: Indicador booleano que indica si se va a utilizar SSL/TLS al autenticarse con los servidores SMTP.

Descripción¶

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

Sólo 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 no se enviará.

Ejemplos¶

// 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);

// 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 se copian ni se copian direcciones en el mensaje de correo, se muestran como cadenas vacías. Como no hay una dirección de correo de "respuesta", también es una cadena vacía.

SendEmailMessage¶

Declaración¶

string SendEmailMessage(string emailMessageId)

Sintaxis¶

SendEmailMessage(<emailMessageId>)

Parámetros Requeridos¶

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

Descripción¶

Envía un correo utilizando una notificación de correo predefinida. En caso de éxito, se devuelve una cadena vacía; de lo contrario, se devuelven los mensajes de error.

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

Ejemplos¶

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

SendSystemEmail¶

Declaración¶

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

Sintaxis¶

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

Parámetros Requeridos¶

• to: Una lista delimitada por comas de direcciones de correo a las que enviar el mensaje de correo
• subject: El asunto del mensaje de correo
• message: El mensaje del mensaje de correo

Descripción¶

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

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