---
sourceDocument: Interfaces conversacionais de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais de Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Utilitário de pesquisa

# Utilitário de pesquisa {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 6 de fev. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Use o utilitário de pesquisa em um Virtual Agenttópico para retornar um ServiceNowconsulta de registro.

## Pesquisar propriedades do utilitário {#va-lookup__section_xwb_mgn_pdb}

{#va-lookup__table_nff_y1b_3db__entry__2}

| Propriedade | Descrição |
|-|-|
| Nome do nó | O nome que identifica este nó do utilitário de pesquisa no fluxo de tópicos. |
| Nome da variável | A variável que armazena o registro retornado pelo script. O nome da variável é automaticamente criado a partir da propriedade Nome do nó. |
| Tabela | A tabela usada para a consulta. |
| Filtre esta tabela usando | A consulta para recuperar o registro. Use o construtor de condições ou um script para especificar uma condição de consulta. |
| Avançado ||
| Ocultar este nó ||
| Mostrar condicionalmente este nó se | Uma declaração de condição sem código ou script de baixo código que especifica uma condição para apresentar este nó na conversa. A condição deve ser avaliada como verdadeira. |
[ ]

{#va-lookup__table_nff_y1b_3db}

## Utilitário de pesquisa de exemplo {#va-lookup__section_jxd_nh5_tdb}

Figura 1. Propriedades básicas do utilitário de pesquisa

## Script de pesquisa de exemplo {#va-lookup__section_xzk_f3n_vdb}

    (function execute(table) {

           var now_GR = new GlideRecord(table);
           gr.addEncodedQuery('active=true');
           gr.setLimit(1);
           gr.query();
           if(gr.next()) {
              return gr;
        }
    })(table)

Neste exemplo, uma tabela é consultada para o primeiro registro ativo. A tabela a ser consultada é definida em Tabela propriedade encontrada no controle do utilitário de pesquisa. . `SetLimit() `o método garante que somente um único registro seja retornado do banco de dados. Se um registro for encontrado, ele será retornado. Para obter mais informações sobre consultas GlideRecord, consulte [Consultando tabelas no script](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).