---
sourceDocument: Brazil API Reference
sourceDocumentLink: https://www.servicenow.com/docs/r/api-reference

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MobileGlideRecord - Scoped

# MobileGlideRecord - Scoped {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 minutes to read  
The MobileGlideRecord API provides the subset of GlideRecord available to mobile scripts, for querying and updating records through the mobile scripting environment.

Unlike a server-side GlideRecord, which doesn't enforce access controls, this class enforces read, write, and
execute access checks on every field access. A field that the current user doesn't have permission to read returns an empty value. This behavior matches the data synced to the device, which is filtered by access controls before it
reaches the user, so a script returns the same result wherever it's evaluated. Records can be filtered with an encoded query, which supports a subset of the available operators. For the supported operators, see documentation for the
addEncodedQuery() method.

Whether a script that calls this API is evaluated on the instance or on the device depends on how the component that runs the script is configured. The methods in this class are available in both cases: the mobile client provides its
own implementation of the same API surface, so the same script returns the same result in either context. Typical calling contexts include a condition script on a mobile button (sys_sg_button) and an
execution script on a write-back action item or step.
This API contains the following capabilities:

* Creating a MobileGlideRecord object: [MobileGlideRecord - MobileGlideRecord(String tableName)](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-MobileGlideRecord_S "Creates an instance of the MobileGlideRecord class for the specified table. Use the new instance to query, read, insert, update, or delete records in that table.")
* Querying records: [MobileGlideRecord - addEncodedQuery(String query)](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-addEncodedQuery_S "Adds an encoded query to filter the records that the query returns. Only the operators listed in the following table are supported. Field-level access controls apply to the fields used in the query conditions."), [MobileGlideRecord - query()](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-query "Runs the query, including any conditions added with addEncodedQuery(), and loads the matching records into the result set. Call next() to read each record."), [MobileGlideRecord - next()](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-next "Moves to the next record in the result set so a script can read its fields. Returns false when no records remain."), [MobileGlideRecord - get(String sysId)](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-get_S "Loads a single record by its sys_id. If the record is found, the MobileGlideRecord points to it and a script can read its fields.")
* Reading field values: [MobileGlideRecord - getValue(String field)](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-getValue_S "Gets the internal value of a field on the current record, as a string."), [MobileGlideRecord - getElement(String field)](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-getElement_S "Gets the MobileGlideElement for a field, so a script can call element methods such as getDisplayValue(). Reading a field with the dot operator, such as gr.priority, does the same thing.")
* Creating and updating records: [MobileGlideRecord - initialize()](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-initialize "Creates a new, empty record with the table's default values, ready for a script to set field values and insert."), [MobileGlideRecord - setValue(String field, String value)](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-setValue_S_S "Sets the value of a field on the current record. The change is not saved until the script calls update() or insert()."), [MobileGlideRecord - insert()](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-insert "Inserts the new record into the table and returns its sys_id. Call initialize() and setValue() first to define the record."), [MobileGlideRecord - update()](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-update "Saves the changes made to the current record.")
* Deleting records: [MobileGlideRecord - deleteRecord()](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-deleteRecord "Deletes the current record, which is the record loaded by get() or advanced to by next().")

## API access {#MobileGlideRecordScopedAPI__section_frq_2rp_lkc}

This API is registered in the sn_mobile_scripting application scope and requires the mobile_admin role. It requires the
com.glide.sg.mobile_scripting plugin, which is enabled by default. The class has a public constructor, [MobileGlideRecord - MobileGlideRecord(String tableName)](https://www.servicenow.com/docs/4ZK0Lnx5ps5Dc3iVcod09w#MGR-MobileGlideRecord_S "Creates an instance of the MobileGlideRecord class for the specified table. Use the new instance to query, read, insert, update, or delete records in that table.").

## MobileGlideRecord - MobileGlideRecord(String tableName) {#ariaid-title2}

Creates an instance of the MobileGlideRecord class for the specified table. Use the new instance to query, read, insert, update, or delete records in that table.
{#MGR-MobileGlideRecord_S__table_MGR-MobileGlideRecord_S_p__entry__3}

| Name | Type | Description |
|-|-|-|
| tableName | String | Name of the table to query or update, such as `wm_task`. |
[Table 1. Parameters]

{#MGR-MobileGlideRecord_S__table_MGR-MobileGlideRecord_S_p}  
This example creates a MobileGlideRecord for the wm_task table.

    var gr = new MobileGlideRecord('wm_task');

This example defines a helper function that counts the active records in any table, using a table name that the caller passes in.

    function countActive(tableName) {
            var gr = new MobileGlideRecord(tableName);
            gr.addEncodedQuery('active=true');
            gr.query();
            var count = 0;
            while (gr.next()) {
            count++;
            }
            return count;
            }
            
            mgs.info('Active tasks: ' + countActive('wm_task'));

Output:

    Active tasks: 2

## MobileGlideRecord - addEncodedQuery(String query) {#ariaid-title3}

Adds an encoded query to filter the records that the query returns. Only the operators listed in the following table are supported. Field-level access controls apply to the fields used in the query conditions.
{#MGR-addEncodedQuery_S__table_MobileGlideRecord-encoded-query-operators__entry__3}

| Operator | Description | Incident encoded query example |
|-|-|-|
| `^` | (AND) Combines multiple conditions so that all conditions must be true for an incident to be returned. This is the default logical operator between conditions in an encoded query. Conditions are evaluated together as a logical AND. | `state=1^priority=2` |
| `^OR` | (OR) Combines conditions so that at least one of the conditions must be true. Useful when matching alternative states or fields. OR conditions are evaluated at the same query level unless they're grouped explicitly. | `state=1^ORstate=2` |
| `!=` | Returns incidents where the field value is different from the provided value. Records with empty values are also returned unless they're explicitly filtered. | `state!=7` |
| `<` | Returns incidents where the numeric or date field value is less than the specified value. | `priority<3` |
| `<=` | Returns incidents where the numeric or date field value is less than or equal to the specified value. | `priority<=2` |
| `>` | Returns incidents where the numeric or date field value is greater than the specified value. | `priority>2` |
| `>=` | Returns incidents where the numeric or date field value is greater than or equal to the specified value. | `priority>=4` |
| `LT_FIELD` | Compares two fields on the same incident record and returns records where the first field is earlier or smaller than the second field. | `resolved_atLT_FIELDopened_at` |
| `LT_OR_EQUALS_FIELD` | Same as `LT_FIELD`, but also includes records where both field values are equal. | `closed_atLT_OR_EQUALS_FIELDresolved_at` |
| `GT_FIELD` | Returns incidents where the first field value is greater or later than the second field value. | `resolved_atGT_FIELDopened_at` |
| `GT_OR_EQUALS_FIELD` | Returns incidents where the first field value is greater than or equal to the second field value. | `sys_updated_onGT_OR_EQUALS_FIELDsys_created_on` |
| `BETWEEN` | Returns incidents where the field value falls within the specified inclusive range. Commonly used for numeric priority ranges or date ranges. | `priorityBETWEEN2@4` |
| `ISEMPTY` | Returns incidents where the field has no value at all, including null references. | `assigned_toISEMPTY` |
| `ISNOTEMPTY` | Returns incidents where the field contains any value. | `assigned_toISNOTEMPTY` |
| `ISEMPTYSTRING` | Returns incidents where the field value is an empty string rather than null. Applies mainly to string fields. | `short_descriptionISEMPTYSTRING` |
| `LIKE` | Performs a case-insensitive partial match using wildcard logic. Returns incidents where the field contains the specified pattern. | `short_descriptionLIKEemail` |
| `NOT LIKE` | Excludes incidents where the field matches the provided pattern. | `short_descriptionNOT LIKEtest` |
| `CONTAINS` | Similar to `LIKE`, but explicitly expresses substring containment for readability. | `descriptionCONTAINSnetwork` |
| `DOES NOT CONTAIN` | Returns incidents where the field doesn't include the specified substring. | `descriptionDOES NOT CONTAINwifi` |
| `STARTSWITH` | Returns incidents where the field value begins with the specified string. Often used with incident numbers. | `numberSTARTSWITHINC` |
| `ENDSWITH` | Returns incidents where the field value ends with the specified string. | `caller_id.emailENDSWITH@company.com` |
| `IN_FIELD` | Compares two fields and returns incidents where the value of the first field exists within the value set of the second field. | `assigned_toIN_FIELDwatch_list` |
| `IN` | Returns incidents where the field value matches one of the provided values in a comma-separated list. | `stateIN1,2,3` |
| `NOT IN` | Returns incidents where the field value doesn't match any value in the provided list. | `priorityNOT IN1,5` |
| `ON` | Returns incidents where a date or date-time field falls on a specific calendar day. | `sys_created_onON2025-01-10` |
| `NOTON` | Excludes incidents created or updated on a specific calendar day. | `sys_created_onNOTON2025-01-10` |
| `SAMEAS` | Returns incidents where the values of two fields are identical. Often used for reference comparisons. | `assigned_toSAMEASopened_by` |
| `NSAMEAS` | Returns incidents where the values of two fields are different. | `assigned_toNSAMEASopened_by` |
| `MORETHAN` | Compares duration or numeric fields and returns incidents where the first field is greater than the second field. | `calendar_durationMORETHANbusiness_duration` |
| `LESSTHAN` | Compares duration or numeric fields and returns incidents where the first field is less than the second field. | `calendar_durationLESSTHANbusiness_duration` |
| `RELATIVEGT` | Returns incidents where the date field is later than a relative time expression, such as greater than one day ago. | `sys_created_onRELATIVEGT@day@ago@1` |
| `RELATIVEGE` | Same as `RELATIVEGT`, but also includes values equal to the relative time threshold. | `sys_updated_onRELATIVEGE@hour@ago@24` |
| `RELATIVELT` | Returns incidents where the date field is earlier than a relative time expression. | `sys_created_onRELATIVELT@day@ago@7` |
| `RELATIVELE` | Returns incidents where the date field is earlier than or equal to the relative time expression. | `sys_updated_onRELATIVELE@minute@ago@30` |
| `RELATIVEEE` | Returns incidents where the date field exactly matches the relative time expression. | `sys_created_onRELATIVEEE@day@ago@0` |
| `MATCH_RGX_FIELD` | Matches the target field against a regular expression stored in another field. | `short_descriptionMATCH_RGX_FIELDu_regex_pattern` |
| `MATCH_RGX` | Applies a regular expression directly to the field value. | `short_descriptionMATCH_RGX^INC[0-9]+` |
| `VALCHANGES` | Returns incidents where the specified field has changed at any point in its update history. | `stateVALCHANGES` |
| `DYNAMIC` | Uses a ServiceNow dynamic filter that resolves at run time, such as the current user. | `assigned_toDYNAMICme` |
[Table 2. Encoded query operators supported for MobileGlideRecord in mobile scripts]

{#MGR-addEncodedQuery_S__table_MobileGlideRecord-encoded-query-operators} {#MGR-addEncodedQuery_S__table_MGR-addEncodedQuery_S_p__entry__3}

| Name | Type | Description |
|-|-|-|
| query | String | Encoded [query string](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US). For example, `"active=true^priority<=2"`. See the previous table for supported encoded query operators for MobileGlideRecord. |
[Table 3. Parameters]

{#MGR-addEncodedQuery_S__table_MGR-addEncodedQuery_S_p} {#MGR-addEncodedQuery_S__table_MGR-addEncodedQuery_S_r__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 4. Returns]

{#MGR-addEncodedQuery_S__table_MGR-addEncodedQuery_S_r}  
This example filters work order tasks to those that are active and have a priority of 1 or 2, and then runs the query.

    var gr = new MobileGlideRecord('wm_task');
            gr.addEncodedQuery('active=true^priority<=2');
            gr.query();

This example filters work order tasks to the active, high-priority tasks that are assigned to the current user, and logs how many it found. A button condition can use this count to show a My urgent tasks button only when there are tasks to work on.

    var gr = new MobileGlideRecord('wm_task');
            gr.addEncodedQuery('assigned_toDYNAMICme^active=true^priority<=2');
            gr.query();
            var count = 0;
            while (gr.next()) {
            count++;
            }
            mgs.info('My urgent tasks: ' + count);

Output:

    My urgent tasks: 2

## MobileGlideRecord - deleteRecord() {#ariaid-title4}

Deletes the current record, which is the record loaded by get() or advanced to by next().
{#MGR-deleteRecord__table_MGR-deleteRecord_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 5. Parameters]

{#MGR-deleteRecord__table_MGR-deleteRecord_p} {#MGR-deleteRecord__table_MGR-deleteRecord_r__entry__2}

| Type | Description |
|-|-|
| Boolean | Flag that indicates whether the record was deleted successfully. Possible values: * true: The record was deleted. * false: The record was not deleted. |
[Table 6. Returns]

{#MGR-deleteRecord__table_MGR-deleteRecord_r}  
This example loads a work order task by its sys_id, deletes it, and logs whether the delete succeeded.

    var gr = new MobileGlideRecord('wm_task');
            if (gr.get(current.getValue('sys_id'))) {
            var deleted = gr.deleteRecord();
            mgs.info(deleted);
            }

Output:

    true

This example deletes the draft child tasks of the current record and logs how many were deleted. A write-back action can use this to clean up tasks that were created in error. The script counts only the deletes that succeed.

    var gr = new MobileGlideRecord('wm_task');
            gr.addEncodedQuery('parent=' + current.getValue('sys_id') + '^short_descriptionSTARTSWITHDRAFT');
            gr.query();
            var removed = 0;
            while (gr.next()) {
            if (gr.deleteRecord()) {
            removed++;
            }
            }
            mgs.info('Deleted ' + removed + ' draft tasks');

Output:

    Deleted 2 draft tasks

## MobileGlideRecord - get(String sysId) {#ariaid-title5}

Loads a single record by its sys_id. If the record is found, the MobileGlideRecord points to it and a script can read its fields.
{#MGR-get_S__table_MGR-get_S_p__entry__3}

| Name | Type | Description |
|-|-|-|
| sysId | String | Sys_id of the record to load. Maximum length: 32. |
[Table 7. Parameters]

{#MGR-get_S__table_MGR-get_S_p} {#MGR-get_S__table_MGR-get_S_r__entry__2}

| Type | Description |
|-|-|
| Boolean | Flag that indicates whether the record was found and loaded. Possible values: * true: The record was found and loaded. * false: The record was not found. {#MGR-get_S__ul_bhq_ytl_1lc} |
[Table 8. Returns]

{#MGR-get_S__table_MGR-get_S_r}  
This example loads a work order task by its sys_id and logs a message if the record is found.

    var gr = new MobileGlideRecord('wm_task');
            if (gr.get(current.getValue('sys_id'))) {
            mgs.info('loaded');
            }

Output:

    loaded

This example loads the parent of the current task and logs its number. The script checks the result of get() so it can handle a parent that isn't found.

    var parentTask = new MobileGlideRecord('wm_task');
            if (parentTask.get(current.getValue('parent'))) {
            mgs.info('Parent task: ' + parentTask.getValue('number'));
            } else {
            mgs.info('Parent task not found.');
            }

Output:

    Parent task: WM0001001

## MobileGlideRecord - getElement(String field) {#ariaid-title6}

Gets the MobileGlideElement for a field, so a script can call element methods such as getDisplayValue(). Reading a field with the dot operator, such as `gr.priority`, does the same thing.
Dot operator field access is equivalent to this method --- `gr.priority` resolves to the exact same [MobileGlideElement](https://www.servicenow.com/docs/1tBNkT_tUfiz7lbIJgTzAA#MobileGlideElementScopedAPI "The MobileGlideElement API provides the subset of GlideElement available to mobile scripts. An instance is returned when a script dot-walks into a field on a MobileGlideRecord.") as `gr.getElement('priority')`, including chaining through reference fields (for example, `current.caller_id.name`). Every example in this document that writes `current.<field>` is using this mechanism rather than calling `getElement()` explicitly.
{#MGR-getElement_S__table_MGR-getElement_S_p__entry__3}

| Name | Type | Description |
|-|-|-|
| field | String | Name of the field to access. |
[Table 9. Parameters]

{#MGR-getElement_S__table_MGR-getElement_S_p} {#MGR-getElement_S__table_MGR-getElement_S_r__entry__2}

| Type | Description |
|-|-|
| [MobileGlideElement](https://www.servicenow.com/docs/1tBNkT_tUfiz7lbIJgTzAA#MobileGlideElementScopedAPI "The MobileGlideElement API provides the subset of GlideElement available to mobile scripts. An instance is returned when a script dot-walks into a field on a MobileGlideRecord.") | Element wrapper for the field. See [MobileGlideElement](https://www.servicenow.com/docs/1tBNkT_tUfiz7lbIJgTzAA#MobileGlideElementScopedAPI "The MobileGlideElement API provides the subset of GlideElement available to mobile scripts. An instance is returned when a script dot-walks into a field on a MobileGlideRecord.") for its methods. |
[Table 10. Returns]

{#MGR-getElement_S__table_MGR-getElement_S_r}  
This example loads a work order task, gets the element for its state field, and logs the state label.

    var gr = new MobileGlideRecord('wm_task');
            if (gr.get(current.getValue('sys_id'))) {
            var el = gr.getElement('state');
            mgs.info(el.getDisplayValue());
            }

Output:

    In Progress

This example defines a helper function that logs the name and display value of any field. Use getElement() when the field name is stored in a variable, because the dot operator needs the name to be written in the script.

    function showField(gr, fieldName) {
            var el = gr.getElement(fieldName);
            return el.getName() + ': ' + el.getDisplayValue();
            }
            
            mgs.info(showField(current, 'state'));

Output:

    state: In Progress

## MobileGlideRecord - getValue(String field) {#ariaid-title7}

Gets the internal value of a field on the current record, as a string.
{#MGR-getValue_S__table_MGR-getValue_S_p__entry__3}

| Name | Type | Description |
|-|-|-|
| field | String | Name of the field to read. |
[Table 11. Parameters]

{#MGR-getValue_S__table_MGR-getValue_S_p} {#MGR-getValue_S__table_MGR-getValue_S_r__entry__2}

| Type | Description |
|-|-|
| String | Internal value of the field. Returns `null` if the field does not exist on the table or the current user does not have read access to it. Returns an empty string if the field is readable and has no value. |
[Table 12. Returns]

{#MGR-getValue_S__table_MGR-getValue_S_r}  
This example logs the short description of the current record.

    mgs.info(current.getValue('short_description'));

Output:

    Replace filter in unit 4

This example tells apart a field the user can't read, an empty field, and a field with a value. A script can use this check to avoid treating a field that is hidden by access controls as an empty field.

    var assignee = current.getValue('assigned_to');
            if (assignee === null) {
            mgs.info('Assigned to is not readable.');
            } else if (assignee === '') {
            mgs.info('Unassigned');
            } else {
            mgs.info('Assigned');
            }

Output:

    Assigned

## MobileGlideRecord - insert() {#ariaid-title8}

Inserts the new record into the table and returns its sys_id. Call initialize() and setValue() first to define the record.
{#MGR-insert__table_MGR-insert_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 13. Parameters]

{#MGR-insert__table_MGR-insert_p} {#MGR-insert__table_MGR-insert_r__entry__2}

| Type | Description |
|-|-|
| String | Sys_id of the new record. Returns `null` if the insert fails for any reason, such as an access control denial, a read-only table, or a table-level validation error. The method does not throw an error, and a script cannot read the reason for a failure. |
[Table 14. Returns]

{#MGR-insert__table_MGR-insert_r}  
This example creates a follow-up task for the current record and logs the sys_id of the new task.

    var gr = new MobileGlideRecord('wm_task');
            gr.initialize();
            gr.setValue('parent', current.getValue('sys_id'));
            gr.setValue('short_description', 'Follow-up required');
            var newSysId = gr.insert();
            mgs.info(newSysId);

Output:

    9c0c1f2a3b4c5d6e7f8091a2b3c4d5e6

This example creates a high-priority follow-up task and checks the result of insert(). Because the method returns `null` when the insert fails, a script should check the return value before it uses the new record.

    var gr = new MobileGlideRecord('wm_task');
            gr.initialize();
            gr.setValue('parent', current.getValue('sys_id'));
            gr.setValue('short_description', 'Follow-up required');
            gr.setValue('priority', '2');
            var newSysId = gr.insert();
            if (newSysId) {
            mgs.info('Follow-up task created: ' + newSysId);
            } else {
            mgs.info('Follow-up task could not be created.');
            }

Output:

    Follow-up task created: 9c0c1f2a3b4c5d6e7f8091a2b3c4d5e6

## MobileGlideRecord - initialize() {#ariaid-title9}

Creates a new, empty record with the table's default values, ready for a script to set field values and insert.
{#MGR-initialize__table_MGR-initialize_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 15. Parameters]

{#MGR-initialize__table_MGR-initialize_p} {#MGR-initialize__table_MGR-initialize_r__entry__2}

| Type | Description |
|-|-|
| void | None. The record is populated with the table's default values and is ready for setValue() and insert(). |
[Table 16. Returns]

{#MGR-initialize__table_MGR-initialize_r}  
This example creates a MobileGlideRecord for the wm_task table and prepares a new record with default values.

    var gr = new MobileGlideRecord('wm_task');
            gr.initialize();

This example creates a checklist of child tasks for the current record and logs how many were created. The script creates a new MobileGlideRecord and calls initialize() for each task.

    var steps = ['Inspect equipment', 'Replace filter', 'Test system'];
            var created = 0;
            for (var i = 0; i < steps.length; i++) {
            var gr = new MobileGlideRecord('wm_task');
            gr.initialize();
            gr.setValue('parent', current.getValue('sys_id'));
            gr.setValue('short_description', steps[i]);
            if (gr.insert()) {
            created++;
            }
            }
            mgs.info('Created ' + created + ' tasks');

Output:

    Created 3 tasks

## MobileGlideRecord - next() {#ariaid-title10}

Moves to the next record in the result set so a script can read its fields. Returns `false` when no records remain.
{#MGR-next__table_MGR-next_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 17. Parameters]

{#MGR-next__table_MGR-next_p} {#MGR-next__table_MGR-next_r__entry__2}

| Type | Description |
|-|-|
| Boolean | Flag that indicates whether another record is available and was advanced to. Possible values: * true: Another record was advanced to. * false: The result set is exhausted. |
[Table 18. Returns]

{#MGR-next__table_MGR-next_r}  
This example queries the active work order tasks and logs the number of each one.

    var gr = new MobileGlideRecord('wm_task');
            gr.addEncodedQuery('active=true');
            gr.query();
            while (gr.next()) {
            mgs.info(gr.getValue('number'));
            }

Output:

    WM0001001
            WM0001002

This example finds the first unassigned active task and logs its number. Use `if` instead of `while` when the script needs only one record.

    var gr = new MobileGlideRecord('wm_task');
            gr.addEncodedQuery('active=true^assigned_toISEMPTY');
            gr.query();
            if (gr.next()) {
            mgs.info('Next unassigned task: ' + gr.getValue('number'));
            } else {
            mgs.info('No unassigned tasks.');
            }

Output:

    Next unassigned task: WM0001001

## MobileGlideRecord - query() {#ariaid-title11}

Runs the query, including any conditions added with addEncodedQuery(), and loads the matching records into the result set. Call next() to read each record.
{#MGR-query__table_MGR-query_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 19. Parameters]

{#MGR-query__table_MGR-query_p} {#MGR-query__table_MGR-query_r__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 20. Returns]

{#MGR-query__table_MGR-query_r}  
This example queries the active work order tasks. The script must call next() to read the records.

    var gr = new MobileGlideRecord('wm_task');
            gr.addEncodedQuery('active=true');
            gr.query();

This example queries the urgent tasks that are not assigned and logs their numbers in a single message, such as for a dispatcher's summary.

    var gr = new MobileGlideRecord('wm_task');
            gr.addEncodedQuery('active=true^priority<=2^assigned_toISEMPTY');
            gr.query();
            var urgent = [];
            while (gr.next()) {
            urgent.push(gr.getValue('number'));
            }
            mgs.info('Urgent unassigned: ' + urgent.join(', '));

Output:

    Urgent unassigned: WM0001001, WM0001002

## MobileGlideRecord - setValue(String field, String value) {#ariaid-title12}

Sets the value of a field on the current record. The change is not saved until the script calls update() or insert().
{#MGR-setValue_S_S__table_MGR-setValue_S_S_p__entry__3}

| Name | Type | Description |
|-|-|-|
| field | String | Name of the field to set, such as `priority`. |
| value | String | New internal value for the field. For a choice field, this is the stored value, not the label shown to the user. |
[Table 21. Parameters]

{#MGR-setValue_S_S__table_MGR-setValue_S_S_p} {#MGR-setValue_S_S__table_MGR-setValue_S_S_r__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 22. Returns]

{#MGR-setValue_S_S__table_MGR-setValue_S_S_r}  
This example sets the priority field to its internal value for a critical task.

    gr.setValue('priority', '1');

This example copies the priority and builds a short description from the current record, such as to prepare a follow-up task. The values are passed as strings. The new record isn't saved until the script calls insert().

    var gr = new MobileGlideRecord('wm_task');
            gr.initialize();
            gr.setValue('short_description', 'Follow-up: ' + current.getValue('short_description'));
            gr.setValue('priority', current.getValue('priority'));
            mgs.info(gr.getValue('short_description'));

Output:

    Follow-up: Replace filter

## MobileGlideRecord - update() {#ariaid-title13}

Saves the changes made to the current record.
{#MGR-update__table_MGR-update_p__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 23. Parameters]

{#MGR-update__table_MGR-update_p} {#MGR-update__table_MGR-update_r__entry__2}

| Type | Description |
|-|-|
| String | Sys_id of the updated record. |
[Table 24. Returns]

{#MGR-update__table_MGR-update_r}  
This example sets the priority of the current record and saves the change.

    gr.setValue('priority', '1');
            gr.update();

This example loads a work order task, sets its state to work in progress, saves the change, and logs the sys_id that update() returns. A write-back action can use this pattern when a technician starts a job.

    var gr = new MobileGlideRecord('wm_task');
            if (gr.get(current.getValue('sys_id'))) {
            gr.setValue('state', '2');
            var updatedSysId = gr.update();
            mgs.info('Updated task: ' + updatedSysId);
            }

Output:

    Updated task: 9c0c1f2a3b4c5d6e7f8091a2b3c4d5e6