Notificações por email no Jitterbit Integration Studio

Introdução

As notificações configuradas no Integration Studio são acionadas por uma ação de operação ou iniciadas a partir de um script. As notificações por email podem ser usadas para enviar automaticamente um email em caso de sucesso ou falha de uma operação ou ao chamar um script.

Se você deseja configurar uma notificação por email que seja acionada quando um agente privado ficar offline ou quando sua senha do Harmony estiver prestes a expirar, consulte Alertas.

Para outras maneiras de configurar notificações por email no Integration Studio, consulte Maneiras de enviar email.

Criar ou editar uma notificação por email

As notificações por email podem ser criadas ou editadas a partir do painel do projeto, das configurações da operação ou de um script.

Novas notificações por email são criadas com o nome padrão Nova Notificação por Email. Notificações subsequentes com nomes padrão são acrescidas de um número incrementado entre parênteses.

Após criar uma notificação por email ou abrir uma notificação existente para editar, consulte Configurar uma notificação por email mais adiante nesta página para configuração.

Painel do projeto

Uma nova notificação por email pode ser criada a partir da aba Componentes do painel do projeto usando a opção Criar Novo na categoria Emails (veja o menu de ações da aba Componentes em Aba Componentes do painel do projeto).

Uma notificação existente pode ser editada a partir da aba Componentes do painel do projeto usando a opção Visualizar/Editar em um componente de notificação por email (veja o menu de ações do componente em Aba Componentes do painel do projeto).

Configurações da operação

Você também pode criar ou editar notificações por email na aba Ações das Configurações da operação, que podem ser acessadas a partir destes locais:

• A aba Workflows do painel do projeto (veja o menu de ações do componente na aba Workflows do painel do projeto).
• A aba Components do painel do projeto (veja o menu de ações do componente na aba Components do painel do projeto).
• A tela de design (veja o menu de ações do componente na tela de design).

Uma vez que a tela de Configurações da operação esteja aberta, selecione a aba Ações. Selecione a Condição e, para a Ação, selecione Enviar Notificação por Email. Para criar uma nova notificação por email, clique no link para Criar Nova Notificação por Email para abrir a tela de configuração da notificação por email:

Para editar uma notificação por email existente, certifique-se de que Enviar Notificação por Email esteja selecionado como a Ação. Em seguida, no dropdown de Notificação por Email, passe o mouse sobre a notificação existente e clique no ícone de editar para abrir a tela de configuração da notificação por email.

Script

Você pode querer usar um script que pode ser configurado na operação para incluir lógica avançada sobre quando enviar a notificação por email. Por exemplo, para verificar um código específico ou estado de erro, você pode usar um script para ter mais controle sobre o que acontece quando ocorre um erro.

Dentro do editor de script, abra a aba Notificações do palete de componentes de script.

Para criar uma nova notificação por email, clique em Adicionar Novo.

Para editar uma notificação existente, clique no nome da notificação.

Menu de ações de notificações por email

Após a criação de uma notificação por email, as ações do menu para essa notificação estão acessíveis na aba Componentes do painel do projeto (veja o Menu de ações de componentes na aba Componentes do painel do projeto).

Cada uma dessas ações de menu está disponível:

Item do Menu	Descrição
	Ver/Editar abre a tela de configuração da notificação por email para que você possa configurar a notificação. Para detalhes, veja Configurar uma notificação por email mais adiante nesta página.
	Recortar coloca uma cópia da notificação por email na sua área de transferência e exclui a notificação original do projeto (veja Reutilização de componentes).
	Copiar coloca uma cópia da notificação por email na sua área de transferência (veja Reutilização de componentes).
	Duplicar cria uma nova notificação por email não referenciada usando a mesma configuração da notificação original (veja Reutilização de componentes).
	Renomear posiciona o cursor no nome da notificação por email para que você possa fazer as edições necessárias.
	Ver Dependências altera a visualização no painel do projeto para exibir quaisquer outras partes do projeto das quais a notificação por email depende (veja Dependências, exclusão e remoção de componentes).
	Adicionar ao Grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou para adicionar a notificação por email a um grupo existente (veja Grupos de componentes).
	Excluir exclui permanentemente a notificação por email (veja Dependências, exclusão e remoção de componentes).
	Remover remove referências à notificação por email que estão configuradas com uma ação de operação na tela de design (veja Dependências, exclusão e remoção de componentes).

Configurar uma notificação por email

Esta seção aborda a configuração de uma notificação por email. Após isso, você pode configurar um email para ser enviado em caso de sucesso ou falha de uma operação (veja Ações de operação) ou adicionar a notificação a um script (veja Tipos de script e criação).

Quando você cria uma nova notificação por email ou edita uma existente, a tela de configuração da notificação por email é aberta:

• Nome da Notificação por Email: Insira um nome para a notificação por email. O nome deve ser exclusivo para cada notificação por email e não deve conter barras (/) ou dois pontos (:).

• Servidor(es) de Email SMTP: Insira pelo menos um servidor SMTP que você deseja usar para enviar o email. Se inserir vários servidores SMTP, use uma vírgula para separar cada um. Os servidores são testados na ordem em que são especificados até que um seja encontrado para aceitar a mensagem.

• Endereço(s) de Email para: Insira pelo menos um endereço de email para receber o email. Se inserir vários destinatários, use uma vírgula para separar cada um.

  Dica

  Se você não souber quem são o(s) destinatário(s) até depois de executar uma operação, pode definir e usar uma variável global. Por exemplo, uma variável global [notify_email] poderia usar valores retornados pela função DBLookup para procurar o(s) endereço(s) de email.

• De Endereço de Email: Insira o endereço de email que você deseja que apareça como remetente quando o(s) destinatário(s) lerem o email.

• Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

  

  • Usar SSL/TLS: Selecione a caixa de seleção para criptografar o email usando o protocolo SSL/TLS.

  • Endereço(s) de Email em CC: Insira um ou mais endereços de email para receber uma cópia do email. Se estiver inserindo múltiplos destinatários em cópia, use uma vírgula para separar cada um.

  • Endereço(s) de Email em BCC: Insira um ou mais endereços de email para receber uma cópia oculta do email. Se estiver inserindo múltiplos destinatários em cópia oculta, use uma vírgula para separar cada um.

  • Responder para Endereço de Email: Insira o endereço de email para o qual você deseja que as respostas sejam enviadas por padrão. Isso pode ser útil se você enviar o email de uma conta comum, mas quiser que as respostas vão para uma conta de email pessoal.

  • Usar Autenticação: Selecione a caixa de seleção se o servidor SMTP exigir autenticação. Ao selecionar esta opção, os campos Conta e Senha abaixo ficam habilitados para você inserir suas credenciais de autenticação.

    

• Assunto e Mensagem: Insira o assunto e o corpo a serem usados para o email. Para usar variáveis globais, variáveis de projeto ou variáveis Jitterbit na Mensagem, insira-as manualmente ou comece digitando um colchete aberto [ no campo para exibir uma lista de variáveis existentes para escolher.

  Nota

  Palavras-chave de nome de arquivo, como [date], não funcionam nos campos Assunto ou Mensagem se não forem primeiro definidas como variáveis globais. Para usar funções de data e hora para preencher uma variável global, você pode fazê-lo dentro de um script. Por exemplo:

  // This sets the global variable equal to the current date and time
  $date = Now()
  // This sets the global variable equal to just the date
  $date = CVTDate(Now(),"yyyy-mm-dd HH:MM:SS","yyyy-mm-dd")
  

  Dica

  Você pode usar HTML na Mensagem. Variáveis podem ser usadas dentro das tags HTML utilizando colchetes, como demonstrado com a variável email_address abaixo:

  <html>
  <head>
  <title>Page Title</title>
  </head>
  <body>
  <h1>This Is a Heading</h1>
  <p>This is a paragraph.</p>
  <p>[Visit our HTML tutorial.](https://www.example.com/html/message/)</p>
  <p>Send me an email at [email_address].</p>
  </body>
  </html>
  

• Teste: Clique para enviar um email de teste usando a configuração. Recomenda-se enviar um email de teste para garantir que a configuração funcione corretamente e como esperado. Se variáveis forem usadas na configuração, pode ser necessário especificar um valor padrão para usar para fins de teste (veja Variáveis).

• Salvar: Clique para salvar e fechar a configuração de notificação por email.

• Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Adicionar uma notificação por email a uma operação ou script

O envio de uma notificação por email pode ser adicionado a uma operação como uma ação a ser realizada em caso de sucesso ou falha da operação, ou pode ser adicionado a um script para ser executado usando lógica avançada sobre quando enviar o email. Isso é configurado a partir das configurações da operação ou de dentro de um script.

Configurações da operação

Abra as configurações da operação para uma operação existente e selecione a aba Ações. Em seguida, configure a ação da operação da seguinte forma:

1. No primeiro dropdown, selecione a condição apropriada da operação que deve acionar a ação (Em Caso de Sucesso ou Em Caso de Falha).
2. No segundo dropdown, selecione Enviar Email.
3. No terceiro dropdown, selecione a notificação por email configurada.
4. Clique em Adicionar Ação para adicionar a notificação por email à operação.

Para uma explicação mais detalhada das opções, veja Ações da operação.

Notificações por email vinculadas são exibidas diretamente na tela de design conectadas à operação com a qual estão associadas:

Script

Dentro de um script escrito em Jitterbit Script, abra a aba Notificações do painel de componentes do script.

Para adicionar uma notificação e a função necessária para executá-la, use a função SendEmailMessage e a referência da notificação como um argumento da função. Para mais detalhes, consulte Notificações em Jitterbit Script.