Ir para o conteúdo

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:

    anexo

  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 anexo 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.

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:

Format of the SMTP Mail Servers field
<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:

Example 1 (Hard-coded)
smtp.office365.com?clientId=1234ab5c6d78e9f&tenant=abcdefgh-ij12-3456&clientSecret=Abc1-d2E3f-GhIjKlMn4-Opqrs_567&port=25&starttls=true
Example 2 (Using Variables, Scope, and URL Encoding)
[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:

anexo

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

anexo