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:
-
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:
-
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 umDBLookup
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.
-
-
Clique no ícone Salvar na barra de ferramentas no canto superior direito para salvar a mensagem e-mail.
-
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.
-
No gráfico de operação, clique em na parte superior do gráfico de operação para mostrar o menu de operação.
-
No menu, selecione Em caso de sucesso > E-mail > Selecionar existente ou Em caso de falha > E-mail > Selecionar existente.
-
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.
-
-
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.
Importante
É necessário o Agente versão 10.83 / 11.21 ou posterior para usar o starttls
parâmetro. Definir este parâmetro para true
é necessário para forçar o tráfego seguro em portas tradicionalmente não seguras, como 25
quando Usar SSL/TLS estiver ativado.
As propriedades no campo SMTP Mail Servers devem estar no seguinte formato:
<SMTP Host>?clientId=<Client ID>&tenant=<Tenant>&clientSecret=<Client Secret>
Parte | Descrição |
---|---|
Host SMTP | O servidor SMTP. |
ID do Cliente (clientId ) | O ID do cliente obtido do provedor OAuth. |
Inquilino (tenant ) | O ID do locatário obtido do provedor OAuth. |
Segredo do cliente (clientSecret ) | O ID do locatário obtido do provedor OAuth. |
Esses parâmetros opcionais adicionais também podem ser usados, se necessário, para substituir os valores padrão:
Parte | Descrição |
---|---|
Porta (port ) | A porta SMTP. |
STARTTLS (starttls ) | Padrão: false se Usar SSL/TLS estiver ativado, caso contrário true . Definido como true para forçar o tráfego seguro em portas tradicionalmente não seguras, como 25 quando Usar SSL/TLS estiver ativado. Os agentes versão 10.83/11.21 ou posterior são obrigados a usar esse parâmetro. |
Codificação de URL (urlEncoded ) | Padrão: false . Definido como true se os valores precisarem ser codificados em URL. |
Escopo (scope ) | Padrão: https://outlook.office365.com/.default . |
Símbolo (tokenEndpoint ) | Padrão: https://login.microsoftonline.com/ + tenant + /oauth2/v2.0/token . |
Tipo de concessão (grantType ) | Padrão: password . |
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: