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

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 ServiceNow selecionada) 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 de exibiçã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 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 os 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 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 usada 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 a pesquisa de campos adicionais. 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ção 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 usa 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 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 do 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 a contatos que pertencem à mesma conta do 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. 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.