sn.jace.pro - sn.jace.pro - a copy of the docs for ServiceNow

Use GlideListV2 and GlideListV3 to manipulate lists.

You access the GlideList methods by using the g_list global object.
These methods are used in UI context menus and UI actions. The g_list
object is not available for related lists on the form link UI action.

addFilter

Adds a single term to the list query filter

var list = GlideList2.get(listID);
list.addFilter(term);
list.refresh(1);

get

Returns the GlideList2 object for the list or for the list that contains
the specified item. String listID or DOMElement element - specifies the
list by list ID or specifies the list by element

getChecked

Returns a comma-separated list of the sys_ids for the items that are
checked in the list

var list = GlideList2.get(listId);
var checked = list.getChecked();

getFixedQuery

Returns the sysparm_fixed query. A fixed query is the part of the query
that cannot be removed from the breadcrumb (i.e., it is fixed for the
user). It is specified by including a sysparm_fixed_query parameter
for the application module

var list = GlideList2.getByName("sprint_stories");
var filter = list.getFixedQuery() + list.getQuery();

getGroupBy

Returns the field or comma-separated list of fields that are used to
group the list

getListName

Returns the name of the list, which is usually the table name

var list = GlideList2.getByName('cmdb_ci_service_discovered.sa_m2m_service_entry_point.cmdb_ci_service');

getOrderBy

Returns the first field that is used to order by or a blank

getParentTable

Returns the name of the parent table for a related list (the table
associated with the form)

getQuery

Returns the encoded query string for the list

getRelated

Returns the related list field that associates the related list to the
parent form

function refreshImpactedServices(){
  GlideList2.get(g_form.getTableName() + '.' + g_list.getRelated()).setFilterAndRefresh('');
}

getTableName

Returns the table name for the list

var list = GlideList2.get(gel('sys_target').value);
var tableName = list.getTableName();

getTitle

Returns the list title

getView

Returns the view used to display the list

isUserList

Returns true if the list has been personalized by the user by choosing
the list mechanic and changing the list layout

refresh

Refreshes the list. The orderBy part of the list filter is ignored so
that the list uses its natural ordering when it is refreshed

GlideList2.get("rm_sprint.scrum_pp_sprint_team_member.sprint").refresh();

refreshWithOrderBy

Refreshes the list. The orderBy part of the list filter is included if
it is currently specified for the list

GlideList2.get(tableName).refreshWithOrderBy();

setFilter

Sets the encoded query string for the list, ignoring the orderBy and
groupBy parts of the query string

setFilterAndRefresh

Sets the encoded query string for the list, including the orderBy and
groupBy if specified, and then refreshes the list using the new filter

GlideList2.get(listID).setFilterAndRefresh(''); //refresh related list

setFirstRow

Sets the first row that will be displayed in the list when the list is
refreshed

setGroupBy

Sets the groupBy criteria for the list, for a single field or multiple
fields. For a single field, use field or groupByField. The groupBy
prefix is optional. For multiple fields use field1^field2^field3 or
groupByField1^groupByField2^groupByField3

setOrderBy

Sets the orderBy criteria for the list. For a single order by field use
orderBy field or orderByDescField. For multiple fields, use
orderByField1^orderByField2^orderByField3. orderBy specifies ascending
order and orderByDesc specifies descending. These prefix strings are
optional. If not specified orderBy is assumed

GlideList2.getByName(relatedListName).refresh();