Ir para o conteúdo

Mensagens de email no Jitterbit Design Studio

Visão Geral

Mensagens de email podem ser enviadas automaticamente após o sucesso ou falha de uma operação. As mensagens de email também podem ser configuradas para serem usadas por um destino de email em uma operação, ou usadas como um argumento para a função SendEmail.

Criar uma mensagem de email

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

  1. No painel do projeto, clique com o botão direito do mouse no nó Mensagens de Email e, no menu, selecione Nova Mensagem de Email.

    A aba Nova Mensagem de Email aparece no painel direito:

    attachment

  2. Complete as propriedades da mensagem.

    Dica

    Os campos Servidores de Email 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é a execução, pode definir uma variável global chamada notify_email na transformação (usando um DBLookup ou com dados de entrada) e, em seguida, inserir [notify_email] no campo Para.

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

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

      Nota

      Para fornecer suporte ao OAuth 2.0 com email do Microsoft 365, parâmetros adicionais podem ser passados na string do host SMTP usando o campo Servidores de Email SMTP. Para instruções, veja Suporte ao OAuth 2 para email do Microsoft 365 abaixo.

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

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

  3. Usar SSL/TLS: Selecione para criptografar o email usando o protocolo SSL/TLS. Isso é necessário para muitos serviços SMTP modernos, incluindo o email do Microsoft 365. Essa propriedade influencia o valor padrão para o parâmetro opcional starttls, conforme descrito em Suporte OAuth 2 para email do Microsoft 365 abaixo.

  4. Autenticação: Para usar autenticação básica ou o tipo de concessão password com OAuth 2.0, expanda Autenticação e selecione Usar autenticação. Você pode então inserir uma Conta e a Senha da conta.

    !!! note "Nota"
    OAuth 2.0 é suportado para Microsoft 365, conforme descrito em [Suporte OAuth 2 para email do Microsoft 365](#365) abaixo.

  5. Opcional: Expanda Opcional para mostrar campos adicionais:

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

  6. Assunto: O assunto do email.

  7. Texto: O corpo do email.

  8. Clique no ícone Salvar na barra de ferramentas no canto superior direito para salvar a mensagem de email.

  9. Na árvore do projeto, clique na operação à qual você deseja adicionar a mensagem de notificação.

    O gráfico da operação aparece no painel à direita.

  10. No gráfico da operação, clique no anexo no topo do gráfico da operação para mostrar o menu da operação.

    1. No menu, selecione Em Sucesso > Email > Selecionar Existente ou Em Falha > Email > Selecionar Existente.

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

  11. A mensagem de email será adicionada ao gráfico da operação:

  12. Uma linha e ícone verdes são exibidos para uma mensagem de email configurada para ser enviada em caso de sucesso da operação.

  13. Uma linha e ícone vermelhos são exibidos para uma mensagem de email configurada para ser enviada em caso de falha da operação.

Suporte OAuth 2.0 para email do Microsoft 365

Para usar OAuth 2.0 com email do Microsoft 365, forneça parâmetros adicionais na string do host SMTP usando o campo SMTP Mail Servers. Esses parâmetros adicionais são suportados com agentes em nuvem 11.3 ou posteriores, agentes privados 11.x que estão pelo menos na versão 11.1.1 e agentes privados 10.x que estão pelo menos na versão 10.63.1.

Importante

É necessário ter a versão do agente 10.83 / 11.21 ou posterior para usar o parâmetro starttls. Definir este parâmetro como true é necessário para forçar tráfego seguro em portas tradicionalmente não seguras, como 25, quando Usar SSL/TLS está habilitado.

As propriedades no campo SMTP Mail Servers devem estar no seguinte formato sensível a maiúsculas e minúsculas:

Formato do campo SMTP Mail Servers
<SMTP Host>?clientId=<Client ID>&tenant=<Tenant>&clientSecret=<Client Secret>
Parte Descrição
SMTP Host O servidor SMTP.
Client ID (clientId) O ID do cliente obtido do provedor OAuth.
Tenant (tenant) O ID do locatário obtido do provedor OAuth.
Client Secret (clientSecret) O ID do locatário obtido do provedor OAuth.

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

Parte Descrição
Porta (port) Padrão: 587. A porta SMTP.
STARTTLS (starttls) Padrão: false se Usar SSL/TLS estiver habilitado, caso contrário true. Defina como true para forçar tráfego seguro em portas tradicionalmente não seguras, como 25, quando Usar SSL/TLS estiver habilitado. É necessário ter versões do agente 10.83 / 11.21 ou posteriores para usar este parâmetro.
Codificação de URL (urlEncoded) Padrão: false. Defina como true se os valores precisarem ser codificados em URL.
Escopo (scope) Padrão: https://outlook.office365.com/.default.
Token (tokenEndpoint) Padrão: https://login.microsoftonline.com/ + tenant + /oauth2/v2.0/token.
Tipo de Concessão (grantType) Padrão: password. Use password com autenticação básica ou OAuth 2.0 quando Usar autenticação estiver habilitado em Autenticação com uma Conta válida e Senha da conta. Use client_credentials com OAuth 2.0 se password não for aplicável.

Exemplos de entradas para o campo Servidores de Email SMTP usando OAuth 2.0:

Exemplo 1 (Codificado em Duro)
smtp.office365.com?clientId=1234ab5c6d78e9f&tenant=abcdefgh-ij12-3456&clientSecret=Abc1-d2E3f-GhIjKlMn4-Opqrs_567&port=25&starttls=true
Exemplo 2 (Usando Variáveis, Escopo e Codificação de URL)
[email.server]?clientId=[clientId]&tenant=[tenant]&clientSecret=[clientSecret]&[scope]&urlEncoded=true

Parâmetros Dinâmicos

Palavras-chave de nome de 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 então usá-la na mensagem de email. Por exemplo:

$date = Now();  # Retorna a data e hora atuais
$date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd");  # Retorna apenas a data

Emails em HTML

Você pode usar HTML no corpo da mensagem:

anexo

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

anexo