Mensagens E-mail¶

Visão Geral¶

Mensagens E-mail podem ser enviadas automaticamente após o sucesso ou falha 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 um argumento para o SendEmail função.

Criar 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 do mouse 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 Servidores de correio SMTP, Para, De, Assunto e Texto reconhecem substituições de variáveis globais. Por exemplo, se você não souber quem será o destinatário até o tempo de execução, poderá definir uma variável global chamada notify_email na transformação (usando um DBLookup ou com dados de entrada) e depois digite [notify_email] no campo Para.

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

   • SMTP Mail Servers: 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 forem 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 OAuth 2 Support for Microsoft 365 E-mail abaixo.

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

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

   • Usar SSL/TLS: Selecione para criptografar o e-mail usando o protocolo SSL/TLS.

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

     Nota

     OAuth 2.0 é compatível com o Microsoft 365 conforme descrito em OAuth 2 Support for Microsoft 365 E-mail 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 sejam enviadas 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 na 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 no 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 enviar em caso de sucesso da operação.
   • Uma linha vermelha e um ícone são mostrados para uma mensagem e-mail configurada para enviar 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 hospedar SMTP usando o campo SMTP Mail Servers. Esses parâmetros adicionais são suportados com Agentes em Nuvem 11.3 ou posterior, 11.x Agentes Privados com pelo menos a versão 11.1.1 e 10.x Agentes Privados com 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:

Exemplo 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

[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 uma 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 em 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: