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 de 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 de base	dl_matcher
Criar 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.

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 de correspondência) que produzem um valor de prioridade específico (campo de definição).

Tabela 2. Tabela de pesquisa

Campos de combinação		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 a ser referenciada
   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 tabela, clique em Novo e insira os valores de campos de combinação e definidor apropriados.

   Por exemplo:

   Tabela 4. Novos valores de campo de combinador e setter

   Campo de combinação	Campos do setter
   Solicitante	Prioridade	Grupo de Atribuição
   Beth Anglin	2	Problemas do VIP
   Fred Luddy	1	Problemas do 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 origem	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 de 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 na inserção	Marque esta caixa de seleção para pesquisar valores automaticamente sempre que um usuário criar um novo registro.
   Executar na atualização	Marque esta caixa de seleção para pesquisar valores automaticamente sempre que um usuário salvar ou atualizar um registro.

5. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
6. Em Definições de campo de combinação lista relacionada, clique em Novo .
7. Preencha as Definições de campo de combinação usando a tabela a seguir.

   Uma pesquisa de dados ocorre somente 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 combinação

   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 correspondidos.
   Campo da tabela de combinação	Selecione o campo na tabela de correspondência que contém os dados a serem correspondidos. 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 em branco). Desmarcar esta caixa de seleção significa que todos os valores em branco na tabela de correspondência correspondem a qualquer valor. Por exemplo, suponha que o campo Prioridade esteja em branco na tabela de correspondência. Quando esta caixa de seleção é marcada, há uma correspondência somente quando o valor de prioridade está em branco na linha da tabela de origem. Quando esta caixa de seleção está desmarcada, o valor do campo de correspondência em branco 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 em branco 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 definidor

    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.

    Por exemplo, a definição de pesquisa de dados a seguir atribui incidentes ao grupo de problemas VIP com base em Solicitante campo. Além disso, os incidentes são definidos como prioridade crítica ou alta com base no solicitante.

    

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.

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 de KPIs relacionada, clique em Novo.
3. Configure um módulo para a tabela de pesquisa de dados que você criou usando as propriedades a seguir.

   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. Clique em 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 de combinação 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 de formulário para campos somente leitura.
• Verifique se um client script não está alterando o valor de um campo. Os scripts de cliente podem ser acionados 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.