Funções Email

As funções Email permitem que mensagens email sejam enviadas a partir de scripts por meio de uma especificação completa de opções ou usando uma notificação email configurada.

Validar Endereços Email

Para validar um endereço email, você pode usar uma expressão regular para testar se um endereço de email segue regras específicas. Verifique se corresponde (o RegExMatch() function retorna mais de 0 correspondências) e, se for o caso, retorna "válido". As regras são que o endereço consiste em:

• um nome composto de caracteres específicos (alfanumérico, ponto, sublinhado, porcentagem, mais, hífen), seguido por
• um símbolo @, seguido por
• um nome de domínio composto de caracteres específicos (alfanumérico, ponto, hífen), seguido por
• um único ponto, seguido por
• um nome de domínio de nível superior composto de caracteres alfabéticos, de dois a quatro caracteres de comprimento.

A expressão inteira é colocada entre parênteses para criar uma subexpressão marcada; se corresponder, "1" será retornado.

Observe que as barras invertidas na string de expressão regular precisam ser escapadas sendo duplicadas.

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 obter informações adicionais, consulte Funções de string e a função RegExMatch().

SendEmail

Declaração

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

Sintaxe

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

Parâmetros Obrigatórios

• from: O endereço email a ser usado no campo "de"
• to: Uma lista delimitada por vírgulas de endereços email para os quais enviar a mensagem email
• subject: O assunto da mensagem email
• message: A mensagem da mensagem email

Parâmetros Opcionais

• smtpServers: Uma lista delimitada por vírgulas de servidores SMTP no formato servidor:porta, como smtp.example.com:465. A porta é opcional, e as portas SMTP padrão serão tentadas se não estiverem incluídas. O primeiro servidor bem-sucedido será usado.
• account: Nome da conta a ser usado nos servidores SMTP
• accountPassword: Senha para a conta nos servidores SMTP
• cc: Uma lista delimitada por vírgulas de endereços email para enviar uma cópia do email para
• bcc: Uma lista delimitada por vírgulas de endereços email para "cópia carbono" cega
• replyTo: Um endereço email para o campo de resposta
• useSSL: Sinalizador booleano indicando se SSL/TLS deve ser usado ao autenticar com os servidores SMTP.

Descrição

Envia um email usando as informações fornecidas. Em caso de sucesso, uma string vazia é retornada; caso contrário, quaisquer mensagens de erro serão retornadas.

Somente os primeiros quatro parâmetros são obrigatórios; o resto é opcional. Se as informações não forem especificadas, elas serão lidas no arquivo de configuração do servidor. Caso não esteja disponível no arquivo de configuração, o email não será enviado.

Exemplos

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

No último exemplo, é usado um servidor SMTP escutando na porta. Como não há endereços sendo copiados ou copiados cegamente na mensagem email, eles são mostrados como strings vazias. Como não existe um endereço email de "resposta", também é uma string vazia.

SendEmailMessage

Declaração

string SendEmailMessage(string emailMessageId)

Sintaxe

SendEmailMessage(<emailMessageId>)

Parâmetros Obrigatórios

• emailMessageId: Um caminho de referência de string para uma notificação email no projeto atual

Descrição

Envia um email usando uma notificação email predefinida. Em caso de sucesso, uma string vazia é retornada; caso contrário, quaisquer mensagens de erro serão retornadas.

A mensagem email usada nesta chamada de função deve ser definida como uma notificação email no projeto atual. Para obter mais informações, consulte as instruções sobre como inserir mensagens email em Notificações seção em Jitterbit Script.

Exemplos

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

SendSystemEmail

Declaração

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

Sintaxe

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

Parâmetros Obrigatórios

• to: Uma lista delimitada por vírgulas de endereços email para os quais enviar a mensagem email
• subject: O assunto da mensagem email
• message: A mensagem da mensagem email

Descrição

Envia um email usando um endereço "De" pré-configurado, servidores SMTP e informações da conta. Eles são definidos no arquivo de configuração do servidor. Se estas não tiverem sido definidas, use uma das outras funções email. Em caso de sucesso, uma string vazia é retornada; caso contrário, quaisquer mensagens de erro serão retornadas.

Exemplos

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