この例は、cmdb_ciテーブル内の障害の平均数を返す方法を示しています。

var faults = new global.GlideQuery('cmdb_ci')
    .avg('fault_count')
    .orElse(0);

gs.info(JSON.stringify(faults));

出力:

0.0037

この例では、ユーザーテーブル内のアクティブなレコードの数を返します。

var userCount = new global.GlideQuery('sys_user')
    .where('active', true)
    .count();

出力:

612

この例では、姓が Jeter であるユーザーテーブル内のすべてのアクティブなレコードを削除します。

var query = new global.GlideQuery('sys_user')
    .where('active', true)
    .where('last_name', 'Jeter')
    .deleteMultiple();

この例では、タスクテーブルにレコードを追加しますが、システムフィールドは設定しません。このメソッドを呼び出さない場合、以下の例では sys_updated_on、sys_mod_count などが更新されます。

var query = new global.GlideQuery('task')
    .disableAutoSysFields()
    .insert({ description: 'example', priority: 1 });

この例では、自動ビジネスプロセスをトリガーせずにタスクテーブルの複数のレコードを更新します。

var query = new global.GlideQuery('task')
    .disableWorkflow()
    .where('active', true)
    .updateMultiple({ priority: 1 });

この例では、タスクレコードを特定のsys_idで強制的に更新します。

var forceUpdate = new global.GlideQuery('task')
    .forceUpdate()
    .where('sys_id', taskId)
    .update()

sys_idに基づいてレコードを返す例。

var user = new global.GlideQuery('sys_user')
    .get('5137153cc611227c000bbd1bd8cd2005', ['first_name', 'last_name']) //Returns an Optional object.
    .orElse({ first_name: 'Default', last_name: 'User' }); //Method in the Optional class to return a default value.

gs.info(JSON.stringify(user, null, 2));

出力:

{
   "sys_id":"5137153cc611227c000bbd1bd8cd2005",
   "first_name":"Fred",
   "last_name":"Luddy"
}

ユーザーの名前を照会してレコードを返す例。

var user = new global.GlideQuery('sys_user')
    .getBy({
        first_name: 'Fred',
        last_name: 'Luddy'
    }, ['first_name', 'last_name', 'city', 'active']) // select first_name, last_name, city, active
    .orElse({
        first_name: 'Nobody',
        last_name: 'Found',
        city: 'Nowhere',
        active: false
    });

gs.info(JSON.stringify(user, null, 2));

出力:

{
   "first_name":"Fred",
   "last_name":"Luddy",
   "city":null,
   "active":true,
   "sys_id":"5137153cc611227c000bbd1bd8cd2005"
}

この例では、ユーザーの姓と名に基づいてレコードを挿入する方法を示します。

var fred = new global.GlideQuery('sys_user')
    .insert({ first_name: 'Fred', last_name: 'Luddy' })
    .get();

gs.info(JSON.stringify(fred, null, 2));

出力:

{
   "sys_id":"cf16eed0e82a9010f8778bda83d255d2",
   "first_name":"Fred",
   "last_name":"Luddy"
}

この例では、システムにまだ存在しない新しいレコードを挿入する方法を示します。

// insert a new record
var user = new GlideQuery('sys_user')
    .insertOrUpdate({
        first_name: 'George',
        last_name: 'Griffey'
    })
    .orElse(null);

この例では、既存のレコードを更新する方法を示します。

// update existing record
var user = new global.GlideQuery('sys_user')
    .insertOrUpdate({
        sys_id: '2d0efd6c73662300bb513198caf6a72e',
        first_name: 'George',
        last_name: 'Griffey' })
    .orElse(null);

この例は、返される結果を 5 レコードに制限する方法を示しています。

var incidents = new global.GlideQuery('incident')
    .limit(5)
    .select('priority', 'description')
    .forEach(function (incident){
        gs.info(JSON.stringify(incident, null, 2));
    });

出力:

*** Script: {
  "priority": 1,
  "description": "User can't get to any of his files on the file server.",
  "sys_id": "9d385017c611228701d22104cc95c371"
}
*** Script: {
  "priority": 1,
  "description": "I just moved from floor 2 to floor 3 and my laptop cannot connect to any wireless network.",
  "sys_id": "e8caedcbc0a80164017df472f39eaed1"
}
*** Script: {
  "priority": 1,
  "description": "User forgot their email password.",
  "sys_id": "9d3c1197c611228701cd1d94bc32d76d"
}
*** Script: {
  "priority": 1,
  "description": "When I try to print, my whole computer just freezes and stops working.",
  "sys_id": "8d6246c7c0a80164012fb063cecd4ace"
}
*** Script: {
  "priority": 3,
  "description": "Unable to login even though login credentials are correct.",
  "sys_id": "a9e30c7dc61122760116894de7bcc7bd"
}

この例は、指定されたフィールドの最大値、つまり最大の英数字値を返す方法を示しています。

var name = new global.GlideQuery('sys_user')
    .max('last_name')
    .orElse('');

gs.info(JSON.stringify(name));

出力:

"Zortman"

この例は、指定されたフィールドの最小値、つまり英数字の最小値を返す方法を示しています。

var name = new global.GlideQuery('sys_user')
    .min('last_name')
    .orElse('');

gs.info(JSON.stringify(name));

出力:

"Abel"

この例では、結果をレコード番号の昇順で並べ替える方法を示します。

var query = new global.GlideQuery('incident')
    .orderBy('number')
    .limit(5)
    .select('number', 'description') //Returns a stream of records wrapped in a Stream object.  
    .forEach(function (incident){ //Terminal method in the Stream class that executes the query and returns the result.
        gs.info(JSON.stringify(incident, null, 2));
    });

出力:

*** Script: {
  "number": "INC0000001",
  "description": "User can't access email on mail.company.com.",
  "sys_id": "9c573169c611228700193229fff72400"
}
*** Script: {
  "number": "INC0000002",
  "description": "User can't get to any of his files on the file server.",
  "sys_id": "9d385017c611228701d22104cc95c371"
}
*** Script: {
  "number": "INC0000003",
  "description": "I just moved from floor 2 to floor 3 and my laptop cannot connect to any wireless network.",
  "sys_id": "e8caedcbc0a80164017df472f39eaed1"
}
*** Script: {
  "number": "INC0000004",
  "description": "User forgot their email password.",
  "sys_id": "9d3c1197c611228701cd1d94bc32d76d"
}
*** Script: {
  "number": "INC0000005",
  "description": "CPU was 100% busy for more than 10 minutes",
  "sys_id": "e8e875b0c0a80164009dc852b4d677d5"
}

この例では、結果を番号の降順で並べ替える方法を示します。

var query = new global.GlideQuery('incident')
    .orderByDesc('number')
    .limit(5)
    .select('number', 'description') //Returns a stream of records wrapped in a Stream object.  
    .forEach(function (incident){ //Terminal method in the Stream class that executes the query and returns the result.
        gs.info(JSON.stringify(incident, null, 2));
    });

出力:

*** Script: {
  "number": "INC0009009",
  "description": "Unable to access the shared folder. Please provide access.",
  "sys_id": "57af7aec73d423002728660c4cf6a71c"
}
*** Script: {
  "number": "INC0009005",
  "description": "Unable to send or receive emails.",
  "sys_id": "ed92e8d173d023002728660c4cf6a7bc"
}
*** Script: {
  "number": "INC0009004",
  "description": "While launching the defect tracking base URL, it is redirecting to an error page.",
  "sys_id": "e329de99731423002728660c4cf6a73c"
}
*** Script: {
  "number": "INC0009003",
  "description": "Having an issue with users trying to access the company portal app",
  "sys_id": "9fffc328731823002728660c4cf6a742"
}
*** Script: {
  "number": "INC0009002",
  "description": "My computer is not detecting the headphone device. It could be an issue with the USB port.",
  "sys_id": "1c832706732023002728660c4cf6a7b9"
}

この例では、子インシデントの合計で集計結果を並べ替える方法を示します。

var aggQuery = new GlideQuery('incident')
    .aggregate('sum', 'child_incidents')
    .groupBy('category')
    .orderByDesc('sum', 'child_incidents')
    .select()
    .forEach(function (category){
        gs.info(JSON.stringify(category, null, 2));    
    });

出力:

*** Script: {
  "group": {
    "category": "hardware"
  },
  "sum": {
    "child_incidents": 2
  }
}
*** Script: {
  "group": {
    "category": "inquiry"
  },
  "sum": {
    "child_incidents": 1
  }
}
*** Script: {
  "group": {
    "category": "software"
  },
  "sum": {
    "child_incidents": 0
  }
}
*** Script: {
  "group": {
    "category": ""
  },
  "sum": {
    "child_incidents": null
  }
}
*** Script: {
  "group": {
    "category": "database"
  },
  "sum": {
    "child_incidents": null
  }
}
*** Script: {
  "group": {
    "category": "network"
  },
  "sum": {
    "child_incidents": null
  }
}

この例では、単純な OR 節をクエリーに追加する方法を示します。

var query = new global.GlideQuery('sys_user')
   .where('failed_attempts', '>', 0)
   .orWhere('last_login', '<', '2019-04-15')
   .select()
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "sys_id": "005d500b536073005e0addeeff7b12f4"
}
*** Script: {
  "sys_id": "d999e5fc77e72300454792718a10611d"
}
*** Script: {
  "sys_id": "30ad318577ab2300454792718a10619e"
}
*** Script: {
  "sys_id": "4ac73ecd738123002728660c4cf6a72c"
}
*** Script: {
  "sys_id": "3883f4c0730123002728660c4cf6a754"
}
*** Script: {
  "sys_id": "3988a3ca732023002728660c4cf6a757"
}
*** Script: {
  "sys_id": "8ff5b254b33213005e3de13516a8dcf7"
}

この例では、個別のクエリーを含む orWhere 句を追加する方法を示します。

// active = true OR (title = 'Vice President' AND state = 'CA')
var query = new GlideQuery('sys_user')
   .where('active', true)
   .orWhere(new GlideQuery()
       .where('title', 'Vice President')
       .where('state', 'CA'))
   .select('name')
   .limit(5)
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "name": "ITIL User",
  "sys_id": "681b365ec0a80164000fb0b05854a0cd"
}
*** Script: {
  "name": "SOAP Guest",
  "sys_id": "155699460a0a0b2b009e27c10b7f68f6"
}
*** Script: {
  "name": "System Administrator",
  "sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
  "name": "Alva Pennigton",
  "sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
  "name": "Benchmark Scheduler",
  "sys_id": "d3383a875b0132003d1c484c11f91a5b"
}

この例では、ユーザーテーブルにクエリを実行し、姓と名が null でない結果を返す方法を示します。

var query = new global.GlideQuery('sys_user')
   .whereNotNull('first_name')
   .orWhereNotNull('last_name')
   .select('name')
   .limit(5)
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "name": "ITIL User",
  "sys_id": "681b365ec0a80164000fb0b05854a0cd"
}
*** Script: {
  "name": "System Administrator",
  "sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
  "name": "Alva Pennigton",
  "sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
  "name": "Benchmark Scheduler",
  "sys_id": "d3383a875b0132003d1c484c11f91a5b"
}
*** Script: {
  "name": "Allyson Gillispie",
  "sys_id": "06826bf03710200044e0bfc8bcbe5d8a"
}

この例は、ユーザーテーブルにクエリを実行し、姓または名が null のレコードを返す方法を示しています。

var query = new global.GlideQuery('sys_user')
   .whereNull('last_name')
   .orWhereNull('first_name')
   .select('first_name', 'last_name')
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "first_name": "ml.admin",
  "last_name": null,
  "sys_id": "88aad6c5c73003005f1b78d48b9763a5"
}
*** Script: {
  "first_name": "Sitemap Scheduler User",
  "last_name": null,
  "sys_id": "85388c25b71011104eed4643ae11a993"
}
*** Script: {
  "first_name": null,
  "last_name": "Guest",
  "sys_id": "5136503cc611227c0183e96598c4f706"
}
*** Script: {
  "first_name": "ml_report.user",
  "last_name": null,
  "sys_id": "b6bad6c5c73003005f1b78d48b97632a"
}

次の例では、タスクテーブル内のすべてのアクティブなレコードを含む GlideQuery オブジェクトを優先度フィールド順に並べて作成し、説明フィールドのみを含むストリームオブジェクトとして返されます。

GlideQuery.parse('task', 'active=true^ORDERBYpriority') // Pass the encoded query to use to parse the Task records
  .select('description') // Return the records that match the encoded query
  .forEach(doSomething); // Do some processing on each of the returned records

この例では、クエリから表示するフィールドを選択し、 $DISPLAY を使用してフィールドの表示値を返す方法を示します。

var stream = new global.GlideQuery('sys_user')
   .select('first_name', 'last_name', 'company$DISPLAY')
   .limit(5)
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "first_name": "System",
  "last_name": "Administrator",
  "company$DISPLAY": "",
  "sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
  "first_name": "Alva",
  "last_name": "Pennigton",
  "company$DISPLAY": "ACME North America",
  "sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
  "first_name": "Benchmark",
  "last_name": "Scheduler",
  "company$DISPLAY": "",
  "sys_id": "d3383a875b0132003d1c484c11f91a5b"
}
*** Script: {
  "first_name": "Allyson",
  "last_name": "Gillispie",
  "company$DISPLAY": "ACME North America",
  "sys_id": "06826bf03710200044e0bfc8bcbe5d8a"
}
*** Script: {
  "first_name": "SOAP",
  "last_name": "Guest",
  "company$DISPLAY": "",
  "sys_id": "155699460a0a0b2b009e27c10b7f68f6"
}

この例では、単一のレコードをオプションのオブジェクトとして返し、指定されたフィールドを表示する方法を示します。

var user = new global.GlideQuery('sys_user')
    .where('zip', '12345')
    .whereNotNull('last_name')
    .selectOne('first_name', 'last_name', 'company$DISPLAY')
    .get();

gs.info(JSON.stringify(user, null, 2));

出力:

{
   "first_name":"Abel",
   "last_name":"Tuter",
   "company$DISPLAY":"ACME South America",
   "sys_id":"62826bf03710200044e0bfc8bcbe5df1"
}

この例では、cmdb_ciテーブル内のすべての障害の合計を返す方法を示します。

var totalFaults = new global.GlideQuery('cmdb_ci')
    .sum('fault_count')
    .orElse(0);

gs.info(JSON.stringify(totalFaults));

出力:

10

この例では、GlideQuery オブジェクトを GlideRecord に変換する方法を示します。

var userGr = new global.GlideQuery('sys_user')
    .where('active', true)
    .whereNotNull('first_name')
    .limit(10)
    .toGlideRecord();
userGr.query();

この例では、レコードを新しい値で更新する方法を示します。

var updateRecord = new global.GlideQuery('sys_user')
    .where('sys_id', '0a826bf03710200044e0bfc8bcbe5d7a')
    .update({ city: 'Los Angeles' });

この例は、定義された基準に適合するレコードを更新する方法を示しています。

var update = new global.GlideQuery('sys_user')
    .where('active', false)
    .where('last_name', 'Griffey')
    .updateMultiple({ active: true });

gs.info(JSON.stringify(update));

出力:

{"rowCount":1}

この例では、active が true で、ユーザーの最終ログインが指定された日付より後であるユーザーテーブルからレコードを返す方法を示します。

var query = new global.GlideQuery('sys_user')
   .where('active', true)
   .where('last_login', '>', '2018-01-01')
   .limit(5)
   .select()
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
  "sys_id": "005d500b536073005e0addeeff7b12f4"
}
*** Script: {
  "sys_id": "d999e5fc77e72300454792718a10611d"
}
*** Script: {
  "sys_id": "30ad318577ab2300454792718a10619e"
}
*** Script: {
  "sys_id": "3883f4c0730123002728660c4cf6a754"
}

この例は、「アクティブ」が true で、優先度または重大度が 1 のインシデントテーブルからレコードを返す方法を示しています。

// active = true AND (priority = 1 OR severity = 1)
var query = new GlideQuery('incident')
    .where('active', true)
    .where(new GlideQuery()
        .where('priority', 1)
        .orWhere('severity', 1))
   .limit(5)
   .select()
   .toArray(5)

gs.info(JSON.stringify(query, null, 2));

出力:

[
   {
      "sys_id":"b0f31e5673500010c2e7660c4cf6a711"
   },
   {
      "sys_id":"8ff5b254b33213005e3de13516a8dcf7"
   },
   {
      "sys_id":"d999e5fc77e72300454792718a10611d"
   },
   {
      "sys_id":"30ad318577ab2300454792718a10619e"
   },
   {
      "sys_id":"3883f4c0730123002728660c4cf6a754"
   }
]

この例では、ユーザーテーブルにクエリを実行し、first_nameフィールドが null でない結果を返す方法を示します。

var query = new global.GlideQuery('sys_user')
   .whereNotNull('first_name')
   .select('name')
   .limit(5)
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "name": "System Administrator",
  "sys_id": "6816f79cc0a8016401c5a33be04be441"
}
*** Script: {
  "name": "Alva Pennigton",
  "sys_id": "ca826bf03710200044e0bfc8bcbe5d89"
}
*** Script: {
  "name": "Benchmark Scheduler",
  "sys_id": "d3383a875b0132003d1c484c11f91a5b"
}
*** Script: {
  "name": "Allyson Gillispie",
  "sys_id": "06826bf03710200044e0bfc8bcbe5d8a"
}
*** Script: {
  "name": "SOAP Guest",
  "sys_id": "155699460a0a0b2b009e27c10b7f68f6"
}

この例は、ユーザーテーブルにクエリを実行し、姓または名が null のレコードを返す方法を示しています。

var query = new global.GlideQuery('sys_user')
   .whereNull('last_name')
   .orWhereNull('first_name')
   .select('first_name', 'last_name')
   .forEach(function (user){
      gs.info(JSON.stringify(user, null, 2));
   });

出力:

*** Script: {
  "first_name": "ml.admin",
  "last_name": null,
  "sys_id": "88aad6c5c73003005f1b78d48b9763a5"
}
*** Script: {
  "first_name": "Sitemap Scheduler User",
  "last_name": null,
  "sys_id": "85388c25b71011104eed4643ae11a993"
}
*** Script: {
  "first_name": null,
  "last_name": "Guest",
  "sys_id": "5136503cc611227c0183e96598c4f706"
}
*** Script: {
  "first_name": "ml_report.user",
  "last_name": null,
  "sys_id": "b6bad6c5c73003005f1b78d48b97632a"
}

この例では、ACL を使用して安全なクエリーを実行する方法を示します。

var users = new global.GlideQuery('sys_user')
    .withAcls()
    .limit(5)
    .orderByDesc('first_name')
    .select('first_name')
    .forEach(function (user){
        gs.info(JSON.stringify(user, null, 2));
    });

出力:

*** Script: {
  "first_name": "Zane",
  "sys_id": "16826bf03710200044e0bfc8bcbe5dbc"
}
*** Script: {
  "first_name": "Zackary",
  "sys_id": "8a826bf03710200044e0bfc8bcbe5d69"
}
*** Script: {
  "first_name": "Yvette",
  "sys_id": "4e826bf03710200044e0bfc8bcbe5d57"
}
*** Script: {
  "first_name": "Winnie",
  "sys_id": "f682abf03710200044e0bfc8bcbe5d1d"
}
*** Script: {
  "first_name": "Wilmer",
  "sys_id": "42826bf03710200044e0bfc8bcbe5d7b"
}