Notificações Email¶

Introdução¶

As notificações configuradas no Cloud Studio são acionadas por uma ação de operação ou iniciadas por um script. Notificações Email podem ser usadas para enviar automaticamente um email sobre o sucesso ou falha de uma operação ou sobre a chamada de um script.

Se, em vez disso, você deseja configurar uma notificação email que é acionada quando um Agente Privado fica inativo ou sua senha do Harmony está prestes a expirar, consulte Notificações (Management Console).

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

Criar Ou Editar uma Notificação Email¶

As notificações Email podem ser criadas ou editadas no painel do projeto, nas configurações de operação ou em um script.

Novas notificações email são criadas com o nome padrão Novo Email. Novas notificações subsequentes com nomes padrão são anexadas com um número incrementado entre parênteses.

Após criar uma notificação email ou abrir uma notificação email existente para edição, consulte Configurar uma notificação Email posteriormente nesta página para configuração.

Painel do Projeto¶

Uma nova notificação email pode ser criada na guia Componentes do aba do projeto usando a opção Criar novo na categoria Emails (consulte Menu Ações da categoria em Guia Componentes do painel do projeto).

Uma notificação existente pode ser editada na guia Componentes do aba do projeto usando a opção Visualizar/Editar em um componente de notificação email (consulte Menu Ações do componente em Guia Componentes do painel do projeto).

Configurações de Operação¶

Você também pode criar ou editar notificações email na aba Ações da operação Configurações, que pode ser acessada nestes locais:

• A guia Workflows do aba do projeto (consulte Menu Ações do componente em Guia Workflows do painel do projeto).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).
• A quadro de design (consulte Menu Ações do componente em Quadro de Design).

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

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

Script¶

Talvez você queira usar um script que possa ser configurado na operação para incluir lógica avançada para quando enviar a notificação email. 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 há um erro.

Dentro do editor de script, abra a aba Notificações da paleta de componentes de script:

Para criar uma nova notificação email, clique em Adicionar novo:

Se você já possui uma notificação email que gostaria de editar, clique no nome da notificação existente, como " Email de erro", conforme mostrado aqui:

Menu de Ações de Notificações Email¶

Depois que uma notificação email é criada, as ações de menu para essa notificação ficam acessíveis na aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).

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

Item do menu	Descrição
	Visualizar/Editar abre a tela de configuração de notificação email para você configurar a notificação. Para obter detalhes, consulte Configurar uma notificação Email mais adiante nesta página.
	Cut coloca uma cópia da notificação email na área de transferência e exclui a notificação email original do projeto (consulte Reutilização de componentes).
	Copiar coloca uma cópia da notificação email na sua área de transferência (consulte Reutilização de componentes).
	Duplicar cria uma nova notificação email sem referência usando a mesma configuração da notificação email original (consulte Reutilização de componente).
	Renomear posiciona o cursor no nome da notificação email para você fazer as edições necessárias.
	Visualizar dependências altera a visualização no painel do projeto para exibir quaisquer outras partes do projeto das quais a notificação email depende (consulte 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 email a um grupo existente (consulte Grupos de componentes).
	Excluir exclui permanentemente a notificação email (consulte Dependências, exclusão e remoção de componentes).
	Remover remove referências à notificação email configuradas com uma ação de operação na quadro de design (consulte Dependências, exclusão e remoção de componentes).

Configurar uma Notificação Email¶

Esta seção aborda a configuração de uma notificação email. Feito 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 adicione a notificação a um script (consulte Tipos de Script e criação).

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

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

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

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

  Dica

  Se você não souber quem são os destinatários até executar uma operação, poderá 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) email.

• Endereço de Email: Insira o endereço email do qual você deseja que o e email apareça quando o(s) destinatário(s) ler(em) o email.

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

  

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

  • Endereço(s) Email CC: Insira um ou mais endereços email para receber uma cópia do email. Se inserir vários destinatários copiados, use vírgula para separar cada um deles.

  • Endereços Email Cco: Insira um ou mais endereços email para receber uma cópia oculta do email. Se inserir vários destinatários com cópia oculta, use uma vírgula para separar cada um deles.

  • Endereço de Email para resposta: Digite 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 sejam enviadas para uma conta email pessoal.

  • Usar autenticação: Marque 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 no email. Para usar variáveis globais, variáveis do projeto ou variáveis Jitterbit na Mensagem, insira-os 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 eles não forem primeiro definidos como variáveis globais. Para usar funções de data e hora para preencher uma variável global, você pode fazer isso 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 de tags HTML usando colchetes, conforme 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 o envio de um email de teste para garantir que a configuração funcione corretamente e conforme o esperado. Se variáveis forem usadas na configuração, talvez seja necessário especificar um valor padrão para usar para fins de teste (consulte Variáveis).

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

• Descartar alterações: Após fazer as 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 Email a uma Operação Ou Script¶

O envio de uma notificação email pode ser adicionado a uma operação como uma ação a ser tomada 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 nas configurações de operação ou em um script.

Configurações de Operação¶

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

1. No primeiro menu suspenso, 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 menu suspenso, selecione Enviar Email.
3. No terceiro menu suspenso, selecione a notificação email configurada.
4. Clique em Adicionar ação para adicionar a notificação email à operação.

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

As notificações email vinculadas são exibidas diretamente na quadro de design conectada à operação à qual estão associadas:

Script¶

Dentro de um script escrito em Jitterbit Script, abra a aba Notificações da paleta de componentes de script:

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