Configurar um grupo de índice de texto para pesquisar em várias tabelas

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 6 min. de leitura

    • Atualize tabelas para o formato de indexação V4 e inclua-as em um grupo de índice de texto para facilitar a pesquisa em várias tabelas.

    Antes de Iniciar

    Função necessária: ts_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    Os grupos de índice de texto permitem indexar e pesquisar em várias tabelas.

    A execução de pesquisas em várias tabelas requer a normalização das tabelas primeiro para que as pontuações de relevância tenham o mesmo significado para todas as tabelas. A indexação V4 fornece essa normalização. O Zing usa a função de classificação Okapi BM25 para calcular a pontuação de relevância dos resultados da pesquisa.

    O formato de indexação de tabela V4 é otimizado para documentação, como artigos da base de conhecimento. Você não precisa reindexar tabelas que usam este formato ao alterar o valor de um atributo de indexação, como o peso de um campo. Se você quiser usar a função de classificação BM25 em uma única tabela, poderá convertê-la para o formato V4.

    Para habilitar a pesquisa em várias tabelas:
    1. Configure todas as tabelas escolhidas para usar o formato de índice V4, caso ainda não o usem.
      Nota:
      Em novas instâncias, as tabelas Item do catálogo [sc_cat_item], Conhecimento [kb_knowledge], Perguntas e respostas da comunidade [kb_social_qa_question] e Usuário [sys_user] usam o formato de índice V4. Se você fizer upgrade da sua instância de uma versão anterior, o formato de indexação dessas tabelas permanecerá o mesmo da versão mais antiga.
    2. Adicione as tabelas a um grupo de índice de texto para que elas possam ser indexadas e pesquisadas juntas.
      Nota:
      Você não pode adicionar a tabela Tarefa [task] ou tabelas que a estendam para um grupo de índice de texto.

    Procedimento

    1. Configure as tabelas que você deseja incluir em várias pesquisas de tabela para usar o formato de índice V4.
      Nota:
      Fazer upgrade da V3 para a V4 é fácil. O downgrade de V4 para V3 é mais difícil e não é recomendado.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro da tabela que você deseja fazer upgrade para o formato de índice V4.
      3. Se Formatar não estiver desabilitado, selecione V4, selecione Enviare pule para a etapa 2.
        Você pode escolher a formatação de índice nesta etapa porque não existe nenhum índice para a tabela.
      4. Se Formato estiver desabilitado, selecione o link relacionado Mostrar registro de nome de índice.
        O campo desabilitado significa que já existe um índice para a tabela e você deve atualizar explicitamente o formato do índice.
        A página Índice de texto é exibida.
      5. Selecione o link relacionado Fazer upgrade para V4 e selecione OK.
        O sistema programa uma tarefa para fazer upgrade do índice de texto de V3 para V4, permitindo que esta tabela participe da indexação de várias tabelas.
    2. Crie um grupo de índice de texto que especifica as tabelas que você deseja indexar juntas para que você possa pesquisá-las juntas.
      1. Navegar até Todos > Definição do Sistema > Grupos de Índice de Texto.
      2. Selecione Novo.
      3. Insira os seguintes valores de campo:
        Campo Valor
        Rótulo Nome do grupo de tabelas que você deseja indexar e pesquisar juntos.
        Tabelas Lista de tabelas que você deseja incluir no grupo de índice de texto.

        Você pode adicionar tabelas formatadas com V3 e V4 a grupos de índice de texto. Se você adicionar tabelas V3, o grupo de índice de texto permanecerá inativo.

      4. Selecione Enviar.
    3. Configure os atributos de indexação e pesquisa em tabelas em um grupo de índice de texto.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Selecione Novo.
        O formulário de configuração do índice de texto é exibido. Se você já tiver um grupo de índice de texto na lista, pule para a etapa 3.d.
      3. Em Aplica-se a, selecione Grupo de índice.
      4. Em Grupo de índice, selecione a lupa e selecione o grupo de índice de texto que você criou e selecione Enviar.
        Os únicos grupos de índice de texto exibidos são aqueles que você já criou.
        A tabela Configuração do índice de texto é exibida.
      5. Abra o registro do seu grupo de índice de texto.
      6. Na guia Mapas de atributo da tabela de índice de texto, selecione Novo.
        O formulário Mapa de atributos da tabela de índice de texto é exibido. Os atributos pertencem à forma como o Zing indexa ou pesquisa tabelas individuais no grupo de índice de texto.
      7. Em Tabela, selecione uma tabela para a qual definir atributos.
        Somente tabelas no grupo de índice de texto especificado e suas tabelas secundárias são exibidas.
      8. Em Nome do atributo, selecione a lupa e selecione um atributo.
        Para ver a lista de atributos, insira ts_configuration_attribute.list no navegador de aplicações. Para obter definições de atributo, consulte Índice do Zing e atributos de pesquisa.
      9. Em Valor, insira um valor e selecione Enviar.
        Valores válidos dependem do atributo. Para obter informações sobre valores válidos, consulte Índice do Zing e atributos de pesquisa.
      10. Repita este procedimento para definir parâmetros adicionais do mecanismo de pesquisa para outras tabelas no grupo de índice de texto.
      11. Em Links relacionados, selecione Gerar índice de texto.
    4. Configure parâmetros de pesquisa em colunas de tabela individuais no grupo de índice de texto.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro do seu grupo de índice de texto.
      3. Na guia Mapas de atributo da coluna de índice de texto, selecione Novo.
        O formulário Mapa de atributos da coluna de índice de texto é exibido. Os atributos pertencem à maneira como o Zing indexa ou pesquisa colunas de tabelas individuais no grupo de índice de texto.
      4. Em Tabela, selecione uma tabela para a qual definir atributos.
        Somente tabelas no grupo de índice de texto e suas tabelas secundárias são exibidas.
      5. Em Nome do atributo, selecione um parâmetro de mecanismo de pesquisa, insira um valor para esse parâmetro em Valore selecione Enviar.
        Para ver a lista de atributos, insira ts_configuration_attribute.list no navegador de aplicações. Para obter definições de atributo, consulte Índice do Zing e atributos de pesquisa.
      6. Em Coluna, especifique o nome da coluna na tabela selecionada à qual você deseja aplicar o atributo de pesquisa.
      7. Em Valor, especifique o valor do atributo que rege a pesquisa.
      8. Selecione Enviar.
      9. Repita este procedimento para definir parâmetros adicionais do mecanismo de pesquisa para colunas da tabela no grupo de índice de texto.
      10. Em Links relacionados, selecione Gerar índice de texto.
    5. Opcional: Adicione um dicionário de sinônimos.
      A especificação de um dicionário permite pesquisas no termo de pesquisa e nos sinônimos do termo de pesquisa, como car e seu sinônimo auto. O Zing fornece um dicionário de sinônimos padrão.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro do seu grupo de índice de texto.
      3. Na guia Dicionários de sinônimos do índice, selecione Novo.
      4. Em Índice, selecione o índice da tabela ao qual as palavras irrelevantes serão adicionadas.
      5. Em Dicionário de sinônimos, selecione o dicionário a ser usado.
        Para adicionar um dicionário, selecione Novo e siga o procedimento em Criar dicionários de sinônimos.
      6. Selecione Enviar.
      7. Em Links relacionados, selecione Gerar índice de texto.
    6. Selecione Atualizar.

    O que Fazer Depois

    Você pode consultar as tabelas no grupo de índice de texto em busca de correspondências de cadeia de caracteres usando os métodos GlideRecord.addQuery(name, value) ou GlideRecord.addEncodedQuery(name, value) com o nome reservado 123TEXTINDEXGROUP321. Para obter mais informações sobre como consultar grupos de índice de texto para correspondências de cadeia de caracteres, consulte Consulta de tabelas em script.