Notificações por e-mail no Jitterbit Studio

Introdução

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

Se você deseja configurar uma notificação por e-mail 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 e-mail no Studio, veja Maneiras de enviar e-mail.

Criar ou editar uma notificação por e-mail

As notificações por e-mail 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 e-mail são criadas com o nome padrão Novo E-mail. Novas 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 e-mail ou abrir uma notificação existente para editar, consulte Configurar uma notificação por e-mail mais adiante nesta página para configuração.

Painel do projeto

Uma nova notificação por e-mail pode ser criada a partir da aba Componentes do painel do projeto usando a opção Criar Novo na categoria E-mails (veja 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 e-mail (veja 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 e-mail na aba Ações das Configurações da operação, que pode ser acessada 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 E-mail. Para criar uma nova notificação por e-mail, clique no link para Criar Nova Notificação por E-mail para abrir a tela de configuração da notificação por e-mail:

Para editar uma notificação por e-mail existente, certifique-se de que Enviar Notificação por E-mail esteja selecionado como a Ação. Em seguida, no dropdown de Notificação por E-mail, 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 e-mail.

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 e-mail. Por exemplo, para verificar um código específico ou estado de erro, você pode usar um script para fornecer mais controle sobre o que acontece quando ocorre um erro.

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

Para criar uma nova notificação por e-mail, clique em Adicionar Novo.

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

Menu de ações de notificações por e-mail

Após a criação de uma notificação por e-mail, as ações do menu para essa notificação estão acessíveis na aba Componentes do painel do projeto (veja 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
	Visualizar/Editar abre a tela de configuração da notificação por e-mail para que você possa configurar a notificação. Para detalhes, veja Configurar uma notificação por e-mail mais adiante nesta página.
	Recortar coloca uma cópia da notificação por e-mail 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 e-mail na sua área de transferência (veja Reutilização de componentes).
	Duplicar cria uma nova notificação por e-mail 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 e-mail para que você possa fazer as edições necessárias.
	Visualizar Dependências altera a visualização no painel do projeto para exibir outras partes do projeto das quais a notificação por e-mail 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 e-mail a um grupo existente (veja Grupos de componentes).
	Excluir exclui permanentemente a notificação por e-mail (veja Dependências, exclusão e remoção de componentes).
	Remover remove referências à notificação por e-mail 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 e-mail

Esta seção aborda a configuração de uma notificação por e-mail. Após isso, você pode configurar um e-mail 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 e-mail ou edita uma existente, a tela de configuração da notificação por e-mail é aberta:

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

• Servidor(es) de E-mail SMTP: Insira pelo menos um servidor SMTP que você deseja usar para enviar o e-mail. 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. Para especificar uma porta, use o formato smtp.server.com:PORT (por exemplo, smtp.server.com:533).

• Endereço(s) de E-mail Para: Insira pelo menos um endereço de e-mail para receber o e-mail. 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 e-mail.

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

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

  

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

  • Endereço(s) de E-mail CC: Insira um ou mais endereços de e-mail para receber uma cópia do e-mail. Se estiver inserindo vários destinatários copiados, use uma vírgula para separar cada um.

  • Endereço(s) de E-mail BCC: Insira um ou mais endereços de e-mail para receber uma cópia oculta do e-mail. Se estiver inserindo vários destinatários com cópia oculta, use uma vírgula para separar cada um.

  • Endereço de E-mail para Respostas: Insira o endereço de e-mail para o qual você deseja que as respostas sejam enviadas por padrão. Isso pode ser útil se você enviar o e-mail de uma conta comum, mas quiser que as respostas vão para uma conta de e-mail 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 e-mail. 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 usando 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 e-mail de teste usando a configuração. É recomendável enviar um e-mail 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 e-mail.

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

Adicionar uma notificação por e-mail a uma operação ou script

O envio de uma notificação por e-mail 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 e-mail. 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 E-mail.
3. No terceiro dropdown, selecione a notificação por e-mail configurada.
4. Clique em Adicionar Ação para adicionar a notificação por e-mail à operação.

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

Notificações por e-mail 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.