Funções de email no Jitterbit Design Studio

As funções de email permitem que mensagens sejam enviadas de scripts, seja como um email de projeto ou sistema pré-definido ou por meio de uma especificação completa de opções.

Validar endereços de email

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

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

A expressão inteira está entre parênteses para criar uma sub-expressão marcada; se corresponder, "1" será retornado.

Observe que as barras invertidas na string da 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 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 de email a ser usado no campo "de"
• to: Uma lista de endereços de email delimitada por vírgulas para enviar a mensagem de email
• subject: O assunto da mensagem de email
• message: A mensagem da mensagem de email

Parâmetros opcionais

• smtpServers: Uma lista de servidores SMTP delimitada por vírgulas no formato servidor:porta, como smtp.example.com:465. A porta é opcional, e as portas SMTP padrão serão tentadas se não estiver incluída. O primeiro servidor bem-sucedido será utilizado.

  Nota

  Os endpoints criados usando o parâmetro smtpServers estão incluídos na reportagem de uso de endpoints e contam para sua licença.

• account: Nome da conta a ser utilizada nos servidores SMTP

• accountPassword: Senha da conta nos servidores SMTP
• cc: Uma lista de endereços de email delimitada por vírgulas para enviar uma cópia do email
• bcc: Uma lista de endereços de email delimitada por vírgulas para cópia oculta
• replyTo: Um endereço de email para o campo de resposta
• useSSL: Flag booleano indicando se SSL/TLS deve ser utilizado 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 são retornadas.

Apenas os quatro primeiros parâmetros são obrigatórios; os demais são opcionais. Se as informações não forem especificadas, serão lidas do arquivo de configuração do servidor. Se não estiver 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, um servidor SMTP ouvindo na porta é utilizado. Como não há endereços sendo copiados ou copiados de forma oculta na mensagem de email, eles são mostrados como strings vazias. Como não há um endereço de email "responder para", também é uma string vazia.

SendEmailMessage

Declaração

string SendEmailMessage(string emailMessageId)

Sintaxe

SendEmailMessage(<emailMessageId>)

Parâmetros obrigatórios

• emailMessageId: Uma mensagem de email no projeto atual

Descrição

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

A mensagem de email usada nesta chamada de função deve ser definida como uma mensagem de email no projeto atual. Veja as instruções sobre inserir itens do projeto.

Exemplos

// Enviar uma mensagem de email predefinida
SendEmailMessage("<TAG>Email Messages/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 de endereços de email delimitada por vírgulas para enviar a mensagem de email
• subject: O assunto da mensagem de email
• message: A mensagem da mensagem de email

Descrição

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