Propriedades de pesquisa contextual

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • As propriedades de pesquisa contextual são usadas para controlar os campos nos quais você pode pesquisar e o número de resultados exibidos por página.

    As propriedades de pesquisa contextual estão disponíveis em Pesquisa contextual > Propriedades.

    Tabela 1. Propriedades da pesquisa contextual
    Rótulo da propriedade Descrição
    Valor padrão para o número máximo de resultados de pesquisa retornados para configurações de produtor de registro e tabela

    [com.snc.contextual_search.result.default.limit]

    Valor padrão para o número máximo de resultados de pesquisa retornados quando você cria uma configuração de tabela ou produtor de registro. Por padrão, o valor é 10.
    Número de caracteres que um campo configurado precisa antes de acionar uma pesquisa

    [com.snc.contextual_search.min_length]

    Número de caracteres que a pesquisa contextual requer antes de acionar uma pesquisa com base no texto inserido no campo de pesquisa. Por padrão, o valor é definido como 3 caracteres.

    Esta propriedade também se aplica à pesquisa da Assistência do agente.

    Número de milissegundos que um campo configurado aguardará antes de acionar uma pesquisa

    [com.snc.contextual_search.wait_time]

    Número de milissegundos que a pesquisa contextual aguarda antes de acionar uma pesquisa com base no texto inserido no campo de pesquisa. Por padrão, o valor é definido como 1 000 milissegundos (um segundo).
    Os registros retornados acima desse limite serão logs de aviso

    [com.snc.contextual_search.result.threshold]

    Aciona uma mensagem de aviso no log do sistema sempre que mais do que esse número de resultados é retornado em uma pesquisa. Este registro em log ajuda se você estiver enfrentando problemas de desempenho devido a pesquisas grandes. Por padrão, o valor é definido como 10 000 resultados.
    Quando uma configuração de formulário for criada, um campo de pesquisa com um nome correspondente a essa propriedade será criado automaticamente

    [com.snc.contextual_search.widget.form.default_field]

    O campo padrão usado para pesquisar quando você cria uma configuração de tabela. Por padrão, o valor é definido como short_description.
    Recolher o widget de resultados de pesquisa ao criar um novo registro em um formulário

    [com.snc.contextual_search.widget.form.open_collapsed_new_records]

    Quando o valor é definido como verdadeiro e você cria um registro, o widget de resultados da pesquisa é recolhido para economizar espaço. Por padrão, o valor é definido como falso.
    Recolher o widget de resultados de pesquisa ao abrir um registro existente em um formulário

    [com.snc.contextual_search.widget.form.open_collapsed_existing_records]

    Quando o valor é definido como verdadeiro e você abre um registro existente, o widget de resultados da pesquisa é recolhido para economizar espaço. Por padrão, o valor é definido como verdadeiro.
    Nota:
    A propriedade se aplica somente a registros existentes e não a novos registros.
    Expandir automaticamente o widget de resultados da pesquisa quando o campo de pesquisa for atualizado em um formulário

    [com.snc.contextual_search.widget.form.expand_on_search_field_update]

    Quando o valor é definido como verdadeiro e você atualiza o campo de pesquisa em um formulário, o widget de resultados de pesquisa expande e executa a pesquisa automaticamente. Por padrão, o valor é definido como verdadeiro.
    Mostrar metadados nos resultados da pesquisa contextual do formulário

    [com.snc.contextual_search.widget.form.show_meta_data]

    Quando o valor é definido como verdadeiro, cada resultado da pesquisa inclui metadados adicionais abaixo de cada registro de resultado. Por padrão, a propriedade está definida como verdadeira.
    • Para artigos de conhecimento, você configura os campos de metadados a serem exibidos modificando as propriedades de pesquisa de conhecimento. Como exemplo, você pode exibir o autor do artigo, o número do artigo e o nome da base de conhecimento. Para obter detalhes sobre as propriedades de pesquisa de Conhecimento, consulte Propriedades da Gestão de conhecimento .
    • Configure os campos de exibição de resultados de pesquisa para outros recursos editando as configurações de exibição de resultados de pesquisa. Para obter detalhes sobre as definições de configuração da exibição de resultados de pesquisa, consulte Edite o registro do campo de exibição do recurso de pesquisa.
    Sempre force um link relacionado na página de IU cxs_new_window.

    [com.snc.contextual_search.cxs_new_window.force_relative_link]

    A propriedade garante que somente links relativos sejam abertos na janela modal de pesquisa contextual. Por padrão, a propriedade está definida como verdadeira.

    Quando o valor é definido como verdadeiro, um link aberto na janela modal de pesquisa contextual é forçado a ser um link relativo.

    Quando o valor é definido como falso, um link relativo ou externo pode ser aberto na janela modal de pesquisa contextual.

    Para revisar esta propriedade na tabela Propriedades do sistema [sys_properties], insira sys_properties.list no filtro de navegação.

    Nota:
    A janela de pesquisa contextual é exibida na IU principal.