Configurações de campo

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

    • Uma configuração de campo controla o comportamento de indexação de um campo especificado (coluna) em todos os registros de uma origem indexada.

    Exemplos de como você pode usar as configurações de campo incluem o seguinte.
    • Desabilitar indexação de texto ou pesquisa para um campo encontrado em registros da tabela de origem
    • Modificar mapeamentos padrão entre campos da tabela de origem e campos no índice Pesquisa com IA
    • Adicionar um campo de tabela referenciado ao índice por referência com pontos a partir de um campo de referência nos registros da tabela de origem

    As configurações de campo de uma origem indexada aparecem na lista relacionada Mapeamento e configurações de campo.

    Criar uma configuração de campo para uma origem indexada

    Defina uma configuração de campo de origem indexada para configurar o comportamento de indexação de conteúdo Pesquisa com IA para um campo específico nos registros da tabela de origem.

    Antes de Iniciar

    Função necessária: ais_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Para obter detalhes sobre as configurações e valores de campos disponíveis, consulte Lista de Pesquisa com IA configurações do campo de origem indexado.

    Procedimento

    1. Navegar até Todos > Pesquisa com IA > Pesquisa com IA Índice > Origens indexadas.
    2. Abra a origem indexada para a qual você deseja definir uma configuração de campo.
    3. Na lista relacionada Mapeamento e configurações de campo, selecione Novo.
    4. No formulário Configuração de campo, preencha os campos.
    5. Selecione Enviar.

    Resultado

    A nova configuração de campo aparece na lista relacionada Mapeamento e configurações de campo.

    O que Fazer Depois

    Para que a nova configuração de campo tenha efeito, execute uma reindexação de tabela completa para a origem indexada. Para obter detalhes sobre este procedimento, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.

    Habilitar indexação de campos de tabela referenciados para uma origem indexada

    Configure uma origem indexada para indexar valores de campo de tabelas referenciadas por campos na tabela de origem. Você pode indexar esses valores de campo para uso em filtros e configurações de resultado de pesquisa EVAM, indexá-los para pesquisa ou ambos.

    Antes de Iniciar

    Função necessária: ais_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Quando uma tabela de origem indexada inclui um campo de referência, Pesquisa com IA assume como padrão valores de indexação para o campo de referência, mas não para outros campos na tabela à qual ele faz referência. Para indexar valores desses campos de tabela referenciados, você pode criar configurações de campo dot_walk_fields e searchable_dot_walk_fields em sua tabela de origem indexada.
    • Para usar valores de campos de tabelas referenciadas em filtros de origem de pesquisa, filtros de aspecto e configurações de resultado de pesquisa de EVAM, crie uma configuração de campo dot_walk_fields.
    • Para tornar os valores de campos das tabelas referenciadas pesquisáveis, crie uma configuração de campo searchable_dot_walk_fields.

    Como o valor para qualquer uma dessas configurações de campo, liste os nomes dos campos da tabela referenciados que você deseja indexar, separados por vírgulas. Por exemplo, para indexar os campos de nome e cliente da tabela referenciada pelo campo da empresa na tabela de origem indexada, selecione o campo da empresa e insira o valor name,customer.

    Para fazer referência com pontos em várias tabelas, você pode inserir valores de nome de campo com prefixos de campo de referência separados por pontos. Por exemplo, insira o valor company.contact.name para indexar o campo de nome na tabela referenciada pelo campo de contato na tabela referenciada pelo campo de referência da empresa da tabela de origem indexada.
    Nota:
    Cada nível de referência de referência com pontos impõe um impacto no desempenho na indexação. Evite usar referências de vários níveis, a menos que seja necessário.

    Você pode criar configurações de campo dot_walk_fields e searchable_dot_walk_fields para o mesmo campo de referência.

    Procedimento

    1. Navegar até Todos > Pesquisa com IA > Pesquisa com IA Índice > Origens indexadas.
    2. Na lista relacionada Mapeamento e configurações de campo, selecione Novo.
    3. No formulário Configuração de campo, insira os valores de campo mostrados para o seu caso de uso.
      • Para indexar valores de campo de tabelas referenciadas para uso em filtros de origem de pesquisa, filtros de aspecto e configurações de resultado de pesquisa EVAM, insira os seguintes valores de campo.
        Campo Valor
        Atributo dot_walk_fields
        Campo <name of indexed source table reference field that you want to use to dot-walk to another table>
        Valor

        <comma-separated list of names for fields that you want to index from the referenced table>
      • Para indexar valores de campo de tabelas referenciadas como texto pesquisável, insira os seguintes valores de campo.
        Campo Valor
        Atributo searchable_dot_walk_fields
        Campo <name of indexed source table reference field that you want to use to dot-walk to another table>
        Valor

        <comma-separated list of names for fields that you want to index from the referenced table>
      Nota:
      Se os atributos dot_walk_fields e searchable_dot_walk_fields não forem exibidos na lista de seleção de atributo, certifique-se de que sua seleção de campo seja um campo de referência.
    4. Selecione Enviar.
      O atributo e o valor aparecem na lista relacionada Mapeamento e configurações de campo.

    Lista de Pesquisa com IA configurações do campo de origem indexado

    Você pode ajustar o comportamento de indexação para campos de registro de origem em uma origem indexada Pesquisa com IA configurando atributos e valores de definição de campo.

    Para obter mais informações sobre como criar configurações de campo, consulte Criar uma configuração de campo para uma origem indexada.

    Atributo Descrição
    dot_walk_fields

    Indexe a referência e exiba valores de campos na tabela de origem do campo de referência selecionado para uso em filtros de origem de pesquisa, filtros de aspecto e EVAM configurações de resultado de pesquisa.

    Pesquisa com IA atualiza automaticamente os valores de campos indexados para refletir as mudanças feitas nos valores de campos da tabela referenciada.

    Para obter mais informações sobre filtros de origem de pesquisa, consulte Pesquisar fontes. Para obter detalhes sobre filtros de aspecto, consulte Criar um aspecto em uma configuração da aplicação Pesquisa com IA.
    • Campo: nome de um campo de referência da tabela de origem indexada.
    • Tipo: cadeia de caracteres
    • Valor: lista separada por vírgulas de campos de tabela referenciados a serem indexados para uso em origens de pesquisa
    Nota:
    Você não pode pesquisar valores de campo indexados com esta configuração de campo. Para indexar valores de campo de tabelas referenciadas para pesquisa, crie uma configuração de campo searchable_dot_walk_fields. Você pode criar configurações de campo dot_walk_fields e searchable_dot_walk_fields para o mesmo campo de referência.

    Se você mudar o valor dessa configuração para o campo de uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    index_calculated_field

    Opção para habilitar a indexação de conteúdo pesquisável a partir de valores de campos calculados.

    Se a sua origem indexada contiver um campo calculado, você precisará definir esta configuração de campo como verdadeira para esse campo para indexar corretamente seus valores. Com um valor de configuração de campo falso ou nenhum valor, Pesquisa com IA ignora os valores do campo calculado ao indexar conteúdo.
    • Campo: nome de um campo calculado da tabela de origem indexada. (Se você especificar um campo não calculado, o sistema rejeitará o envio da configuração do campo e exibirá uma mensagem de aviso.)
    • Tipo: booleano
    • Valores:
      • true: aplique tratamento especial para indexar corretamente os valores de campos calculados do campo selecionado.
      • false: não aplique tratamento especial ao indexar valores de campos do campo selecionado. Os valores de campos calculados não são indexados.

    Se você mudar o valor dessa configuração para o campo de uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    map_to

    Mapeie o campo selecionado da tabela de origem indexada para um campo de índice Pesquisa com IA. Ao indexar registros da tabela de origem, Pesquisa com IA preenche o campo de índice especificado com o valor do campo de origem selecionado.

    Por exemplo, a origem indexada da tabela de conhecimento do sistema de base mapeia o campo de origem kb_knowledge.short_description para o campo de índice de título. Quando Pesquisa com IA indexa um registro da tabela Conhecimento [kb_knowledge], ele preenche o título pesquisável do registro indexado com o valor do campo short_description do registro de origem.
    • Campo: nome de um campo da tabela de origem indexada.
    • Tipo: cadeia de caracteres
    • Valor: nome do campo Pesquisa com IA para o qual você deseja mapear os valores de exibição do campo selecionado. Para obter detalhes sobre Pesquisa com IA campos de índice, consulte Pesquisa com IA campos de índice.
    Nota:
    Você só pode definir uma configuração de campo map_to para um campo de origem indexado. Se você tentar definir várias configurações de map_to para o mesmo campo, o sistema exibirá uma mensagem de erro.

    Se você mudar o valor dessa configuração para o campo de uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    sem_índice_de_texto
    Opção para desabilitar a indexação de conteúdo pesquisável do campo selecionado em registros da origem indexada.
    • Campo: nome de um campo da tabela de origem indexada.
    • Tipo: booleano
    • Valores:
      • true: desabilitar a indexação de conteúdo pesquisável para o campo selecionado. A pesquisa e os filtros não podem corresponder ao valor do campo.
      • false: habilitar a indexação de conteúdo pesquisável para o campo selecionado. A pesquisa e os filtros podem corresponder ao valor do campo.
    • Valor padrão: false

    Se você mudar o valor dessa configuração para o campo de uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.

    Para obter as diretrizes Suporte e atendimento ao cliente sobre como definir a opção no_text_index para diferentes tipos de campo, consulte KB0859922 no site Now Support.
    não_pesquisável
    Opção para desabilitar a correspondência de pesquisa para o conteúdo indexado do campo selecionado.
    • Campo: nome de um campo da tabela de origem indexada.
    • Tipo: booleano
    • Valores:
      • true: desabilitar correspondência de pesquisa para conteúdo indexado do campo selecionado. A pesquisa não pode corresponder ao valor do campo. Filtros (como para segurança de conteúdo, guias de navegação e aspectos) ainda podem corresponder ao valor do campo.
      • false: habilitar correspondência de pesquisa para conteúdo indexado do campo selecionado. A pesquisa e os filtros podem corresponder ao valor do campo.
    • Valor padrão: false
    Valores compatíveis:

    Se você mudar o valor dessa configuração para o campo de uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    searchable_dot_walk_fields

    Indexe a referência e exiba valores de campos na tabela de origem do campo de referência selecionado como texto pesquisável.

    Pesquisa com IA O não atualiza automaticamente os valores de campos indexados para refletir as mudanças feitas nos valores de campos da tabela referenciada. Para atualizar os valores de campos indexados, você deve reindexar a origem indexada. Para obter detalhes sobre este procedimento, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    • Campo: nome de um campo de referência da tabela de origem indexada.
    • Tipo: cadeia de caracteres
    • Valor: lista separada por vírgulas de campos de tabela referenciados a serem indexados como conteúdo pesquisável
    Nota:
    Você não pode usar valores de campo indexados com esta configuração de campo em filtros de origem de pesquisa. Para indexar valores de campo de tabelas referenciadas para uso em filtros de origem de pesquisa, crie uma configuração de campo dot_walk_fields. Você pode criar configurações de campo dot_walk_fields e searchable_dot_walk_fields para o mesmo campo de referência.

    Se você mudar o valor dessa configuração para o campo de uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    Nota:
    As configurações de campo são registros na tabela Atributo de configuração da Pesquisa com IA [ais_configuration_attribute] que têm Coluna como o valor do campo Aplica-se a. Os registros nesta tabela que têm Tabela como o valor do campo Aplica-se a são Atributos de origem indexados.

    Este exemplo mostra como a origem indexada da Tabela de itens do catálogo do sistema de base mapeia valores do campo short_description da tabela Item do catálogo [sc_cat_item] para o campo de texto do índice Pesquisa com IA para registros indexados.


    Pesquisa com IA Formulário de configuração de campo mostrando o Item do catálogo de origem [sc_cat_item], o atributomap_to, o camposhort_descriptione otextode valor.

    Segurança para valores de campo de tabela referenciada pesquisável

    Quando um usuário pesquisa valores de campo da tabela referenciada que você indexou para pesquisa com a configuração de campo searchable_dot_walk_fields, somente os valores de campo que o usuário pode exibir aparecem nos resultados da pesquisa. O sistema usa as regras da lista de controle de acesso (ACLs) baseadas em função de um valor de campo para determinar se o usuário de pesquisa pode exibir esse valor de campo.

    Os valores de campo da tabela referenciada pesquisável que têm ACLs baseadas em condição ou em script ou critérios do usuário não aparecem nos resultados da pesquisa.

    Para valores de campos pesquisáveis indexados por meio de vários níveis de referência de referência com pontos, o sistema considera somente ACLs baseadas em função no valor do campo final. Por exemplo, se você indexar valores de campo da tabela referenciada company.contact.name para pesquisa, o acesso do usuário aos valores de campo de nome não será afetado por ACLs baseadas em função nos valores de campo de contato.

    Para ignorar todas as ACLs e permitir que os usuários pesquisem todos os valores de campos da tabela referenciados pesquisáveis, você pode definir a propriedade do sistema glide.ais.query.allow_indexlookup_for_dotwalk como verdadeira. Isso ignora a avaliação da ACL para valores de campo indexados por meio das configurações de campo dot_walk_fields e searchable_dot_walk_fields.

    Para obter mais detalhes sobre tipos e configuração de ACL, consulte Regras da lista de controle de acesso.