---
sourceDocument: Interfaces conversationnelles Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Interfaces conversationnelles Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Utilitaire de recherche

# Utilitaire de recherche {#ariaid-title1}

* Rversion finale: Yokohama
* 
* Mis à jour 6 févr. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

Utilisez l'utilitaire de recherche d'une Agent virtuel rubrique pour renvoyer une requête d'enregistrement ServiceNow .

## Propriétés d'utilitaire de recherche {#va-lookup__section_xwb_mgn_pdb}

{#va-lookup__table_nff_y1b_3db__entry__2}

| Propriété | Description |
|-|-|
| Nom du nœud | Nom qui identifie ce nœud d'utilitaire de recherche dans le flux de rubriques. |
| Nom de variable | La variable qui stocke l'enregistrement renvoyé par le script. Le nom de variable est automatiquement créé à partir de la propriété Node name (Nom du nœud ). |
| Table | La table utilisée pour la requête. |
| Filtrer cette table à l'aide de | Requête de récupération de l'enregistrement. Utilisez le générateur de conditions ou un script pour spécifier une condition de requête. |
| Avancée ||
| Masquer ce nœud ||
| Afficher conditionnellement ce nœud si | Instruction de condition sans code ou script low-code qui spécifie une condition de présentation de ce nœud dans la conversation. La condition doit être évaluée comme vraie. |
[ ]

{#va-lookup__table_nff_y1b_3db}

## Exemple d'utilitaire de recherche {#va-lookup__section_jxd_nh5_tdb}

Figure 1. Propriétés de base de l'utilitaire de recherche

## Exemple de script de recherche {#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)

Dans cet exemple, une table est interrogée pour le premier enregistrement actif. La table à interroger est définie dans la propriété Table trouvée dans le contrôle de l'utilitaire de recherche. La méthode `setLimit()` garantit qu'un seul enregistrement est renvoyé de la base de données. Si un enregistrement est trouvé, il est renvoyé. Pour plus d'informations sur les requêtes GlideRecord, consultez [Interrogation de tables dans un script](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) .