Funções de e-Email

As funções de e-Email permitem que mensagens sejam enviadas a partir de scripts como um projeto predefinido ou email do sistema ou por 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 (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 de email a ser usado para o campo "de"
• to: Uma lista delimitada por vírgulas de endereços de email 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 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 de email para enviar uma cópia do email para
• bcc: Uma lista delimitada por vírgulas de endereços de email para "cópia carbono" cega
• replyTo: Um endereço de 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 são retornadas.

Somente os quatro primeiros parâmetros são obrigatórios; o restante é opcional. Se a informação não for especificada, ela será lida 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 escutando na porta é usado. Como não há endereços sendo copiados ou cópias ocultas 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 em inserir itens do projeto.

Exemplos

// Send a predefined email message
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 delimitada por vírgulas de endereços de email 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 de conta. Eles 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