Definir qualificadores de destinatário do cliente de e-mail

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

    • Crie uma configuração que controle a lista de preenchimento automático de destinatários exibida no cliente de e-mail.

    Antes de Iniciar

    Função necessária: email_client_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode especificar qualificadores de destinatário que exibem campos adicionais (de uma tabela selecionada ServiceNow ) na lista de preenchimento automático. Esses campos diferenciam os destinatários de e-mail que têm o mesmo nome e sobrenome.
    Use as seguintes guias no formulário Qualificador de destinatário do cliente de e-mail para definir uma configuração de destinatário.
    • Configuração deexibição – Configure o comportamento de preenchimento automático do destinatário do e-mail e, opcionalmente, selecione campos adicionais para diferenciar os destinatários que têm o mesmo nome. Os campos adicionais garantem que os usuários selecionem o destinatário apropriado para um e-mail.
    • Configuração de consulta – Especifique uma condição ou script que consulte a tabela selecionada e filtre os resultados do destinatário retornados.
    Você pode definir diferentes configurações de destinatário, que podem ser usadas em uma configuração de cliente de e-mail.

    Procedimento

    1. Navegar até Cliente de e-mail > Qualificador de Destinatários do Cliente de e-mail e clique em Novo.
    2. Preencha os campos na parte superior do formulário do Qualificador de Destinatário.
      Campo Descrição
      Nome Um nome exclusivo para esta configuração de destinatário do cliente de e-mail.
      Aplicação O tipo de aplicação com escopo.
      Tabela A tabela ServiceNow a ser consultada para destinatários.
      Descrição Uma breve descrição desta configuração de destinatário.
    3. Preencha os campos na guia Configuração de exibição para controlar a exibição de preenchimento automático no cliente de e-mail.
      Campo Descrição
      Endereço de e-mail O campo na tabela que contém o endereço de e-mail do destinatário.
      Nome para exibição O campo na tabela usado para o nome do destinatário exibido.
      Ordem A ordem dos resultados retornados em relação a outros qualificadores de destinatário definidos.
      Campos de Exibição Adicionais Uma lista de conteúdo para escolher campos adicionais da tabela a serem exibidos na lista de preenchimento automático. Diferencia destinatários que compartilham o mesmo nome.
      Campos Adicionais de Pesquisa Uma caixa de seleção para habilitar campos adicionais a serem pesquisados. Expande os destinatários retornados na lista de preenchimento automático consultando (pesquisando) os Campos de exibição adicionais.
    4. Preencha os campos na guia Configuração de consulta.
      Campo Descrição
      Pesquisa de prefixo Opção para encontrar o destinatário desejado usando o prefixo.
      Nota:
      Selecionar a opção Pesquisa de prefixo exibe o menu suspenso Campo de sobrenome com opções para filtrar o nome do destinatário.
      Tipo Selecione o método para filtrar os destinatários retornados na lista de preenchimento automático:
      • Condição
      • Script
      Condições Se você selecionou Condição para o Tipo, use o Construtor de condições para especificar as condições que devem ser atendidas para retornar os destinatários apropriados.
      Script Se você selecionou Script para o Tipo, insira um script que use estas variáveis para retornar os destinatários apropriados:
      • destinatárioQuery: GlideRecord para a tabela que está sendo consultada.
      • targetRecord: GlideRecord para o registro de destino a partir do qual o cliente de e-mail foi aberto.
      Por exemplo, este destinatárioQuery é um GlideRecord que representa a tabela Contato do cliente. A variável targetRecord é um caso de Atendimento ao cliente a partir do qual o cliente de e-mail foi aberto. Esta consulta limita os resultados de preenchimento automático do cliente de e-mail aos contatos que pertencem à mesma conta do caso de Atendimento ao cliente.
      (function (recipientQuery, targetRecord) {
	
	 // Limit results to contacts belonging to the account for the case.
	 var account = targetRecord.getValue('account');
	 recipientQuery.addQuery('account', account);

})(recipientQuery, targetRecord);
    5. Clique em Enviar.
      A configuração do qualificador de destinatário é adicionada à tabela Qualificador de Destinatário [sys_recipient_qualifier] e está disponível para uso em uma configuração de cliente de e-mail.