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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura

    • Atualize as 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 realização de pesquisas em várias tabelas requer a normalização das tabelas primeiro, para que as pontuações de relevância tenham a mesma razão para todas as tabelas. A indexação V4 fornece essa normalização. O Zing usa o. Okapi BM25 função de classificação para calcular a pontuação de relevância dos resultados da pesquisa.

    O formato de indexação da tabela V4 é otimizado para documentação, como artigos da base de conhecimento. Você não precisa reindexar tabelas que usam este formato quando altera 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, você:
    1. Configure todas as tabelas escolhidas para usar o formato de índice V4 se elas ainda não o usarem.
      Nota:
      Em novas instâncias, as tabelas Item do catálogo [sc_cat_item], Conhecimento [kb_knowledge], Perguntas de perguntas e Respostas sociais [kb_social_qa_question] e Usuário [sys_user] usam o formato de índice V4. Se você fizer upgrade da 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 estendem a 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:
      Atualizar da V3 para V4 é fácil. O downgrade de V4 para V3 é mais difícil e desencorajado.
      1. Navegar até Tudo > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro da tabela que você deseja atualizar para o formato de índice V4.
      3. Se Formato não está desabilitado, selecione V4 , selecione Enviar e pule para a etapa 2.
        Você pode escolher a formatação de índice nesta etapa porque não existe índice para a tabela.
      4. Se Formato estiver desabilitado, selecione Mostrar registro de nome de índice link relacionado.
        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 Upgrade para V4 link relacionado e selecione OK .
        O sistema agenda uma tarefa para atualizar o í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 especifique as tabelas que você deseja indexar juntas para que você possa pesquisá-las juntas.
      1. Navegar até Tudo > 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é Tudo > 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 o grupo de índice de texto que você criou e selecione Enviar .
        Os únicos grupos de índice de texto exibidos são os 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. Em Mapas de atributos da tabela de índice de texto , selecione Novo .
        O formulário Mapa de atributos da tabela de índice de texto é exibido. Os atributos pertencem à maneira como o Zing indexa ou pesquisa tabelas individuais no grupo de índice de texto.
      7. Em Tabela , selecione uma tabela para definir atributos.
        São exibidas somente tabelas no grupo de índice de texto especificado e suas tabelas secundárias.
      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 Zing índice e atributos de pesquisa .
      9. Em Valor insira um valor e selecione Enviar .
        Os valores válidos dependem do atributo. Para obter informações sobre valores válidos, consulte Zing índice 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é Tudo > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro do seu grupo de índice de texto.
      3. Em Mapas de atributos 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 tabela individuais no grupo de índice de texto.
      4. Em Tabela , selecione uma tabela para definir atributos.
        São exibidas somente tabelas no grupo de índice de texto e suas tabelas secundárias.
      5. Em Nome do atributo , selecione um parâmetro de mecanismo de pesquisa e insira um valor para esse parâmetro em Valor e 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 Zing índice 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 sobre o termo de pesquisa e sinônimos do termo de pesquisa, como carro e seu sinônimo automático . Zing fornece um dicionário de sinônimos padrão.
      1. Navegar até Tudo > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro do seu grupo de índice de texto.
      3. Em Dicionários de sinônimos de índice , selecione Novo .
      4. Em Índice , selecione o índice da tabela ao qual adicionar as palavras irrelevantes.
      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 GlideRecord.addQuery(nome, valor) ou GlideRecord.addEncodedQuery(nome, valor) métodos com 123TEXTINDEXGROUP321 nome reservado. Para obter mais informações sobre consultar grupos de índice de texto para correspondências de cadeia de caracteres, consulte Consultando tabelas no script .