Criar pesquisas de dados personalizados

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 7 min. de leitura
  • Criar pesquisas de dados personalizadas envolve adicionar um valor de pesquisa, criar a definição e ativar a pesquisa de dados.

    Criar uma tabela de pesquisa de dados personalizada

    Crie uma tabela personalizada para armazenar dados de pesquisa.

    A tabela personalizada deve estender a tabela Regras de combinação de pesquisa de dados [dl_matcher]. Por exemplo, esta tabela de pesquisa personalizada armazena informações sobre chamadores VIP e atribuições de incidente.

    Tabela 1. Tabela de pesquisa de dados personalizada
    Campo Valor de amostra
    Rótulo Pesquisa de Chamador VIP
    Nome da tabela u_vip_caller_lookup
    Estende a tabela de base dl_matcher
    Criar novo módulo Verdadeiro
    Adicionar módulo ao menu Política do Sistema

    Adicionar 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 combinação) que produzem um valor de prioridade específico (campo definidor).

    Tabela 2. Tabela de pesquisa
    Campos de combinação Campo definidor
    Impact 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 Configuração da lista.

    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 combinação e definidor
      Campo de combinação Campos definidores
      Solicitante Prioridade Grupo de atribuição
      Beth Anglin 2 Problemas de VIP
      Fred Luddy 1 Problemas de VIP
      Valores de pesquisa personalizada
      Nota:
      Cada linha em uma tabela de pesquisa de dados deve ser exclusiva.

    Criar 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.

    Procedimento

    1. Navegar até Todos > Política do Sistema > Regras > Definições de pesquisa de dados.
    2. Clique em Nova.
    3. Clique em 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 os 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 de tarefas não pode corresponder aos valores na tabela de incidentes Incidente.
      Tabela de combinação Selecione a tabela que contém os valores de pesquisa. Esta tabela sempre deve iniciar com um prefixo u_.
      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 usuário ou client script 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, em seguida, clique em Salvar.
    6. Na lista relacionada Definições de campo de combinação, 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 combinação. A pesquisa de dados usa os valores dos campos da tabela de origem para pesquisar um ou mais valores da tabela de combinação. Observe que a pesquisa de dados não funciona com campos do tipo Registro.

      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 da tabela de origem que contém os dados a serem correspondidos.
      Campo da tabela de combinação Selecione o campo da tabela de combinação que contém os dados a serem correspondidos.
      Correspondência de pesquisa exata

      Marque esta caixa de seleção para exigir que a tabela de combinação 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 combinação. Quando esta caixa de seleção está 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 combinação 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 combinação que contêm valores em branco serão tratadas como caracteres curinga, correspondendo a todos os valores.
    8. Clique em Enviar.
    9. Na lista relacionada Definições de campo definidor, clique em Novo.
    10. Preencha o formulário Definições de campo definidor usando a tabela a seguir.
      Tabela 7. Campos de definições de campo 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 da 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. Clique em Enviar.
    12. Clique em Atualizar.

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

      Definição de pesquisa de dados

    Criar 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é Todos > Definição do Sistema > Menus da aplicaçãoe selecione uma aplicação para 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 necessá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 alterar os 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 um valor de campo. Os Client scripts podem acionar eventos Run on form change mesmo em campos somente leitura.
    • Verifique se os dados na tabela de combinação 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 puder encontrar um valor correspondente.
    • Verifique se você não criou uma regra recursiva, como:

      Se o Campo A = 1, o Campo B = 2. Se o Campo B = 2, então o Campo A = 2