Mensagens E-mail¶

Visão Geral¶

Mensagens E-mail podem ser enviadas automaticamente após o sucesso ou fracasso de uma operação. As mensagens E-mail também podem ser configuradas para serem usadas por um alvo e-mail em uma operação ou usado como argumento para o SendEmail função.

Crie uma Mensagem E-mail¶

Siga estas etapas para criar e configurar uma mensagem e-mail a ser enviada em caso de sucesso ou falha de uma operação:

1. Na árvore do projeto, clique com o botão direito no nó Mensagens E-mail e no menu selecione Nova mensagem E-mail.

   A aba Nova mensagem E-mail aparece no painel direito:

   

2. Preencha as propriedades da mensagem.

   Dica

   Os campos SMTP Mail Servers, To, From, Assunto e Text reconhecem substituições de variáveis globais. Por exemplo, se você não sabe quem será o destinatário até o tempo de execução, você pode definir uma variável global chamada notify_email na transformação (usando um DBLookup ou com dados de entrada) e, em seguida, insira [notify_email] no campo Para.

   • Nome: (Obrigatório) O nome da mensagem, que deve ser exclusivo dentro do projeto.

   • Servidores de e-mail SMTP: Lista separada por vírgulas de servidores SMTP a serem usados para enviar o e-mail. Os servidores serão testados na ordem em que foram especificados até que seja encontrado um que aceite a mensagem.

     Nota

     Para fornecer suporte para OAuth 2.0 com e-mail do Microsoft 365, parâmetros adicionais podem ser passados na string do hospedar SMTP usando o campo SMTP Mail Servers. Para obter instruções, consulte Suporte OAuth 2 para E-mail do Microsoft 365 abaixo.

   • Para: (Obrigatório) Lista de destinatários separados por vírgulas.

   • De: O endereço e-mail que aparecerá no campo De quando o(s) destinatário(s) lerem o e-mail.

   • Usar SSL/TLS: Selecione para criptografar o e-mail usando o protocolo SSL/TLS. Esta propriedade influencia o valor padrão do opcional starttls parâmetro conforme descrito em Suporte OAuth 2 para Microsoft 365 E-mail abaixo.

   • Autenticação: Para usar autenticação básica, expanda Autenticação e selecione Usar autenticação. Você pode então inserir uma Conta e uma Senha da conta.

     Nota

     OAuth 2.0 é compatível com o Microsoft 365 conforme descrito em Suporte do OAuth 2 para E-mail do Microsoft 365 abaixo.

   • Opcional: Expanda Opcional para mostrar campos opcionais adicionais:

     • CC: Lista separada por vírgulas de endereços e-mail para receber uma cópia da mensagem.
     • BCC: Lista separada por vírgulas de endereços e-mail para receber uma cópia oculta da mensagem.
     • Responder para: Um endereço e-mail para o qual você deseja que as respostas sejam enviadas (usado por padrão quando o destinatário responde em seu aplicativo de e-mail). Isso pode ser usado se você enviar o e-mail de uma conta, mas quiser que as respostas vão para uma conta e-mail diferente.

   • Assunto: O assunto do e-mail.

   • Texto: O corpo do e-mail.

3. Clique no ícone Salvar na barra de ferramentas no canto superior direito para salvar a mensagem e-mail.

4. Na árvore do projeto, clique no botão operação ao qual você deseja adicionar a mensagem de notificação.

   O gráfico de operação aparece no painel direito.

5. No gráfico de operação, clique em na parte superior do gráfico de operação para mostrar o menu de operação.

   1. No menu, selecione Em caso de sucesso > E-mail > Selecionar existente ou Em caso de falha > E-mail > Selecionar existente.

   2. Uma janela pop-up exibe a lista de mensagens e-mail existentes. Selecione a mensagem e-mail criada nas etapas anteriores e clique em OK.

6. A mensagem e-mail será adicionada ao gráfico da operação:

   • Uma linha verde e um ícone são mostrados para uma mensagem e-mail configurada para ser enviada em caso de sucesso da operação.
   • Uma linha vermelha e um ícone são mostrados para uma mensagem e-mail configurada para ser enviada em caso de falha da operação.

Suporte OAuth 2.0 para E-mail do Microsoft 365¶

Para usar o OAuth 2.0 com e-mail do Microsoft 365, você fornece parâmetros adicionais na cadeia de caracteres do hospedar SMTP usando o campo SMTP Mail Servers. Esses parâmetros adicionais são suportados com Agentes em Nuvem 11.3 ou posterior, Agentes Privados 11.x que são pelo menos a versão 11.1.1 e Agentes Privados 10.x que são pelo menos a versão 10.63.1.

As propriedades no campo SMTP Mail Servers devem estar no seguinte formato:

<SMTP Host>?clientId=<Client ID>&tenant=<Tenant>&clientSecret=<Client Secret>

Esses parâmetros opcionais adicionais também podem ser usados, se necessário, para substituir os valores padrão:

Exemplos de entradas para o campo SMTP Mail Servers usando OAuth 2.0:

smtp.office365.com?clientId=1234ab5c6d78e9f&tenant=abcdefgh-ij12-3456&clientSecret=Abc1-d2E3f-GhIjKlMn4-Opqrs_567&port=25&starttls=true

[email.server]?clientId=[clientId]&tenant=[tenant]&clientSecret=[clientSecret]&[scope]&urlEncoded=true

Parâmetros Dinâmicos¶

Palavras-chave do nome do arquivo como [date] não funcionam nos campos Assunto ou Texto.

Como alternativa, você pode usar a função Jitterbit date. Para passar uma data como variável, você pode criar uma variável em um script e atribuir um valor a ela e, em seguida, usá-la na mensagem e-mail. Por exemplo:

$date = Now();  # Gives the current date and time
$date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd");  # Gives just the date

E-mails HTML¶

Você pode usar HTML no corpo da mensagem:

Variáveis (neste caso, uma variável global email.html) pode ser usado dentro de tags HTML: