---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais do Xanadu

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Utilitário de pesquisa

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

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

Use o utilitário Pesquisa em um tópico Virtual Agent para retornar uma consulta de registro ServiceNow.

## Propriedades do utilitário Pesquisa {#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 Pesquisa no fluxo do tópico. |
| 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. |
| Filtrar esta tabela usando | A consulta para recuperar o registro. Use o Construtor de condições ou um script para especificar uma condição da consulta. |
| Avançado ||
| Ocultar este nó ||
| Mostrar este nó condicionalmente 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}

## Exemplo do utilitário Pesquisa {#va-lookup__section_jxd_nh5_tdb}

Figura 1. Propriedades básicas do utilitário Pesquisa

## Exemplo de script Pesquisa {#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 pelo primeiro registro ativo. A tabela a ser consultada é definida na propriedade Tabela encontrada no controle do utilitário de pesquisa. O método `setLimit()` garante que apenas um único registro seja retornado do banco de dados. Se um registro for encontrado, ele será retornado. Para mais informações sobre consultas GlideRecord, veja [Consultar tabelas no script](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).