PASnapshot - Scoped

concept australia Updated Sep 10, 2026 2 min read PASnapshot.md
Raw file servicenow.com

The PASnapshot API enables you to query information about Performance Analytics snapshots. Snapshots are the lists of records (sys_ids) that are collected at the time that the scores for those records are collected. A snapshot is made only for automated indicators with Collect records selected.

You can query information about a snapshot at a certain date using the indicator sys_id and date, and perform comparisons between snapshots for an indicator at different dates.

Parent Topic:Server API reference

PASnapshot - getCompareIDs(String sys_id, Number date1, Number date2, String type)

Compares records in snapshots for a specified indicator at multiple dates, such as to identify records included in one snapshot but not the other.

Name

Type

Description

sys_id

String

Indicator's sys_id.

date1

Number

Date of the first snapshot.Format: yyyymmdd

date2

Number

Date of the second snapshot.Format: yyyymmdd

type

String

Data to retrieve. Valid values:

  • all1: all records in the first snapshot
  • all2: all records in the second snapshot
  • shared: records that are in both snapshots
  • movedin: records that are in the first snapshot, but not the second
  • movedout: records that are in the second snapshot, but not the first
|Type|Description| |----|-----------| |String|A comma-separated list of sys\_id values.|
JavaScript
var snapshot2 = PASnapshot.getCompareIDs('fb007202d7130100b96d45a3ce6103b4', 20160430, 20160531, 'shared');gs.info(snapshot2);

Output:

Text
*** Script: 09c01200d7002100b81145a3ce6103ab,19c01200d7002100b81145a3ce6103e9,fcc01200d7002100b81145a3ce61035b,….

PASnapshot - getCompareQuery(String sys_id, Number date1, Number date2, String type)

Returns the query used to compare records in snapshots for a specified indicator at multiple dates.

Name

Type

Description

sys_id

String

Indicator's sys_id.

date1

Number

Date of the first snapshot.Format: yyyymmdd

date2

Number

Date of the second snapshot.Format: yyyymmdd

type

String

Specifies what data to retrieve.Valid values:

  • all1: all records in the first snapshot
  • all2: all records in the second snapshot
  • shared: records that are in both snapshots
  • movedin: records that are in the second snapshot, but not the first
  • movedout: records that are in the first snapshot, but not the second
|Type|Description| |----|-----------| |String|The table, view, and encoded query as a JSON string.|
JavaScript
var snapshot4 = PASnapshot.getCompareQuery('fb007202d7130100b96d45a3ce6103b4', 20160530, 20160531, 'all1');gs.info(snapshot4);

Output:

PowerShell
*** Script: {  "view":"",  "query":"sys_idINjavascript:new PAUtils().getCompareSnapshotIDs(\"fb007202d7130100b96d45a3ce6103b4\",  \"20160530\",  \"20160531\",  \"all1\")",  "table":"incident"}

PASnapshot - getIDs(String sys_id, Number date)

Returns the sys_id values for all records contained in the snapshot for a specified indicator at the specified date.

Name

Type

Description

sys_id

String

Indicator's sys_id.

date

Number

Date when the snapshot was taken.Format: yyyymmdd

|Type|Description| |----|-----------| |String|A comma-separated list of sys\_id values.|
JavaScript
var snapshot1 = PASnapshot.getIDs('fb007202d7130100b96d45a3ce6103b4', 20160530);gs.info(snapshot1);

Output:

Text
*** Script: 09c01200d7002100b81145a3ce6103ab,19c01200d7002100b81145a3ce6103e9,fcc01200d7002100b81145a3ce61035b,….

PASnapshot - getQuery(String sys_id, Number date)

Returns the query used to generate the snapshot for a specified indicator at the specified date.

Name

Type

Description

sys_id

String

Indicator's sys_id.

date

Number

Date the snapshot was taken.Format: yyyymmdd

|Type|Description| |----|-----------| |String|The table, view, and encoded query as a JSON string.|
JavaScript
var snapshot3 = PASnapshot.getQuery('fb007202d7130100b96d45a3ce6103b4', 20160530);gs.info(snapshot3);

Output:

PowerShell
*** Script: {  "view":"",  "query":"sys_idINjavascript:new PAUtils().getSnapshotIDs(\"fb007202d7130100b96d45a3ce6103b4\",  \"20160530\")",  "table":"incident"}
Search documentation
Search document titles and file paths on the australia branch