Lookup utility

Use the Lookup utility in a Virtual Agent topic to return a ServiceNow record query.

Lookup utility properties

Property	Description
Node name	The name that identifies this Lookup utility node in the topic flow.
Variable name	The variable that stores the record returned by the script. The variable name is automatically created from the Node name property.
Table	The table used for the query.
Filter this table by using	The query to retrieve the record. Use the condition builder or a script to specify a query condition.
Advanced
Hide this node
Conditionally show this node if	No-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true.

Example Lookup utility

Figure 1. Lookup utility basic properties

Example Lookup script

(function execute(table) {

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

In this example, a table is queried for the first active record. The table to be queried is defined in the Table property found in the lookup utility control. The setLimit() method ensures that only a single record is returned from the database. If a record is found, it is returned. For more information on GlideRecord queries, see Querying tables in script .