Crie pesquisas de dados personalizadas

A criação de pesquisas de dados personalizadas envolve a adição de um valor de pesquisa, a criação da definição e a ativação da pesquisa de dados.

Crie uma tabela de pesquisa de dados personalizada

Crie uma tabela personalizada para armazenar dados de pesquisa.

A tabela personalizada deve estender as regras de correspondência da pesquisa de dados [dl_matcher] tabela. Por exemplo, esta tabela de pesquisa personalizada armazena informações sobre chamadores VIP e atribuições de incidentes.

Tabela 1. Tabela de pesquisa de dados personalizada

Campo	Valor de amostra
Rótulo	Pesquisa de solicitante VIP
Nome da tabela	u_vip_caller_lookup
Estende a tabela base	dl_matcher
Crie um novo módulo	Verdadeiro(a)
Adicionar módulo ao menu	Política do Sistema

Adicione um valor de pesquisa de dados à tabela de pesquisa de dados

As colunas de uma tabela de pesquisa de dados contêm dados de campo de combinação e definidor.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Cada pesquisa de dados é uma consulta que pesquisa uma linha que contém valores que correspondem aos campos de combinação. A pesquisa de dados retorna o valor listado nos campos do definidor. Por exemplo, esta tabela Pesquisa de dados de prioridade [dl_u_priority] lista as combinações de impacto e urgência (campos correspondentes) que produzem um valor de prioridade específico (campo de definição).

Tabela 2. Tabela de pesquisa

Campos de correspondência		Campo do setter
Impacto	Urgência	Prioridade
1 - Alto	1 - Alto	1 - Crítico
1 - Alto	2 - Médio	2 - Alto
1 - Alto	3 – Baixo	3 - Moderado
2 - Médio	1 - Alto	2 - Alto
2 - Médio	2 - Médio	3 - Moderado
2 - Médio	3 – Baixo	4 - Baixo
3 – Baixo	1 - Alto	3 - Moderado
3 – Baixo	2 - Médio	4 - Baixo
3 – Baixo	3 – Baixo	5 - Planejamento

Procedimento

1. No filtro de navegação, insira o nome da nova tabela de pesquisa personalizada.
   Por exemplo, u_vip_caller_lookup.list .
2. Configure a lista e crie novos campos.

   Para este exemplo, crie os novos campos na tabela a seguir.

   Tabela 3. Novos campos

   Nome	Tipo	Tamanho do campo ou tabela para referência
   Solicitante	Referência	Usuário [sys_user]
   Prioridade	Inteiro
   Grupo de Atribuição	Referência	Grupo [sys_user_group]

   Para obter mais informações, consulte Configurando listas no ServiceNow AI Platform.

3. Na lista de tabelas, selecione Novo e insira os valores de campo de combinador e setter apropriados.

   Por exemplo:

   Tabela 4. Novos valores de campo de combinador e setter

   Campo de correspondência	Campos do setter
   Solicitante	Prioridade	Grupo de Atribuição
   Dirigido por Beth Anglin	2	Problemas de VIP
   Fred Luddy	1	Problemas de VIP

   Nota:

   Cada linha em uma tabela de pesquisa de dados deve ser exclusiva.

Crie um registro de definição de pesquisa de dados

A pesquisa de dados requer um registro de definição que especifique como definir um ou mais valores de campo quando as condições especificadas forem atendidas.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > Política do Sistema > Regras > Definições de pesquisa de dados.
2. Selecione Novo.
3. Selecione Regra de pesquisa de dados .
4. Preencha o formulário Regra de pesquisa de dados usando a tabela a seguir.

   Tabela 5. Campos de definições de pesquisa de dados

   Campo	Descrição
   Nome	Insira um nome exclusivo para identificar o registro de definição.
   Tabela de fonte	Selecione a tabela que contém os campos que você deseja atualizar automaticamente com valores de pesquisa. As definições de pesquisa de dados não são herdadas pelas tabelas de extensão. Por exemplo, uma Definição de pesquisa de dados na tabela Tarefa não pode corresponder aos valores na tabela Incidente.
   Tabela de combinação	Selecione a tabela que contém os valores de pesquisa. Esta tabela deve sempre começar com um prefixo u_. Esta tabela pode ser qualquer tabela no escopo atual que contenha os valores de pesquisa. Nota: A lista mostra apenas as tabelas e as visualizações do banco de dados que estão no mesmo escopo da definição de pesquisa de dados de catálogo.
   Ativo	Marque esta caixa de seleção para executar esta regra de pesquisa de dados. Desmarque a caixa de seleção para ignorar esta regra de pesquisa de dados.
   Executar na mudança de formulário	Marque esta caixa de seleção para pesquisar valores automaticamente sempre que um script de usuário ou cliente onChange mudar um valor de campo em um formulário de tabela de origem. Nota: Isso não inclui mudanças feitas automaticamente por outras regras de pesquisa de dados, como as Regras de pesquisa de prioridade.
   Executar ao inserir	Marque esta caixa de seleção para pesquisar valores automaticamente sempre que um usuário criar um novo registro.
   Executar ao atualizar	Marque esta caixa de seleção para pesquisar valores automaticamente sempre que um usuário salvar ou atualizar um registro.

5. Selecione e segure (ou clique com o botão direito) o cabeçalho do formulário e escolha Salvar.
6. Em Definições de campo de correspondência lista relacionada, clique em Novo .
7. Preencha as Definições de campo de correspondência usando a tabela a seguir.

   Uma pesquisa de dados só ocorre em campos com definições de campo de correspondência. A pesquisa de dados usa os valores dos campos da tabela de origem para pesquisar um ou mais valores da tabela de correspondência. Observe que a pesquisa de dados não funciona com Diário campos de tipo.

   Tabela 6. Campos de definições de campo de correspondência

   Campo	Descrição
   Pesquisa de dados	Exibe o nome do registro de definição de pesquisa de dados primário.
   Campo da tabela de origem	Selecione o campo na tabela de origem que contém os dados a serem correspondentes.
   Campo da tabela de combinação	Selecione o campo na tabela de correspondência que contém os dados a serem correspondentes. Esta tabela pode ser qualquer tabela no escopo atual que contenha os valores de pesquisa.
   Correspondência de pesquisa exata	Marque esta caixa de seleção para exigir que a tabela de correspondência contenha uma linha correspondente para cada combinação possível de valores (incluindo valores vazios). Desmarcar esta caixa de seleção significa que todos os valores vazios na tabela de correspondência correspondem a qualquer valor. Por exemplo, suponha que o campo Prioridade esteja vazio na tabela de correspondência. Quando esta caixa de seleção é marcada, há uma correspondência somente quando o valor de prioridade está vazio na linha da tabela de origem. Quando esta caixa de seleção está desmarcada, o valor do campo de correspondência vazio corresponde a qualquer valor no campo da tabela de origem. Nota: Se a pesquisa não exigir uma correspondência exata, as linhas da tabela de correspondência que contêm valores vazios serão tratadas como caracteres curinga, correspondendo a todos os valores.

8. Selecione Enviar.
9. Em Definições de campo do setter lista relacionada, clique em Novo .
10. Preencha o formulário Definições de campo do setter usando a tabela a seguir.

    Tabela 7. Campos de definições de campo do setter

    Campo	Descrição
    Pesquisa de dados	Exibe o nome do registro de definições de pesquisa de dados primário.
    Campo da tabela de origem	Selecione o campo na tabela de origem que a pesquisa de dados atualiza.
    Campo da tabela de combinação	Selecione o campo da tabela de combinação que fornece o novo valor para a atualização.
    Sempre substituir	Marque esta caixa de seleção para substituir qualquer valor existente por um valor da pesquisa de dados. Desmarque esta caixa de seleção para ignorar a atualização se o campo tiver um valor existente.

11. Selecione Enviar.
12. Selecione Atualizar.

Crie um módulo de pesquisa de dados

Você pode criar um módulo para pesquisa de dados para que ele apareça no navegador de aplicações da instância.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > Definição do Sistema > Menus da aplicação, em seguida, selecione uma aplicação à qual adicionar o módulo.
2. Na lista relacionada Módulos, selecione Novo .
3. Configure um módulo para a tabela de pesquisa de dados que você criou usando as seguintes propriedades.

   Tabela 8. Propriedades do módulo

   Propriedade	Valor obrigatório
   Tabela	Selecione a tabela de pesquisa de dados que você criou na Etapa 2. Por exemplo u_vip_caller_lookup.
   Tipo de link	Lista de registros

4. Selecione Enviar.

Pesquisa de dados de solução de problemas

Se as regras de definição da pesquisa de dados personalizados não estiverem se comportando conforme o esperado, verifique se há determinadas condições.

• Verifique se a definição de pesquisa de dados está definida para ser executada nos eventos apropriados.
• Verifique se o campo correspondente não é somente leitura. Como os usuários não podem mudar campos somente leitura, as interações do usuário não podem acionar um evento de mudança no formulário para campos somente leitura.
• Verifique se um script de cliente não está alterando o valor de um campo. Os scripts de cliente podem acionar Run on form changeeventos, mesmo em campos somente leitura.
• Verifique se os dados na tabela de correspondência estão corretos.
• Se a pesquisa exigir uma correspondência exata, verifique se há uma linha da tabela de combinação para cada combinação possível (incluindo valores em branco). A pesquisa falhará se não for possível encontrar um valor correspondente.
• Verifique se você não criou uma regra recursiva, como:

  Se o campo A for igual a 1, o campo B será igual a 2. Se o Campo B for igual a 2, o Campo A será igual a 2.