---
sourceDocument: Yokohama Administração da Now Platform
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-administration

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Administração da Now Platform

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Crie pesquisas de dados personalizadas

# Crie pesquisas de dados personalizadas {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 min. de leitura

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 {#ariaid-title2}

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.  
{#create-custom-data-lookup__table_n5p_l2q_wq__entry__2}

| 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 |
[Tabela 1. Tabela de pesquisa de dados personalizada]

{#create-custom-data-lookup__table_n5p_l2q_wq}

## Adicione um valor de pesquisa de dados à tabela de pesquisa de dados {#ariaid-title3}

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 correspondentes) que produzem um valor de prioridade específico (campo de definição).  
{#t_AddADLValueToTheDataLookupTable__table_yjm_xgq_wq__entry__2}

| 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 |
[Tabela 2. Tabela de pesquisa]

{#t_AddADLValueToTheDataLookupTable__table_yjm_xgq_wq}

### 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.  
   {#t_AddADLValueToTheDataLookupTable__table_xnv_13q_wq__entry__3}

   | 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\] |
   [Tabela 3. Novos campos]

   {#t_AddADLValueToTheDataLookupTable__table_xnv_13q_wq}

   Para obter mais informações, consulte [Configurando listas no Now Platform](https://servicenow-prod.fluidtopics.net/Xn6WNN4Iop9XNEohJbx2Qw "Os usuários com as funções apropriadas podem configurar vários aspectos das listas. As mudanças de configuração se aplicam a todos os usuários.").
3. Na lista de tabela, clique em Novo e insira os valores de campos de combinação e definidor apropriados.  
   Por exemplo:  
   {#t_AddADLValueToTheDataLookupTable__table_gjm_j3q_wq__entry__2}

   | 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 |
   [Tabela 4. Novos valores de campo de combinador e setter]

   {#t_AddADLValueToTheDataLookupTable__table_gjm_j3q_wq}  
   Nota:  
   Cada linha em uma tabela de pesquisa de dados deve ser exclusiva.

## Crie um registro de definição de pesquisa de dados {#ariaid-title4}

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é TudoPolítica do SistemaRegrasDefiniçõ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.  
   {#t_CreateADataLookupDefinRec__table_qcb_2jk_t1b__entry__2}

   | 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 de 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 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. |
   [Tabela 5. Campos de definições de pesquisa de dados]

   {#t_CreateADataLookupDefinRec__table_qcb_2jk_t1b}
5. Clique com o botão direito no cabeçalho do formulário e selecione 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.
   {#t_CreateADataLookupDefinRec__table_avq_1qq_wq__entry__2}

   | 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 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. |
   [Tabela 6. Campos de definições de campo de correspondência]

   {#t_CreateADataLookupDefinRec__table_avq_1qq_wq}
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.  
    {#t_CreateADataLookupDefinRec__table_m2j_yqq_wq__entry__2}

    | 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. |
    [Tabela 7. Campos de definições de campo do setter]

    {#t_CreateADataLookupDefinRec__table_m2j_yqq_wq}
11. Selecione Enviar.
12. Selecione Atualizar.  
    Por exemplo, a definição de pesquisa de dados a seguir atribui incidentes ao grupo de problemas de VIP com base em Solicitante campo. Além disso, os incidentes são definidos como prioridade crítica ou alta com base no chamador.  

## Crie um módulo de pesquisa de dados {#ariaid-title5}

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é TudoDefinição do SistemaMenus 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 seguintes propriedades.  
   {#t_CreateADataLookupModule__table_rxn_bsq_wq__entry__2}

   | 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 |
   [Tabela 8. Propriedades do módulo]

   {#t_CreateADataLookupModule__table_rxn_bsq_wq}
4. Clique em Enviar.
{#t_CreateADataLookupModule__steps_l55_3rq_t1b}

## Solução de problemas de pesquisa de dados {#ariaid-title6}

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 client script 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.

{#troubleshooting-data-lookup__ul_jst_vsq_wq}