Notificações Email¶

Introdução¶

As notificações configuradas no Cloud Studio são acionadas por uma ação de operação ou iniciadas a partir de um script. As 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ê quiser configurar uma notificação email que seja acionada quando um agente privado ficar inativo ou sua senha do Harmony estiver 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¶

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

Novas notificações email são criadas com o nome padrão New 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 mais adiante nesta página para configuração.

Painel do Projeto¶

Uma nova notificação email pode ser criada na aba Componentes do painel do projeto usando a opção Criar novo na categoria Emails (consulte menu de ações da aba Componentes na aba Componentes do painel Projeto).

Uma notificação existente pode ser editada na aba Componentes do painel do projeto usando a opção Exibir/Editar em um componente de notificação email (consulte menu de ações do componente na aba Componentes do painel Projeto).

Configurações de Operação¶

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

• A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A quadro de design (veja menu de ações do componente em Tela de design).

Depois que a tela Configurações da operação estiver aberta, selecione a aba Ações. Selecione a Condição e, para a Ação, selecione Enviar notificação Email. Para criar uma nova notificação email, clique no link para 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 em ícone de edição para abrir a configuração de notificação email tela.

Script¶

Talvez você queira usar um script que pode 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 o aba Notificações da paleta de componentes de script.

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

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

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

Após a criação de uma notificação email, as ações de menu para essa notificação podem ser acessadas na aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

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

Item de menu	Descrição
	Exibir/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.
	Cortar coloca uma cópia da notificação email na sua á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 não referenciada usando a mesma configuração da notificação email original (consulte Reutilização de componentes).
	Renomear posiciona o cursor no nome da notificação email para que você faça as edições necessárias.
	Exibir dependências altera a exibiçã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 que são configuradas com uma ação de operação na quadro de design (consulte Dependências de componentes, exclusão e remoção).TABLEROWEND

Configurar uma Notificação Email¶

Esta seção abrange a configuração de uma notificação email. Depois que isso for feito, você pode configurar um email para ser enviado em caso de sucesso ou falha de uma operação (consulte Ações de operação) ou adicione a notificação a um script (consulte Tipos de Script e criação).

Quando você cria uma nova notificação email 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 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 Endereço(s) Email: Insira pelo menos um endereço 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 os destinatários até depois de executar uma operação, você 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) email.

• Do endereço Email: Insira o endereço email do qual você deseja que o email apareça quando o(s) destinatário(s) lerem 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.

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

  • Endereço(s) Email BCC: 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.

  • Responder ao 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 sejam enviadas 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 serão 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 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 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, 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. O envio de um email de teste é recomendado 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 uso em testes (consulte Variáveis).

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

• 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 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 da operação ou em um script.

Configurações de 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 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 o 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.