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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 um selecionado 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 guias a seguir no formulário Qualificador de destinatário do cliente de e-mail para definir uma configuração de destinatário.
    • Configuração de exibição – Configure o comportamento de preenchimento automático do destinatário de 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 consulta a tabela selecionada e filtra 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 selecione Novo .
    2. Preencha os campos na parte superior do formulário Qualificador do 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 . ServiceNow tabela a ser consultada para destinatários.
      Descrição Uma breve descrição desta configuração de destinatário.
    3. Preencha os campos em Configuração de exibição para controlar a exibição do 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 de 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 os 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) o. 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:
      Selecionando Pesquisa de prefixo a opção exibe Campo Sobrenome menu suspenso 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 a condição para 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 Tipo , insira um script que use estas variáveis para retornar os destinatários apropriados:
      • RecipientQuery 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 RecipientQuery é 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 do preenchimento automático do cliente de e-mail aos contatos que pertencem à mesma conta que o caso do 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. Selecione 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.