Example Lookup utility

Lookup utility properties

Example Lookup script

(function execute(table) {

       var 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 .

Example Script Action utility

Script Action utility properties

Example script action

(function execute() {
    var list = [];
    if (vaInputs.case_number != "") {
        var gr = new GlideRecord("sn_customerservice_case");
        gr.addQuery("number", "CONTAINS", vaInputs.case_number);
        gr.addQuery("active", "true");
        gr.orderBy("number");
        gr.query();
        while (gr.hasNext()) {
            gr.next();
            list.push(gr.getUniqueValue().toString());
        }
    }
    vaVars.case_list = list;
})()

This example performs a search on the sn_customerservice_case table for a specific case number based on the input from another control called case_number. The script then places the results in an array and stores them in the case_list variable, which is accessible by other nodes in the same topic. Because vaVars only supports string, number, and Boolean values, the script uses toString() to store these values as strings. The code is contained in an if statement, so it only executes if the case_number variable has a value. This if statement prevents the code from running if the user has not entered a number.

Example Action utility

Action utility properties

Specify the table for which the record is to be created. To update a record, specify the fields in the record to be modified.

Example Decision utility node with branches

In this example, a static choice control prompts the user to select from three available colors, and the selection is stored in a variable. The Decision utility control is configured with a branch for each possible selection. Each branch contains a script in the Condition property that returns true when a specific color is selected. In the example, the script returns true when the choice is "Blue."

Add a Decision utility with branches

Use scripts or variable conditions to set decision branches

Each branch below a Decision utility node has a condition property. You can define the condition using the condition builder or a script that returns a value of true or false. A branch that returns a value of true is followed, while a branch returning a value of false is not. When creating these scripts or conditions, ensure that only one branch in each Decision utility node evaluates to true.