GlideRecord - グローバル

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む116読むのに数分

    • GlideRecord API はデータベース操作に使用されます。

    GlideRecord API は、サーバー側のコードでデータベースとやり取りするための主要な手段です。GlideRecord は、1 つのテーブルのレコードを含むオブジェクトです。API を使用して GlideRecord オブジェクトをインスタンス化し、クエリパラメーター、フィルター、制限、および順序付けを追加します。

    クエリの構築と実行の詳細については、GlideRecord についての記事を参照してください。

    GlideRecord から継承されるクラスであり、GlideRecord と同じ関数を実行し、ACL も適用する GlideRecordSecure の詳細については、「GlideServer API」を参照してください。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。正しく構成されていないエンコードクエリ (無効なフィールド名を含むなど) は無効なクエリを生成します。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいて生成されます。これにより、テーブルからすべてのレコードが返される可能性があります。正しくないクエリで insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムのプロパティを true に設定すると、無効なエンコードクエリを含むクエリはレコードを返さなくなります。

    レコードから値を取得する

    ほとんどの場合、レコードから値を取得するためにドット連結を使用しないでください。ドット連結では、フィールド値ではなくオブジェクト全体が取得されます。オブジェクトを取得すると、より多くのストレージが使用されるため、配列または サービスポータルで使用すると望ましくない結果が生じる可能性があります。

    オブジェクト全体を取得する代わりに、次のいずれかのメソッドを使用してフィールド値をコピーできます。

    GlideElement オブジェクトのドット連結が必要な場合は、toString() メソッドを使用して値を取得します。たとえば、別の参照フィールドを設定するために、現在の問い合わせユーザーのマネージャーの sys_id が必要な場合があります。次の例は、オブジェクト全体の代わりに文字列値を取得する方法を示しています。
    var mgr = current.caller_id.manager.toString();
    関連項目：

    GlideRecord - addActiveQuery()

    アクティブなレコードを返すフィルターを追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    表 : 2. 返される内容
    タイプ 説明
    GlideQueryCondition アクティブなレコードを返すフィルター。 
    var inc = new GlideRecord('incident');
inc.addActiveQuery();
inc.query();

    スコープ対応

    スコープ対象のアプリケーションで addActiveQuery() メソッドを使用するには、対応するスコープ対象のメソッド addActiveQuery() を使用します。

    GlideRecord - addDomainQuery(オブジェクト glideRecord)

    クエリに使用されるドメインをユーザーのドメインから指定された GlideRecord のドメインに変更します。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。正しく構成されていないエンコードクエリ (無効なフィールド名を含むなど) は無効なクエリを生成します。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいて生成されます。これにより、テーブルからすべてのレコードが返される可能性があります。正しくないクエリで insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムのプロパティを true に設定すると、無効なエンコードクエリを含むクエリはレコードを返さなくなります。

    この機能には、Domain Support - Domain Extensions Installer (com.glide.domain.msp_extensions.installer) プラグインが必要です。

    表 : 3. パラメーター
    名前 タイプ 説明
    glideRecord オブジェクト ドメインを取得する GlideRecord
    表 : 4. 返される内容
    タイプ 説明
    なし 
    //This example requires the Domain plugin be active, the Group table is the specified 
//Domain table, and the ITIL user is in the Database Atlanta domain
//From any domain (using queryNoDomain()) look up the incidents that an ITIL user can only see 
//who is in the Database Atlanta domain, should expect all incidents with the global or the
//Database Atlanta domain specified.
var domain = new GlideRecord('sys_user');
domain.addQuery('user_name', 'itil');
domain.queryNoDomain();
if (domain.next()) {
    var domainQuery = new GlideRecord('incident');
    domainQuery.addQuery('active', true);
    domainQuery.addDomainQuery(domain);
    domainQuery.query();
    gs.print('Number of Incidents for ITIL user: ' + domainQuery.getRowCount());
    while (domainQuery.next())
        gs.print(domainQuery.number);
}

    スコープ対応

    このメソッドはスコープ対象のアプリケーションでは使用できません。

    GlideRecord - addEncodedQuery(文字列 query)

    設定されている可能性のある他のクエリにエンコードされたクエリを追加します。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。正しく構成されていないエンコードクエリ (無効なフィールド名を含むなど) は無効なクエリを生成します。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいて生成されます。これにより、テーブルからすべてのレコードが返される可能性があります。正しくないクエリで insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムのプロパティを true に設定すると、無効なエンコードクエリを含むクエリはレコードを返さなくなります。

    表 : 5. パラメーター
    名前 タイプ 説明
    クエリ 文字列 エンコードされたクエリ文字列。
    表 : 6. 返される内容
    タイプ 説明
    なし 
    var queryString = "priority=1^ORpriority=2";
 var now_GR = new GlideRecord('incident');
 
 now_GR.addEncodedQuery(queryString);
 now_GR.query();
 while (now_GR.next()) {
 gs.addInfoMessage(now_GR.number);
 }

    スコープ対応

    スコープ対象のアプリケーションで addEncodedQuery() メソッドを使用するには、対応するスコープ対象のメソッド addEncodedQuery() を使用します。

    GlideRecord - addExtraField(文字列 dotWalkedField)

    単一の要求でフォームまたはスクリプトから 1 つ以上のドット連結フィールドをクエリします。

    addExtraField() メソッドを使用すると、フォームまたはスクリプトのドット連結要素ごとに複数のクエリを実行するのではなく (データベースへの複数のラウンドトリップが必要)、単一のデータベース要求でドット連結フィールドをクエリできます。

    表 : 7. パラメーター
    名前 タイプ 説明
    ドット連結フィールド 文字列 ドット連結フィールド名。フィールド名のレベルは、ドット (ピリオド) で区切られます。たとえば、 Caller.Company という値を入力して、 会社 > 問い合わせユーザー 条件をインシデント [incident] テーブルに格納します。

    の形式は、ドット連結の dotWalkedField フォームまたはスクリプトのフィールドの左から右の順序に従います。
    表 : 8. 返される内容
    タイプ 説明
    なし
    注:
    addExtraField() メソッドは出力結果に影響を与えません。スクリプトでこのメソッドを使用するかどうかに関係なく、出力は常に同じです。
    次の例は、cmn_location (cmdb_ciフィールドの「location」参照フィールドから参照) の連絡先名フィールドをクエリする方法を示しています。
    注:
    この例の dotWalkedField 値 cmdb_ci.location.contact.name は、リスト内のフィールドを選択したときに、UI で ServiceNow® 「cmdb_ciフィールド」 => 「cmn_locationフィールド」 =>「sys_userフィールド」のようになります。
    var gliderecord = new GlideRecord("incident");
gliderecord.addQuery("number", "INC0041457");
gliderecord.addExtraField("cmdb_ci.location.contact.name");
gliderecory.query();
gliderecord.next();
gs.print(gr.cmdb_ci.location.contact.name);

    出力は、addExtraField() を使用しない場合、gs.print(gr.cmdb_ci.location.contact.name) と同じです。addExtraField() メソッドは、ドット連結フィールドのクエリを最適化します。出力例

    Abel Tuter

    GlideRecord - addFunction(オブジェクト function)

    事前定義された GlideDBFunctionBuilder オブジェクトをレコードに適用します。

    GlideDBFunctionBuilder スコープ対象クラスを使用して関数を定義します。関数を定義したら、addFunction(オブジェクト function) メソッドを使用して関数をレコードに適用します。

    表 : 9. パラメーター
    名前 タイプ 説明
    function オブジェクト SQL 操作を定義する GlideDBFunctionBuilder オブジェクトまたは GlideDBCaseStatementBuilder オブジェクト。
    表 : 10. 返される内容
    タイプ 説明
    なし 
    var functionBuilder = new GlideDBFunctionBuilder();
var myAddingFunction = functionBuilder.add();
myAddingFunction = functionBuilder.field('order');
myAddingFunction = functionBuilder.field('priority');
myAddingFunction = functionBuilder.build();

var now_GR = new GlideRecord('incident');
now_GR.addFunction(myAddingFunction);
now_GR.addQuery(myAddingFunction, '<', 5);
now_GR.query();
while(now_GR.next())
gs.log(now_GR.getValue(myAddingFunction));

    出力:

    *** Script: 1
*** Script: 4
*** Script: 3
*** Script: 1
*** Script: 1
*** Script: 2
*** Script: 1
*** Script: 1

    GlideRecord - addInactiveQuery()

    非アクティブなレコードを返すフィルターを追加します。非アクティブなレコードのアクティブフラグは false に設定されています。

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    GlideQueryCondition アクティブフラグが false のレコード。 
    var inc = new GlideRecord('incident');
inc.addInactiveQuery();
inc.query();

    スコープ対応

    スコープ対象のアプリケーションでは、スコープ対象のメソッド addQuery("active","false") を使用します。

    GlideRecord - addJoinQuery(文字列 table)

    関連テーブル内の関係に基づいてレコードを返すフィルターを追加します。

    たとえば、データベースグループ内のすべてのユーザー (sys_user_grmember テーブルを介したユーザー) を検索します。別の例として、インシデントが割り当てられているすべての問題 (incident.problem_id 関係を介した問題) があります。

    これは実際のデータベース結合ではなく、addJoinQuery() はサブクエリを追加します。このため、結果セットは結合に基づいて制限されますが、アクセスできるのはベーステーブルのフィールド (GlideRecord の初期化に使用されたテーブル内) のみです。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。正しく構成されていないエンコードクエリ (無効なフィールド名を含むなど) は無効なクエリを生成します。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいて生成されます。これにより、テーブルからすべてのレコードが返される可能性があります。正しくないクエリで insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムのプロパティを true に設定すると、無効なエンコードクエリを含むクエリはレコードを返さなくなります。

    表 : 13. パラメーター
    名前 タイプ 説明
    テーブル 文字列 テーブル名
    表 : 14. 返される内容
    タイプ 説明
    GlideQueryCondition 関係が一致するレコード。

    インシデントが添付されている問題を検索します。この例では、インシデントが関連付けられている問題を返します。ただし、クエリの一部として返されるインシデントからは値はプルされません。

    var prob = new GlideRecord('problem');
prob.addJoinQuery('incident');
prob.query();

    関連付けられたインシデントで active=false の問題を検出します。

    // Look for Problem records
var now_GR = new GlideRecord('problem');
 
// That have associated Incident records
var grSQ = now_GR.addJoinQuery('incident');
 
// Where the Problem records are "active=false"
now_GR.addQuery('active', 'false');
 
// And the Incident records are "active=true"
grSQ.addCondition('active', 'true');
 
// Query
now_GR.query();
 
// Iterate and print results
while (now_GR.next()) {
    gs.print(now_GR.getValue('number'));
}

    スコープ対応

    スコープ対象のアプリケーションで addJoinQuery() メソッドを使用するには、対応するスコープ対象のメソッド addJoinQuery() を使用します。

    GlideRecord - addJoinQuery(文字列 table, 文字列 primaryField)

    関連テーブル内の関係に基づいてレコードを返すフィルターを追加します。

    たとえば、データベースグループ内のすべてのユーザー (sys_user_grmember テーブルを介したユーザー) を検索します。別の例として、インシデントが割り当てられているすべての問題 (incident.problem_id 関係を介した問題) があります。

    これは実際のデータベース結合ではなく、addJoinQuery() はサブクエリを追加します。このため、結果セットは結合に基づいて制限されますが、アクセスできるのはベーステーブルのフィールド (GlideRecord の初期化に使用されたテーブル内) のみです。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。正しく構成されていないエンコードクエリ (無効なフィールド名を含むなど) は無効なクエリを生成します。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいて生成されます。これにより、テーブルからすべてのレコードが返される可能性があります。正しくないクエリで insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムのプロパティを true に設定すると、無効なエンコードクエリを含むクエリはレコードを返さなくなります。

    表 : 15. パラメーター
    名前 タイプ 説明
    テーブル 文字列 テーブル名
    primaryField 文字列 sys_id 以外の場合はプライマリフィールドです。
    表 : 16. 返される内容
    タイプ 説明
    GlideQueryCondition 関係が一致するレコード。

    sys_id の代わりに結合キーで open_by フィールドを使用して、インシデントを含む問題を検索します。

    var now_GR = new GlideRecord('problem'); 
now_GR.addJoinQuery('incident', 'opened_by'); 
now_GR.query();

    スコープ対応

    スコープ対象のアプリケーションで addJoinQuery() メソッドを使用するには、対応するスコープ対象のメソッド addJoinQuery() を使用します。

    GlideRecord - addJoinQuery(文字列 table, 文字列 primaryField, 文字列 joinTableField)

    関連テーブル内の関係に基づいてレコードを返すフィルターを追加します。

    たとえば、データベースグループ内のすべてのユーザー (sys_user_grmember テーブルを介したユーザー) を検索します。別の例として、インシデントが割り当てられているすべての問題 (incident.problem_id 関係を介した問題) があります。

    これは実際のデータベース結合ではなく、addJoinQuery() はサブクエリを追加します。このため、結果セットは結合に基づいて制限されますが、アクセスできるのはベーステーブルのフィールド (GlideRecord の初期化に使用されたテーブル内) のみです。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。正しく構成されていないエンコードクエリ (無効なフィールド名を含むなど) は無効なクエリを生成します。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいて生成されます。これにより、テーブルからすべてのレコードが返される可能性があります。正しくないクエリで insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムのプロパティを true に設定すると、無効なエンコードクエリを含むクエリはレコードを返さなくなります。

    表 : 17. パラメーター
    名前 タイプ 説明
    テーブル 文字列 テーブル名
    primaryField 文字列 sys_id 以外の場合はプライマリフィールドです。
    joinTableField 文字列 sys_id 以外の場合、テーブルを結合するフィールド
    表 : 18. 返される内容
    タイプ 説明
    GlideQueryCondition 関係が一致するレコード。

    インシデントの [caller_id] フィールド値が問題の [opened_by] フィールド値と一致するインシデントが関連付けられている問題を検索します。

    var now_GR = new GlideRecord('problem'); 
now_GR.addJoinQuery('incident', 'opened_by', 'caller_id'); 
now_GR.query();

    スコープ対応

    スコープ対象のアプリケーションで addJoinQuery() メソッドを使用するには、対応するスコープ対象のメソッド addJoinQuery() を使用します。

    GlideRecord - addNotNullQuery(文字列 fieldName)

    指定されたフィールドが null でないレコードを返すフィルターを追加します。

    表 : 19. パラメーター
    名前 タイプ 説明
    fieldName 文字列 フィールド名
    表 : 20. 返される内容
    タイプ 説明
    GlideQueryCondition パラメーターフィールドが null ではないレコードの GlideQueryCondition。 
    var target = new GlideRecord('incident'); 
  target.addNotNullQuery('short_description');
  target.query();   // Issue the query to the database to get all records
  while (target.next()) {   
     // add code here to process the incident record
  }

    スコープ対応

    スコープ対象のアプリケーションで addNotNullQuery() メソッドを使用するには、対応するスコープ対象のメソッド addNotNullQuery() を使用します。

    GlideRecord - addNullQuery(文字列 fieldName)

    指定されたフィールドが null であるレコードを返すフィルターを追加します。

    表 : 21. パラメーター
    名前 タイプ 説明
    fieldName 文字列 フィールド名
    表 : 22. 返される内容
    タイプ 説明
    GlideQueryCondition 指定されたフィールドが null であるレコードの GlideQueryCondition。 
    var target = new GlideRecord('incident'); 
  target.addNullQuery('short_description');
  target.query();   // Issue the query to the database to get all records
  while (target.next()) {   
     // add code here to process the incident record
  }

    スコープ対応

    スコープ対象のアプリケーションで addNullQuery() メソッドを使用するには、対応するスコープ対象のメソッド addNullQuery() を使用します。

    GlideRecord - addQuery(文字列 name, オブジェクト operator, オブジェクト value)

    要求を作成する機能を提供します。要求は実行されると、要求に一致する指定されたテーブルから行を返します。

    SQL に精通している場合、このメソッドは「where」句に似ています。1 つのクエリで 1 つ以上の addQuery() を呼び出すことができます。このメソッドでは、クエリは AND 化されます。クエリステートメントのいずれかを OR 化する必要がある場合は、クラス GlideQueryCondition を使用します。

    addQuery() は通常、3 つのパラメーター (テーブルフィールド、演算子、および比較値) を指定して呼び出されます。myObj.addQuery('category','Hardware'); など、テーブルフィールドと比較値の 2 つのパラメーターのみを使用して呼び出すことができます。この場合の演算子は「次の値に等しい」とみなされます。

    クエリの使用の詳細については、「 スクリプトでのテーブルのクエリ」を参照してください。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。正しく構成されていないエンコードクエリ (無効なフィールド名を含むなど) は無効なクエリを生成します。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいて生成されます。これにより、テーブルからすべてのレコードが返される可能性があります。正しくないクエリで insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムのプロパティを true に設定すると、無効なエンコードクエリを含むクエリはレコードを返さなくなります。

    表 : 23. パラメーター
    名前 タイプ 説明
    name 文字列 テーブルフィールド名
    operator オブジェクト クエリ演算子。使用可能な値は、value パラメーターのデータタイプによって異なります。
    数値：
    • =
    • !=
    • >
    • >=
    • <
    • <=
    文字列 (大文字である必要があります)：
    • =
    • !=
    • IN
    • NOT IN
    • STARTSWITH
    • ENDSWITH
    • CONTAINS
    • DOES NOT CONTAIN
    • INSTANCEOF
    注:
    LIKE 演算子の代わりに CONTAINS を使用します。
    value オブジェクト クエリ対象の値 (大文字と小文字は区別されません)。
    表 : 24. 返される内容
    タイプ 説明
    GlideQueryCondition GlideRecord に追加された GlideQueryCondition への参照。 
    var rec = new GlideRecord('incident');
rec.addQuery('active',true);
rec.addQuery('sys_created_on', ">", "2010-01-19 04:05:00");
rec.query();
while (rec.next()) { 
 rec.active = false;
 gs.print('Active incident ' + rec.number + ' closed');
 rec.update();
}

    IN 演算子を使用します。

    var que = new GlideRecord('incident');
que.addQuery('number','IN','INC00001,INC00002');
que.query();
while(que.next()) {
 //do something....
}

    スコープ対応

    スコープ対象のアプリケーションで addQuery() メソッドを使用するには、対応するスコープ対象のメソッド addQuery() を使用します。

    GlideRecord - addValue(文字列 field, 数値 value)

    現在の GlideRecord オブジェクトのデータベースレベルで、指定された数値フィールドに対するアトミックな加算および減算操作を指定します。

    通常、GlideRecord オブジェクトはデータベース内の 1 つのレコードとして書き込まれます。個々のフィールド値は定義されたとおりに格納されます。GlideRecord フィールドに値を追加するコードの場合、フィールドをアトミックにインクリメントするのではなく、単に新しい値でフィールドをデータベースに保存します。

    たとえば、次のコードを実行すると、データベースの [u_count] フィールドの値は 2 になります。
    gs.print(now_now_GR.u_count); // "1" 
now_GR.u_count += 1; 
now_GR.update(); 
now_GR.get(now_now_GR.sys_id); 
gs.print(now_now_GR.u_count); // "2"
    別のユーザーが同じコードを同時に実行すると、2 つの操作でそれぞれ u_count に 1 が加算されるのではなく、正味の効果として u_count に 2 しか含まれず、1 つの操作の更新が実際に失われます。
    逆に、addValue() メソッドは、レコードが更新されたときにアトミックな操作としてデータベースで加算/減算を実行します。同時に実行されている 2 つの操作でそれぞれフィールドが適切に更新されます。 
    gs.print(now_now_GR.u_count); // "1" 
now_GR.addValue("u_count", 1); 
now_GR.update(); 
now_GR.get(now_GR); // The record must be reloaded from the database to observe the result
gs.print(now_now_GR.u_count); // "3", if executed concurrently with another user
    注:
    明示的に行わない限り、新しい値はデータベースから読み取られません。

    setValue() と同様に、addValue() の変更は update() または insert() への後続の呼び出し後にのみデータベースで有効になります。insert() が呼び出されると、指定されたフィールドは addValue() に渡される value パラメーターで初期化されます。

    注:
    addValue() を呼び出す前に指定したフィールドに対して setValue() を呼び出すと、addValue() メソッドは処理されず、エラーメッセージがログに記録されます。
    表 : 25. パラメーター
    名前 タイプ 説明
    フィールド 文字列 この GlideRecord で変更するフィールドの名前。

    関連するフィールドが数値タイプでない場合、操作は無視されます。
    value 数値 レコードが保存されたときに値に加算される数。減算操作を実行するには、単に負の値を渡します。
    表 : 26. 返される内容
    タイプ 説明
    なし

    加算される値を表示します。

    gs.print(now_GR.u_count); // "1" 
now_GR.addValue("u_count", 1); 
now_GR.update(); 
now_GR.get(now_GR.sys_id); // The record must be reloaded from the database to observe the result
gs.print(now_GR.u_count);

    出力：2

    減算される値を表示します。

    gs.print(now_GR.u_count); // "4" 
now_GR.addValue("u_count", -1); 
now_GR.update(); 
now_GR.get(now_GR.sys_id); // The record must be reloaded from the database to observe the result
gs.print(now_GR.u_count);

    出力：3

    GlideRecord - applyEncodedQuery(文字列 queryString)

    指定されたエンコードクエリ用語の値を設定し、現在の GlideRecord に適用します。

    表 : 27. パラメーター
    名前 タイプ 説明
    queryString 文字列 現在の GlideRecord に適用するエンコードクエリ。
    表 : 28. 返される内容
    タイプ 説明
    なし 

    function createAcl(table, role) {
  gs.print("Checking security on table " + table);
  var now_GR = new GlideRecord("sys_security_acl");
  now_GR.addQuery("name", table);
  now_GR.addQuery("operation", "read");
  now_GR.query();
  var encQuery = now_GR.getEncodedQuery();
  if (now_GR.next()) {
    // existing acl found so use it
    createAclRole(now_GR.sys_id.toString(), role);
    return;
  } else {
  now_GR.initialize();
  now_GR.applyEncodedQuery(encQuery);
  var acl = now_GR.insert();
    gs.print("Added read access control on " + table);
    createAclRole(acl, role);
  } 
}

    GlideRecord - applyTemplate(文字列 template)

    テンプレートテーブル [sys_template] から現在のレコードにテンプレートレコードを適用します。指定されたテンプレートが見つからない場合、アクションは実行されません。

    注:
    テンプレートの [次の関連子テンプレート] フィールドが入力されている場合、このメソッドは自動的に now_GR.insert() メソッドをインスタンス化します。詳細については、「 関連するタスク レコードのテンプレートを作成する」を参照してください。
    表 : 29. パラメーター
    名前 タイプ 説明
    template 文字列 テンプレート [sys_template] テーブルのテンプレートの名前。
    表 : 30. 返される内容
    タイプ 説明
    なし 
    var rec1 = new GlideRecord("incident");
rec1.initialize();
rec1.applyTemplate("my_incident_template");
rec1.insert();

    GlideRecord - autoSysFields(ブーリアン e)

    sys_updated_by、sys_updated_on、sys_mod_count、sys_created_by、および sys_created_on のフィールドへの更新を有効または無効にします。これは、履歴情報を変更せずにレコードのフィールド値を手動で更新するためによく使用されます。

    注:
    これは、Fuji リリース以降のスコープ対象のアプリでは使用できません。スコープ対象のアプリで利用可能な API のリストについては、スコープ対象の GlideRecord API リファレンスを参照してください。
    警告:
    このメソッドは注意して使用してください。このメソッドを使用すると [sys_mod_count] フィールドはインクリメントされず、他の sys_ フィールドは更新されません。これにより、アクティビティフォーマッター、履歴セット、通知、および測定基準などの機能が中断する可能性があります。
    表 : 31. パラメーター
    名前 タイプ 説明
    e ブーリアン false の場合、sys_updated_by、sys_updated_on、sys_mod_count、sys_created_by、および sys_created_on への更新を無効にします。
    表 : 32. 返される内容
    タイプ 説明
    なし 
    var inc = new GlideRecord('incident');
 
// Change all Open(1) incidents to Active(2)
 
inc.addQuery('state', 1);
inc.query();
 
while (inc.next()) {
  inc.autoSysFields(false);  // Do not update sys_updated_by, sys_updated_on, sys_mod_count, sys_created_by, and sys_created_on
  inc.setWorkflow(false);    // Do not run any other business rules
  inc.setValue('state', 2);
  inc.update();
}

    GlideRecord - canCreate()

    アクセス制御ルール (ユーザーのロールを含む) がこのテーブルへの新しいレコードの挿入を許可するかどうかを判断します。

    表 : 33. パラメーター
    名前 タイプ 説明
    なし
    表 : 34. 返される内容
    タイプ 説明
    ブーリアン ユーザーのロールでこのテーブルのレコードの作成が可能かどうかを示すフラグ。
    可能な値：
    • true：作成は許可されている
    • false：作成は許可されていない

    この例は、benefit_plan テーブルでレコードを作成できるかどうかを示しています。

    canCreateBenefitPlan : function() {
  var now_GR = new GlideRecord('benefit_plan');
  return now_GR.canCreate();
}

    スコープ対応

    スコープ対象のアプリケーションで canCreate() メソッドを使用するには、対応するスコープ対象のメソッド canCreate() を使用します。

    GlideRecord - canDelete()

    アクセス制御ルール (ユーザーのロールを含む) がこのテーブルでレコードの削除を許可するかどうかを判断します。

    表 : 35. パラメーター
    名前 タイプ 説明
    なし
    表 : 36. 返される内容
    タイプ 説明
    ブーリアン ユーザーのロールでこのテーブルのレコードの削除が可能かどうかを示すフラグ。
    有効な値：
    • true：削除は許可されている
    • false：削除は許可されていない
    		 
    var att = new GlideRecord('sys_attachment');
att.get('$[sys_attachment.sys_id]');
var sm = GlideSecurityManager.get();
var checkMe = 'record/sys_attachment/delete';
var canDelete = sm.hasRightsTo(checkMe, att);
gs.log('canDelete: ' + canDelete);

    スコープ対応

    スコープ対象のアプリケーションで canDelete() メソッドを使用するには、対応するスコープ対象のメソッド canDelete() を使用します。

    GlideRecord - canRead()

    アクセス制御ルール (ACL) がこのテーブルでのレコードの読み取りを許可するかどうかを判断します。このメソッドでは、ユーザーロール、スクリプト化された ACL、スクリプト化された条件を持つ ACL など、すべての ACL タイプが評価されます。

    表 : 37. パラメーター
    名前 タイプ 説明
    なし
    表 : 38. 返される内容
    タイプ 説明
    ブーリアン ユーザーのロールがこのテーブルのレコードの読み取りを許可するかどうかを示すフラグ。
    有効な値：
    • true：読み取りは許可されている
    • false：読み取りは許可されていない

    この例は、benefit_plan テーブルからレコードを読み取れるかどうかを示しています。

    canReadBenefitPlan: function() {
  var now_GR = new GlideRecord('benefit_plan');
  return now_GR.canRead();
}

    スコープ対応

    スコープ対象のアプリケーションで canRead() メソッドを使用するには、対応するスコープ対象のメソッド canRead() を使用します。

    GlideRecord - canWrite()

    アクセス制御ルール (ユーザーのロールを含む) がこのテーブルでレコードへの更新を許可するかどうかを判断します。

    表 : 39. パラメーター
    名前 タイプ 説明
    なし
    表 : 40. 返される内容
    タイプ 説明
    ブーリアン ユーザーのロールでこのテーブルのレコードの書き込みが可能かどうかを示すフラグ。
    有効な値：
    • true：書き込みは許可されている
    • false：書き込みは許可されていない

    この例は、benefit_plan テーブルにレコードを書き込めるかどうかを示しています。

    canWriteBenefitPlan : function() {
  var now_GR = new GlideRecord('benefit_plan');
  return now_GR.canWrite();
}

    スコープ対応

    スコープ対象のアプリケーションで canWrite() メソッドを使用するには、対応するスコープ対象のメソッド canWrite() を使用します。

    GlideRecord - changes()

    レコード内のいずれかのフィールドが変更されたかどうかを判断します。

    表 : 41. パラメーター
    名前 タイプ 説明
    なし
    表 : 42. 返される内容
    タイプ 説明
    ブーリアン 指定されたレコードに変更があるかどうかを示すフラグ。
    可能な値：
    • true：指定されたレコードのフィールドが変更されました。
    • false：フィールドは変更されていません。

    この例は、インシデントレコードに変更があるかどうかを確認する方法を示しています。

    var now_GR = new GlideRecord("incident");
now_GR.query();
now_GR.next();
if (now_GR.changes()) {
  gs.print("The incident record reported changes right after being read");
} else {
  gs.print("The incident record has not changed");
}

    スコープ対応

    この機能をスコープ対象のアプリケーションに実装するには、次のようなコードを追加します。

    var now_GR = new GlideRecord("incident");
   now_GR.get("965c9e5347c12200e0ef563dbb9a7156");
   now_GR.short_description = "test";
   var elements = now_GR.getElements();
   var hasChanged = false;
   for(var i=0; i < elements.length;i++){
     var element = elements[i];
     hasChanged = hasChanged || element.changes();
     gs.info(element.getName() + ":" + element.changes());
   }
   gs.info(hasChanged);

    GlideRecord - deleteMultiple()

    クエリを満たすすべてのレコードを削除します。

    このメソッドでは添付ファイルは削除されません。

    このメソッドではドット連結はサポートされていません。参照先テーブルで deleteMultiple() 関数を使用すると、テーブル内のすべてのレコードが削除されます。また、deleteRecord() を使用してカスケード削除を行うと、同じ GlideRecord オブジェクトに対する以前の setWorkflow() の呼び出しは無視されます。

    通貨フィールドのあるテーブルで deleteMultiple() は使用しないでください。常に各レコードを個別に削除してください。また、大きなテーブルを操作する場合は、このメソッドと chooseWindow() メソッドまたは setLimit() メソッドを一緒に使用しないでください。setLimit() メソッドは、deleteMultiple() で削除されるレコードの数を制限しません。setLimit() に関係なく、クエリーによって返されたすべてのレコードが削除されます。

    システムプロパティは glide.db.forced.chunk.threshold 、チャンクレコードの削除と更新を強制するしきい値を設定します。チャンクは、巨大なテーブルでプライマリキー以外の削除によってレプリケーションの問題が発生するのを防ぐのに役立ちます。詳細については、「Available system properties」を参照してください。

    表 : 43. パラメーター
    名前 タイプ 説明
    なし
    表 : 44. 返される内容
    タイプ 説明
    なし

    この例は、インシデントテーブルからすべての非アクティブなレコードを削除する方法を示しています。

    var now_GR = new GlideRecord('incident');
now_GR.addQuery('active','false');
now_GR.query();
now_GR.deleteMultiple();

    スコープ対応

    スコープ対象のアプリケーションで deleteMultiple() メソッドを使用するには、対応するスコープ対象のメソッド deleteMultiple() を使用します。

    GlideRecord - deleteRecord()

    1 つのレコードを削除します。

    注:
    deleteMultiple() を使用してカスケード削除を行うと、同じ GlideRecord オブジェクトに対する以前の setWorkflow() の呼び出しは無視されます。
    表 : 45. パラメーター
    名前 タイプ 説明
    なし
    表 : 46. 返される内容
    タイプ 説明
    ブーリアン レコードが正常に削除されたかどうかを示すフラグ。
    可能な値：
    • true：レコードが削除されました。
    • false：削除するレコードが見つかりませんでした。

    この例は、インシデントテーブルからすべての非アクティブなレコードを削除する方法を示しています。

    var rec = new GlideRecord('incident');
rec.addQuery('active',false);
rec.query();
while (rec.next()) { 
 gs.info('Inactive incident ' + rec.number + ' deleted');
 rec.deleteRecord();
}

    出力:

    Inactive incident INC0010010 deleted
Inactive incident INC0010011 deleted

    この例は、インシデントテーブルからレコードを挿入直後に削除する方法を示しています。インシデント の GlideRecord は、挿入後に再ロードしないと削除できません。

    var grTicket = new GlideRecord('incident');
grTicket.initialize();
grTicket.short_description = 'Example ticket';
grTicket.work_notes = 'An update about the ticket';
var ins_sys_id = grTicket.insert(); // Insert the record
grTicket.get(ins_sys_id); // Reload the inserted record
gs.info(grTicket.deleteRecord()); // Delete the record

    出力:

    true

    スコープ対応

    スコープ対象のアプリケーションで deleteRecord() メソッドを使用するには、対応するスコープ対象のメソッド deleteRecord() を使用します。

    GlideRecord - find(文字列 columnName, 文字列 value)

    いずれかのレコードに一致する値が指定された列にある場合は true を返します。見つかった場合は、一致する最初のレコードにも移動し、基本的にはレコードが返されるまで next() を実行します。

    表 : 47. パラメーター
    名前 タイプ 説明
    columnName 文字列 検索するフィールド名。
    value 文字列 指定されたフィールドで確認する値。
    表 : 48. 返される内容
    タイプ 説明
    ブーリアン 現在のテーブル内のいずれかのレコードに一致する値が指定されたフィールドにあるかどうかを示すフラグ。
    可能な値：
    • true：一致するフィールドがあります。
    • false：一致するフィールドがありません。

    この例は、[簡単な説明] フィールドに「重大」を含むレコードをインシデントテーブルで検索する方法を示しています。

    var now_GR = new GlideRecord("incident");
now_GR.query();
var shortDescription = "Critical";
if (now_GR.find("short_description", shortDescription)) {
  gs.print("An incident with the specified field value was found");
  var recordID = now_GR.getValue("sys_id");
  gs.print("Found in the following record: " + recordID);
} else {
  gs.print("An incident with the specified field value was not found");
}

    出力

    An incident with the specified field value was found
Found in the following record: 552c48888c033300964f4932b03eb092

    GlideRecord - get(オブジェクト name, オブジェクト value)

    現在の GlideRecord オブジェクトに指定されたレコードを返します。

    このメソッドは、1 つまたは 2 つのパラメーターを受け入れます。パラメーターが 1 つだけ渡される場合、メソッドは目的のレコードの sys_id であると見なします。見つからない場合は、値を表示値と照合しようとします。2 つのパラメーターが渡される場合、最初のパラメーターは検索する GlideRecord 内の列の名前です。2 つ目は検索する値です。

    複数のレコードが見つかった場合は、next() を使用して追加のレコードにアクセスします。

    表 : 49. パラメーター
    名前 タイプ 説明
    name オブジェクト オプション。指定された value パラメーターを検索するためにインスタンス化された GlideRecord 列の名前。パラメーターが 1 つだけ渡される場合、メソッドはこのパラメーターが sys_id であると見なします。
    value オブジェクト 照合する値。
    表 : 50. 返される内容
    タイプ 説明
    ブーリアン 要求されたレコードが見つかったかどうかを示します。
    可能な値：
    • true：レコードが見つかりました
    • false：レコードが見つかりませんでした

    この例では、sys_id を渡すことによってインシデントレコードを取得します。

    var grIncident = new GlideRecord('incident');
var returnValue = grIncident.get('99ebb4156fa831005be8883e6b3ee4b9');
gs.info(returnValue); // logs true or false
gs.info(grIncident.number); // logs Incident Number

    この例では、検索するレコードの列と検索する値を渡すことでインシデントレコードを取得します。

    var grIncident = new GlideRecord('incident');
var returnValue = grIncident.get('caller_id.name','Sylivia Wayland');
gs.info(returnValue); // logs true or false
gs.info(grIncident.number); // logs Incident Number

    スコープ対応

    スコープ対象のアプリケーションで get() メソッドを使用するには、対応するスコープ対象のメソッド get() を使用します。

    GlideRecord - getAttribute(文字列 fieldName)

    指定されたフィールドのディクショナリ属性を返します。

    表 : 51. パラメーター
    名前 タイプ 説明
    fieldName 文字列 ディクショナリ属性を返すフィールド名
    表 : 52. 返される内容
    タイプ 説明
    文字列 ディクショナリ属性

    この例は「tree_picker」のディクショナリ属性を返す方法を示しています。

    function doit() {
  var now_GR = new GlideRecord('sys_user');
  now_GR.query("user_name","admin");
  if (now_GR.next()) {
    gs.print("we got one");
    gs.print(now_GR.location.getAttribute("tree_picker"));
  }
}

    スコープ対応

    スコープ対象のアプリケーションで getAttribute() メソッドを使用するには、対応するスコープ対象のメソッド getAttribute() を使用します。

    GlideRecord - getClassDisplayValue()

    テーブルのラベルを返します。

    表 : 53. パラメーター
    名前 タイプ 説明
    なし
    表 : 54. 返される内容
    タイプ 説明
    文字列 テーブルを識別するラベル。

    この例では渡されたテーブルのラベルを出力します。

    // Display the incident table label
var now_GR = new GlideRecord("incident");
var value = now_GR.getClassDisplayValue();
gs.info("The table label is " + value + ".");

    出力：

    The table label is Incident.

    スコープ対応

    スコープ対象のアプリケーションで getClassDisplayValue() メソッドを使用するには、対応するスコープ対象のメソッド getClassDisplayValue() を使用します。

    GlideRecord - getDisplayValue()

    現在のレコードの表示値を取得します。

    表示値は、データベース内の実際の値と、ユーザーやシステムの設定と環境設定に基づいて操作されます。

    返される表示値はフィールドタイプに依存します。
    • 選択肢フィールド：データベース値は数値にできますが、表示値の方がわかりやすくなります。
    • 日付フィールド：データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいたものになります。
    • 暗号化テキスト：データベース値は暗号化されますが、表示値はユーザーの暗号化コンテキストに基づいて非暗号化されます。
    • 参照フィールド：データベース値は sys_id ですが、表示値は参照レコードの表示フィールドになります。
    表 : 55. パラメーター
    名前 タイプ 説明
    なし
    表 : 56. 返される内容
    タイプ 説明
    文字列 現在のレコードの表示値。

    この例では、指定されたインシデントレコードの表示値をログに書き込みます。

    var now_GR = new GlideRecord('incident');
now_GR.get('sys_id','<sys_id>');
gs.info(now_GR.getDisplayValue());

    出力：

    INC0000050

    スコープ対応

    スコープ対象のアプリケーションで getDisplayValue() メソッドを使用するには、対応するスコープ対象のメソッド getDisplayValue() を使用します。

    GlideRecord - getED()

    要素の記述子を返します。

    表 : 57. パラメーター
    名前 タイプ 説明
    なし
    表 : 58. 返される内容
    タイプ 説明
    GlideElementDescriptor 要素の記述子。

    この例は、インシデント GlideRecord の名前フィールドを取得する方法を示しています。

    grInc = new GlideRecord('incident');
grInc.getActiveQuery();
grInc.query();
if (grInc.next())
  gs.info("Table Descriptor is - " + grInc.getED().getName());

    出力：

    Table Descriptor is - incident

    スコープ対応

    スコープ対象のアプリケーションで getED() メソッドを使用するには、対応するスコープ対象のメソッド getED() を使用します。

    GlideRecord - getElement(文字列 fieldName)

    指定されたフィールドの GlideElement を取得します。

    このメソッドによって返される値は、完全な GlideElement オブジェクトです。結果は、フィールド値をドット連結するのと同じです。たとえば、now_GR.getElement('short_description') は nowGR.short_descriptionと同じ結果を返します。

    ほとんどの場合、レコードから値を取得するためにドット連結を使用しないでください。ドット連結では、フィールド値ではなくオブジェクト全体が取得されます。オブジェクトを取得すると、より多くのストレージが使用されるため、配列または サービスポータルで使用すると望ましくない結果が生じる可能性があります。

    オブジェクト全体を取得する代わりに、次のいずれかのメソッドを使用してフィールド値をコピーできます。

    GlideElement オブジェクトのドット連結が必要な場合は、toString() メソッドを使用して値を取得します。たとえば、別の参照フィールドを設定するために、現在の問い合わせユーザーのマネージャーの sys_id が必要な場合があります。次の例は、オブジェクト全体の代わりに文字列値を取得する方法を示しています。
    var mgr = current.caller_id.manager.toString();

    関連項目：GlideElement - toString()。

    表 : 59. パラメーター
    名前 タイプ 説明
    fieldName 文字列 GlideElement オブジェクトを返す対象の列名。
    表 : 60. 返される内容
    タイプ 説明
    GlideElement 現在のレコードの指定された列の GlideElement。各オブジェクトは、現在の GlideRecord のフィールドを記述します。

    この例では、渡されたテーブルの GlideElement オブジェクトを取得し、それらを予想されるシステムのメタデータ値と比較する方法を示します。

    function compareElement(comment, table, element, /*{}*/ expected) {
  var now_GR = new GlideRecord(table);
  var el = now_GR.getElement(element);
  for (var n in expected) {
    assertEquals(comment + ":" + table + "." + element, expected[n], el.sys_meta[n]);
  }
}

    スコープ対応

    スコープ対象のアプリケーションで getElement() メソッドを使用するには、対応するスコープ対象のメソッド getElement() を使用します。

    GlideRecord - getEncodedQuery()

    現在の結果セットのクエリ条件をエンコードされたクエリ文字列として取得します。

    詳しくは、 エンコードされたクエリ文字列を参照してください 。

    表 : 61. パラメーター
    名前 タイプ 説明
    なし
    表 : 62. 返される内容
    タイプ 説明
    文字列

    この例は、後で読み取り ACL ロールを作成するために使用する、現在のエンコードクエリを取得する方法を示しています。

    function createAcl(table, role) {
  gs.print("Checking security on table " + table);
  var now_GR = new GlideRecord("sys_security_acl");
  now_GR.addQuery("name", table);
  now_GR.addQuery("operation", "read");
  now_GR.query();
  var encQuery = now_GR.getEncodedQuery();
  if (now_GR.next()) {
    // existing acl found so use it
    createAclRole(now_GR.sys_id.toString(), role);
   return;
  } else {
    now_GR.initialize();
    now_GR.applyEncodedQuery(encQuery);
    var acl = now_GR.insert();
    gs.print("   Added read access control on " + table);
    createAclRole(acl, role);
  }
}

    スコープ対応

    スコープ対象のアプリケーションで getEncodedQuery() メソッドを使用するには、対応するスコープ対象のメソッド getEncodedQuery() を使用します。

    GlideRecord - getEscapedDisplayValue()

    現在のレコードの表示フィールドに対するフィールド値を取得し、Jelly スクリプトで使用するエスケープ文字を追加します。

    注:
    このメソッドを使用するには、関連するテーブルに表示値を設定する必要があります。これを行う方法については、 テーブルの表示値としてフィールドを選択する。
    表 : 63. パラメーター
    名前 タイプ 説明
    なし
    表 : 64. 返される内容
    タイプ 説明
    文字列 現在のテーブルの表示フィールドのエスケープ値。

    この例では、ユーザー [sys_user] テーブルから user_name のエスケープされた表示値を取得する方法を示します。

    var userName = "Michael J'ones";
var now_GR = new GlideRecord("sys_user");
if (now_GR.get("user_name", userName)) {
  gs.print("Deleting existing user=" + userName);
  now_GR.deleteRecord();
}
now_GR.initialize();

var name = userName.split(" ", 2);
var firstName = name[0];
var lastName = name[1];
now_GR.setValue("user_name", userName);
gs.print("Name: " + now_GR.getValue("user_name"));
now_GR.setValue("first_name", firstName);
now_GR.setValue("last_name", lastName);
var escapeValue = now_GR.getEscapedDisplayValue();
gs.print("Escaped name: " + escapeValue);

    出力:

    Name: Michael J'ones
Escaped name: Michael J\'ones

    GlideRecord - getFields()

    現在のレコード内のフィールドの Java ArrayList を取得します。

    表 : 65. パラメーター
    名前 タイプ 説明
    なし
    表 : 66. 返される内容
    タイプ 説明
    Java ArrayList 現在のレコード内のフィールド 
    // This can be run in "Scripts - Background" for demonstration purposes
 
// Get a single incident record
var grINC = new GlideRecord('incident');
grINC.query();
grINC.next();
gs.print('Using ' + grINC.getValue('number'));
gs.print('');
 
// getFields() returns a Java ArrayList
var fields = grINC.getFields();
 
// Enumerate GlideElements in the GlideRecord object that have values
gs.print('Enumerating over all fields with values:');
for (var i = 0; i < fields.size(); i++) {
  var glideElement = fields.get(i);
  if (glideElement.hasValue()) {
    gs.print('  ' + glideElement.getName() + '\t' + glideElement);
  }
}
gs.print('');
 
// Get a specific GlideElement: number
gs.print('Getting the number field:');
for (var i = 0; i < fields.size(); i++) {
  var glideElement = fields.get(i);
  if (glideElement.hasValue() && glideElement.getName() == 'number') {
    gs.print('  ' + glideElement.getName() + '\t' + glideElement);
  }
}

    GlideRecord - getLabel()

    フィールドのラベルを取得します。

    表 : 67. パラメーター
    名前 タイプ 説明
    なし
    表 : 68. 返される内容
    タイプ 説明
    文字列 フィールドのラベル

    この例は、要求アイテムテーブルの質問フィールドのラベルを取得し、ラベルとその表示名を出力する方法を示しています。

    template.print("Summary of Requested items:\n");  
var now_GR = new GlideRecord("sc_req_item");
now_GR.addQuery("request", current.sysapproval);
now_GR.query();
while(now_GR.next()) {
var nicePrice = now_GR.price.toString();
    if (nicePrice != '') {
        nicePrice = parseFloat(nicePrice);
        nicePrice = nicePrice.toFixed(2);
    }
    template.print(now_GR.number + ":  " + now_GR.quantity + " X " + now_GR.cat_item.getDisplayValue() 
                     + " at $" + nicePrice + " each \n");
    template.print("    Options:\n");
    for (key in now_GR.variables) {
    var now_V = now_GR.variables[key];
      if(now_V.getGlideObject().getQuestion().getLabel() != '') {
         template.space(4);
         template.print('     ' + now_V.getGlideObject().getQuestion().getLabel() + " = " 
                     + vnow_V.getDisplayValue() + "\n");  
      }
    }
}

    スコープ対応

    スコープ対象のアプリケーションで getLabel() メソッドを使用するには、対応するスコープ対象のメソッド getLabel() を使用します。

    GlideRecord - getLocation()

    テーブル内の現在のレコードの行番号を取得します。

    表 : 71. パラメーター
    名前 タイプ 説明
    なし
    表 : 72. 返される内容
    タイプ 説明
    数値 テーブル内の現在のレコードに対するゼロベースの行番号を取得します。

    この例は、レコード数をレコードの場所番号と比較することによって、インシデントテーブル内のレコードが適切に取得されていないかどうかを確認する方法を示しています。

    var now_GR = new GlideRecord("incident");
now_GR.addQuery("priority", "4");
now_GR.query();
for (x=0; x <4; x++) {
  now_GR.next();
  gs.print("Location value: " + now_GR.getLocation());
}

    出力:

    Location value: 0
Location value: 1
Location value: 2
Location value: 3

    GlideRecord - getPlural()

    GlideRecord テーブルの複数形ラベルを取得します。

    たとえば、テーブル名が「変更要求」の場合、このメソッドは「変更要求」を返します。

    表 : 73. パラメーター
    名前 タイプ 説明
    なし
    表 : 74. 返される内容
    タイプ 説明
    文字列 GlideRecord のテーブルの複数形ラベル。

    この例では、インシデントテーブルの getLabel() と getPlural() の戻り値を確認しています。

    var now_GR = new GlideRecord('incident');
gs.print(now_GR.getLabel());
if (now_GR.getLabel() != 'Incident')
throw "GlideRecord.getLabel() returned unexpected value for table 'incident': " + now_GR.getLabel();

gs.print(now_GR.getPlural());
if (now_GR.getPlural() != 'Incidents')
throw "GlideRecord.getPlural() returned unexpected value for table 'incident': " + now_GR.getPlural();
"success";

    スコープ対応

    スコープ対象のアプリケーションで getPlural() メソッドを使用するには、スコープ対象の GlideRecord.getED() メソッドを使用してフィールドの記述子を取得してから、スコープ対象の GlideElementDescriptor.getPlural() メソッドを使用します。GlideRecord - getED()

    GlideRecord - getRecordClassName()

    現在のレコードのクラス (テーブル) 名を取得します。

    表 : 75. パラメーター
    名前 タイプ 説明
    なし
    表 : 76. 返される内容
    タイプ 説明
    文字列 クラスまたはテーブル名 
    function TaskAssignmentFilter() {
  var classname = current.getRecordClassName();
  var filter = "type=null";
  if (classname == "incident" && current.category == "database") {
    filter = GetGroupFilter("database");
  }
  else {
    // append exclusion for 'catalog' to the filter
    var cat = new GlideRecord("sys_user_group_type");  
    cat.addQuery("name", "catalog");
    cat.query();
    if (cat.next()) {
      filter += "^ORtype!=" + cat.sys_id;
    }
  }
  gs.log("TaskAssignmentFilter: " + filter);
  return filter;
}

    スコープ対応

    スコープ対象のアプリケーションで getRecordClassName() メソッドを使用するには、対応するスコープ対象のメソッド getRecordClassName() を使用します。

    GlideRecord - getRelatedLists()

    現在の GlideRecord に関連付けられている関連リストの名前と表示値のリストを取得します。

    表 : 77. パラメーター
    名前 タイプ 説明
    なし
    表 : 78. 返される内容
    タイプ 説明
    HashMap 関連リストの名前と表示値を含むハッシュマップ。

    この例は、現在の GlideRecord に関連付けられている関連リストの名前と表示値のリストを取得し、それらをアレイに格納してから、その値を出力する方法を示しています。

    var now_GR = new GlideRecord('incident');
var c = now_GR.getRelatedLists().values().toArray();
var numElements = c.length;
for( var i = 0; i < numElements; ++i){
  gs.print(i+": "+c[i]);
}

    GlideRecord - getRelatedTables()

    現在のレコードによって参照されるテーブルの名前と表示値のリストを取得します。

    表 : 79. パラメーター
    名前 タイプ 説明
    なし
    表 : 80. 返される内容
    タイプ 説明
    HashMap 関連テーブルの名前と表示値を含むハッシュマップ。

    この例は、現在の GlideRecord に関連するテーブルの名前と表示値のリストを取得し、それらをアレイに格納してから、その値を出力する方法を示しています。

    var now_GR = new GlideRecord('incident');
var c = now_GR.getRelatedTables().values().toArray();
var numElements = c.length;
for( var i = 0; i < numElements; ++i){
  gs.print(i+": "+c[i]);
}

    GlideRecord - getRowCount()

    現在の GlideRecord オブジェクトの行数 (レコード) を取得します。

    注:
    GlideRecord は一致するレコードを返すため、レコード数のみが必要な場合は GlideAggregate ほど効率的ではない可能性があります。レコード数のみが必要で、一致するレコードを反復処理しない場合は、 GlideAggregate を使用します。
    GlideRecord または GlideAggregate の数値レコードの取得
    GlideRecord getRowCount() および GlideAggregate getAggregate() API も同様の情報を提供します。次の基準を使用して、最適なオプションを決定します。
    • GlideRecord getRowCount() メソッドは、クエリから返されたレコードの数とレコード自体を示します。レコードに対してアクションを実行するためにセットを反復処理する前後の結果セット内のレコード数が必要な場合は、このメソッドを使用します。
    • GlideAggregate getAggregate() メソッドは、実際のレコードを除いて、クエリに一致するレコードの数のみを取得します。集計は、クエリを発行する前に GlideAggregate オブジェクトに設定する必要があります。
    GlideRecord getRowCount() を使用したレコードとカウントの取得
    次の例は、 GlideRecord getRowCount() を使用してアクティブなインシデントの合計数を取得する方法を示しています。
    var incident = new GlideRecord("incident");
incident.addQuery("active", true);
incident.query();
 
gs.info("*** Total number of active incidents: {0}", incident.getRowCount());
    GlideAggregate getAggregate() を使用してレコードの数のみを取得する
    次の例は、レコードの数のみを返す方法を示しています。このメソッドは一致するレコードを使用しないため、集計クエリを使用してカウントのみを返す方がはるかに効率的です。
    var incident = new GlideAggregate("incident");
incident.addQuery("active", true);
incident.addAggregate("COUNT");
incident.query();
 
if (incident.next())
    gs.info("*** Total number of active incidents: {0}", incident.getAggregate("COUNT"));
    ソリューションに最適なオプションの決定

    レコードの数のみを取得する場合は、 GlideAggregate getAggregate() メソッドが最適です。個々のレコードを使用して結果の数を取得するには、 GlideRecord getRowCount() を使用します。1 つのクエリでこの機能が提供されます。

    表 : 81. パラメーター
    名前 タイプ 説明
    なし
    表 : 82. 返される内容
    タイプ 説明
    数値 現在の GlideRecord の行数。

    次の例は、インシデント [incident] テーブルからインシデントの数を取得する方法を示しています。

    var numberOfIncidents = new GlideRecord('incident');
numberOfIncidents.query();
gs.info("Records in incident table: " + numberOfIncidents.getRowCount());

    出力:

    Records in incident table: 6920

    スコープ対応

    スコープ対象のアプリケーションで getRowCount() メソッドを使用するには、対応するスコープ対象のメソッド getRowCount() を使用します。

    GlideRecord - getRowNumber()

    saveLocation() または setLocation() によって設定された行番号を取得します。

    現在の行番号を取得するには、getLocation() を使用します。

    表 : 83. パラメーター
    名前 タイプ 説明
    なし
    表 : 84. 返される内容
    タイプ 説明
    数値 保存された行番号。

    この例は、ユーザーテーブルの行の場所を保存し、その行番号を取得する方法を示しています。

    var now_GR = new GlideRecord('sys_user');
now_GR.addQuery();
now_GR.query();
now_GR.saveLocation(5);
var savedRow = now_GR.getRowNumber();
gs.print("Saved row: " + savedRow);

    出力:

    Saved row: 5

    GlideRecord - getTableName()

    この GlideRecord に関連付けられたテーブル名を取得します。

    表 : 85. パラメーター
    名前 タイプ 説明
    なし
    表 : 86. 返される内容
    タイプ 説明
    文字列 テーブル名

    この例は、現在のテーブル名をシステム ログに書き込む方法を示しています。

    gs.log('Table: ' + current.getTableName()); 
gs.log('Parent: ' + current.parent.sys_id); 
var item = new GlideRecord('sc_req_item'); 
item.addQuery('sys_id', current.parent.sys_id); 
item.query(); 
if(item.next()){ 
  for(var variable in item.variable_pool) {
    gs.log(variable); 
    var answer = eval ("item.variable_pool." + variable + ".getDisplayValue()");
    gs.log(answer);
  }
}

    スコープ対応

    スコープ対象のアプリケーションで getTableName() メソッドを使用するには、対応するスコープ対象のメソッド getTableName() を使用します。

    GlideRecord - getUniqueValue()

    レコードのプライマリキーを取得します。特に指定しない限り、通常、これは sys_id です。

    表 : 87. パラメーター
    名前 タイプ 説明
    なし
    表 : 88. 返される内容
    タイプ 説明
    文字列 文字列としての一意のプライマリキー (キーが null の場合は null)。 
    var now_GR = new GlideRecord('kb_knowledge');
now_GR.query();
now_GR.next();
var uniqueid = now_GR.getUniqueValue();
gs.info(uniqueid);

    GlideRecord - getValue(文字列 fieldName)

    指定されたフィールドの文字列値を取得します。

    注:
    列レベル暗号化エンタープライズ プラグインが有効になっていて、インスタンスがキーにアクセスできる場合、このメソッドは暗号化されたフィールドからクリアテキスト値を返します。インスタンスがキーにアクセスできない場合、このメソッドは暗号化された値を返します。詳細については、「 プラットフォームの暗号化」を参照してください。
    表 : 89. パラメーター
    名前 タイプ 説明
    fieldName 文字列 値を取得するフィールドの名前。
    表 : 90. 返される内容
    タイプ 説明
    文字列 指定された要素の値。フィールドが空の場合またはフィールドが存在しない場合は null を返します。
    注:
    ブーリアン値は、false および true ではなく「0」および「1」の文字列値として返されます。

    この例では、getValue() メソッドを使用して、比較されている 2 つの GlideRecord のフィールド値を取得します。

    function() {
  var jobExists = true;
  var jobGr;
  while(jobExists){
    jobGr = new GlideRecord("sys_trigger");
    jobExists = jobGr.get("name", "BaselineAPI: Create Baseline Job");
  }
  var baselineGr =  new GlideRecord('pm_project_baseline');
  baselineGr.get('baseline_name','Test Project Baseline');
  baselineGr.query();
 
  Assert.assertEquals(true, baselineGr.next());
  var projectGr =  new GlideRecord('pm_project');
  projectGr.get(this._project);
  Assert.assertEquals(projectGr.getValue('cost'), baselineGr.getValue('cost'));
  Assert.assertEquals((projectGr.getValue('capex_cost')), baselineGr.getValue('capex_cost'));
  Assert.assertEquals((projectGr.getValue('opex_cost')), baselineGr.getValue('opex_cost'));
  Assert.assertEquals((projectGr.getValue('budget_cost')), baselineGr.getValue('budget_cost'));
  Assert.assertEquals((projectGr.getValue('value')), baselineGr.getValue('value'));
  Assert.assertEquals((projectGr.getValue('npv_value')), baselineGr.getValue('npv_value'));  Assert.assertEquals((projectGr.getValue('score')), baselineGr.getValue('score'));
}

    スコープ対応

    スコープ対象のアプリケーションで getValue() メソッドを使用するには、対応するスコープ対象のメソッド getValue() を使用します。

    GlideRecord - GlideRecord(文字列 tableName)

    指定されたテーブルの GlideRecord クラスのインスタンスを作成します。

    表 : 91. パラメーター
    名前 タイプ 説明
    tableName 文字列 使用するテーブル。 
    var now_GR = new GlideRecord('incident');

    GlideRecord - hasAttachments()

    現在の GlideRecord に添付ファイルがあるかどうかを判断します。

    表 : 92. パラメーター
    名前 タイプ 説明
    なし
    表 : 93. 返される内容
    タイプ 説明
    ブーリアン 現在のレコードに添付ファイルがある場合は true、ない場合は false。

    この例では添付ファイルを確認し、ある場合はリンクを作成します。

    var attachment_link = '';
var rec = new GlideRecord('sc_req_item');
rec.addQuery('sys_id', current.request_item);
rec.query();
if(rec.next()){
  if(rec.hasAttachments()){
    attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
  }   
}

    GlideRecord - hasNext()

    GlideRecord にまだレコードがあるかどうかを判断します。

    表 : 94. パラメーター
    名前 タイプ 説明
    なし
    表 : 95. 返される内容
    タイプ 説明
    ブーリアン クエリセットにさらにレコードがある場合は true、ない場合は false。

    この例では、現在の GlideRecord に追加のレコードがあるかどうかに基づいてさまざまな関数を呼び出す方法を示します。

    if (now_GR.hasNext()) {
  dothis(); // found it, do it
} else {
  dothat(); // didn't find it
};

    スコープ対応

    スコープ対象のアプリケーションで hasNext() メソッドを使用するには、対応するスコープ対象のメソッド hasNext() を使用します。

    GlideRecord - initialize()

    挿入前に入力するのに適した空のレコードを現在の GlideRecord 内に作成します。

    表 : 96. パラメーター
    名前 タイプ 説明
    なし
    表 : 97. 返される内容
    タイプ 説明
    なし

    この例では to_do テーブルの新しいレコードを初期化し、レコードを作成してからテーブルに挿入します。

    var now_GR = new GlideRecord('to_do');
now_GR.initialize(); 
now_GR.name = 'first to do item'; 
now_GR.description = 'learn about GlideRecord'; 
now_GR.insert();

    スコープ対応

    スコープ対象のアプリケーションで initialize() メソッドを使用するには、対応するスコープ対象のメソッド initialize() を使用します。

    GlideRecord - insert()

    現在のレコードに設定されているフィールド値を使用して、新しいレコードを挿入します。

    表 : 98. パラメーター
    名前 タイプ 説明
    なし
    表 : 99. 返される内容
    タイプ 説明
    文字列 挿入されたレコードの sys_id。レコードが挿入されない場合は null。

    この例では to_do テーブルに新しいレコードを作成し、いくつかのレコードフィールドに値を設定してからレコードをテーブルに挿入します。

    var now_GR = new GlideRecord('to_do');
now_GR.initialize(); 
now_GR.name = 'first to do item'; 
now_GR.description = 'learn about GlideRecord'; 
now_GR.insert();

    スコープ対応

    スコープ対象のアプリケーションで insert() メソッドを使用するには、対応するスコープ対象のメソッド insert() を使用します。

    GlideRecord - insertWithReferences()

    新しいレコードを挿入し、指定された情報で関連レコードを挿入または更新します。

    表 : 100. パラメーター
    名前 タイプ 説明
    なし
    表 : 101. 返される内容
    タイプ 説明
    文字列 挿入されたレコードの sys_id。レコードが挿入されなかった場合は null。

    参照値が指定されていない場合 (以下を参照)、指定された first_name と last_name で新しいユーザーレコードが作成され、caller_id 値がこの新しく作成された sys_user レコードに設定されます。結果は、指定された first_name と last_name を使用する新しい sys_user レコードと、指定された short_description と caller_id を使用する新しいインシデントレコードです。

    var inc = new GlideRecord('incident');
inc.initialize();
inc.short_description = 'New incident 1';
inc.caller_id.first_name = 'John';
inc.caller_id.last_name = 'Doe';
inc.insertWithReferences();

    caller_id 値が指定されている場合、その caller_id は指定された first_name と last_name で更新されます。結果は、short_description と caller_id に値が設定された、新しく作成されたインシデントレコードです。

    var inc = new GlideRecord('incident');
inc.initialize();
inc.short_description = 'New incident 1';
inc.caller_id.setDisplayValue('David Loo');
inc.caller_id.first_name = 'John';
inc.caller_id.last_name = 'Doe';
inc.insertWithReferences();

    GlideRecord - instanceOf(文字列 className)

    テーブルのタイプ/クラスを確認します。

    表 : 102. パラメーター
    名前 タイプ 説明
    className 文字列 レコードのタイプまたはクラスの名前。
    表 : 103. 返される内容
    タイプ 説明
    ブーリアン テーブルが指定されたクラスのインスタンスである場合は true。

    この例では、渡されたグループ/ユーザーが sys_user テーブル/クラスタイプであるかどうかを確認します。

    function(groupOrUser, label, grantedBy) {
  var labelCheck;
  var labelRecord;
  if (typeof label === "string") {
    labelRecord = new GlideRecord('label');
    labelRecord.addQuery('name', label);
    labelRecord.query();
    labelRecord.next();
  } else {
    labelRecord = label;
  }
  if (groupOrUser.instanceOf('sys_user')) {
    labelCheck = new GlideRecord('label_user_m2m');
    labelCheck.addQuery('user', groupOrUser.sys_id);
  } else {
    labelCheck = new GlideRecord('label_group_m2m');
    labelCheck.addQuery('group', groupOrUser.sys_id);
  }
  labelCheck.addQuery('label', labelRecord.sys_id);
  if (grantedBy !== "undefined") {
    labelCheck.addQuery('granted_by', grantedBy.sys_id);
  }
  labelCheck.query();
  return labelCheck.hasNext();
}

    GlideRecord - isNewRecord()

    現在のレコードがデータベースに挿入されているかどうかを判断します。

    このメソッドは newRecord() メソッドが呼び出された場合にのみ true を返します。このメソッドは、スクリプト化された ACL や UI アクションの条件に便利ですが、バックグラウンドスクリプトでは使用しないでください。

    注:
    このメソッドはビジネスルールの実行中に新しいレコードに対して true を返します。または、newRecord() メソッドを使用してデフォルト値と一意の ID (sys_id) を使用してレコードを初期化します。それ以外の場合は false を返します。
    表 : 104. パラメーター
    名前 タイプ 説明
    なし
    表 : 105. 返される内容
    タイプ 説明
    ブーリアン 現在のレコードが新しい (データベースに挿入されていない) かどうかを示すフラグ。
    可能な値：
    • true：レコードは新規です。
    • false：レコードは新規ではありません。

    この例では、新しいレコードが sys_user テーブルに挿入されているかどうかを確認します。

    var now_GR = new GlideRecord("sys_user");
now_GR.newRecord();
now_GR.setValue("user_name", "John Smith");
gs.print("Is this a new record: " + now_GR.isNewRecord());

var now_GR2 = new GlideRecord("sys_user");
now_GR2.addQuery("user_name", "Abel Tutor");
now_GR2.query();
now_GR2.next();
gs.print("Is this a new record: " + now_GR2.isNewRecord());

    GlideRecord - isValid()

    現在の GlideRecord テーブルが存在するかどうかを判断します。

    表 : 106. パラメーター
    名前 タイプ 説明
    なし
    表 : 107. 返される内容
    タイプ 説明
    ブーリアン テーブルが存在する (有効な) 場合は true、それ以外の場合は false。

    この例ではインシデントテーブルが存在するかどうかを確認します。

    var testTable = new GlideRecord('incident');
gs.print(testTable.isValid());

    スコープ対応

    スコープ対象のアプリケーションで isValid() メソッドを使用するには、対応するスコープ対象の isValid() メソッドを使用します。

    GlideRecord - isValidField(文字列 fieldName)

    指定されたフィールドが現在の GlideRecord テーブルで定義されているかどうかを判断します。

    表 : 108. パラメーター
    名前 タイプ 説明
    fieldName 文字列 確認するフィールドの名前。
    表 : 109. 返される内容
    タイプ 説明
    ブーリアン フィールドがテーブルで定義されている場合は true、されていない場合は false。

    この例では、[sys_class_name] フィールドが cmds_software_instance テーブルに存在するかどうかを確認します。

    var gobj = new GlideRecord('sys_db_object');
gobj.addQuery('name','cmdb_software_instance');
gobj.query();
if (!gobj.next()) {
  var si = new GlideRecord('cmdb_software_instance');
  si.query();
  var count = 0;
  while (si.next()) {
    if (!si.isValidField('sys_class_name')) {
      var ci = new GlideRecord('cmdb_ci');
      ci.name = si.name;
      ci.setNewGuidValue(si.sys_id);
      ci.sys_class_name = 'cmdb_software_instance';
      ci.insert();
      count++;
    }
  }
}

    スコープ対応

    スコープ対象のアプリケーションで isValidField() メソッドを使用するには、対応するスコープ対象のメソッド isValidField() メソッドを使用します。

    GlideRecord - isValidRecord()

    現在のレコードが有効かどうかを判定します。

    表 : 110. パラメーター
    名前 タイプ 説明
    なし
    表 : 111. 返される内容
    タイプ 説明
    ブーリアン 現在のレコードが有効かどうかを示すフラグ。
    有効な値：
    • true：レコードは有効です。
    • false：レコードセットの終わりを過ぎています。

    この例では、渡された sys_id によるレコード識別子がアイデアテーブル内の有効なレコードであるかどうかを確認します。

    function(sysId) {
  this.log('Inside acceptIdea sysId = ' + sysId);
  var now_GR = new GlideRecord('idea');
  now_GR.get(sysId);
  this.log('now_GR.isValidRecord() = ' + now_GR.isValidRecord());
  if(now_GR.isValidRecord()) {
    now_GR.setValue('state', 2);
    this.log('Updating gliderecord');
    this.log('gliderecord table name' + now_GR.getTableName());
    now_GR.update();
  }
}

    スコープ対応

    スコープ対象のアプリケーションで isValidRecord() メソッドを使用するには、対応するスコープ対象のメソッド isValidRecord() を使用します。

    GlideRecord - newRecord()

    GlideRecord を作成し、フィールドのデフォルト値を設定して、レコードに一意の ID を割り当てます。

    表 : 112. パラメーター
    名前 タイプ 説明
    なし
    表 : 113. 返される内容
    タイプ 説明
    なし

    この例では、新しいレコードが sys_user テーブルに挿入されているかどうかを確認します。

    var now_GR = new GlideRecord("sys_user");
now_GR.newRecord();
now_GR.setValue("user_name", "John Smith");
gs.print("Is this a new record: " + now_GR.isNewRecord());

var now_GR2 = new GlideRecord("sys_user");
now_GR2.addQuery("user_name", "Abel Tutor");
now_GR2.query();
now_GR2.next();
gs.print("Is this a new record: " + now_GR2.isNewRecord());

    スコープ対応

    スコープ対象のアプリケーションで newRecord() メソッドを使用するには、対応するスコープ対象のメソッド newRecord() を使用します。

    GlideRecord - next()

    GlideRecord の次のレコードに移動します。

    このメソッドを使用して、GlideRecord クエリによって返されたレコードを反復処理します。

    注:
    テーブルに「next」と呼ばれるフィールドがある場合、このメソッドは失敗します。その場合は、_next() メソッドを使用します。
    注:
    if(myObj.next()) 構成は、返された最初のレコードのみを処理します。
    表 : 114. パラメーター
    名前 タイプ 説明
    なし
    表 : 115. 返される内容
    タイプ 説明
    ブーリアン GlideRecord に「next」レコードがあるかどうかを示すフラグ。
    有効な値：
    • true：次のレコードへの移動に成功しました。
    • false：結果セットにそれ以上の結果は含まれていません。

    この例は、next() メソッドを使用してインシデントテーブルを反復処理する方法を示しています。

    var rec = new GlideRecord('incident');
rec.query();
while (rec.next()) { 
  gs.print(rec.number + ' exists');
}

    スコープ対応

    スコープ対象のアプリケーションで next() メソッドを使用するには、対応するスコープ対象のメソッド next() を使用します。

    GlideRecord - _next()

    GlideRecord の次のレコードに移動します。GlideRecord に next という名前の列がある場合に使用する目的で、next() と同じ機能を提供します。

    表 : 116. パラメーター
    名前 タイプ 説明
    なし
    表 : 117. 返される内容
    タイプ 説明
    ブーリアン クエリセットにさらにレコードがある場合は true。 
    var rec = new GlideRecord('sys_template');
rec.query();
while (rec._next()) { 
  gs.print(rec.number + ' exists');
}

    スコープ対応

    スコープ対象のアプリケーションで _next() メソッドを使用するには、対応するスコープ対象のメソッド _next() を使用します。

    GlideRecord - operation()

    操作が挿入、更新、または削除のいずれであるかを決定します。

    操作が分かれば、current.operation() を使用して、各操作を一意に処理できる汎用ビジネスルールを作成できます。

    グローバル変数 current の使用方法については、 ビジネスルールでのグローバル変数を参照してください。

    表 : 118. パラメーター
    名前 タイプ 説明
    なし
    表 : 119. 返される内容
    タイプ 説明
    文字列 現在の操作。
    可能な値：
    • delete
    • insert
    • update

    次の例は、ビジネスルールでこのメソッドを使用する方法を示しています。Operation() メソッドは、どの操作がイベントをトリガーしたかを検出し、更新操作と挿入操作に応じて異なるアクションを実行します。

    if(current.operation() == "update") {
  current.updates ++; } 
if(current.operation() == "insert") {
  current.updates = 0; }

    この例は、operation() メソッドを使用して操作の値を startFlow() メソッドに渡す方法を示しています。

    function createNewTransferOrder() {
  var toGr = new GlideRecord("alm_transfer_order");
  toGr.initialize();
  // From Stockroom - Southern California Warehouse
  toGr.setValue('from_stockroom', fromStockroomSysId);
  // To Stockroom - San Diego North - Pickup/Dropoff
  toGr.setValue('to_stockroom', toStockroomSysId);
  var transferOrder = toGr.insert();

  if(toGr.get(transferOrder)){
  // Start Transfer Order Workflow
  var wf = new Workflow();
  var context = wf.startFlow(toWorkflowSysId, toGr, toGr.operation(),{});
    createNewTransferOrderLine(transferOrder);
  } 
}

    スコープ対応

    スコープ対象のアプリケーションで operation() メソッドを使用するには、対応するスコープ対象のメソッド operation() を使用します。

    GlideRecord - orderBy(文字列 fieldName)

    クエリセットを並べ替えるために使用するフィールド名を指定します。複数のフィールドで並べ替えるには、このメソッドを異なるフィールド値で複数回呼び出します。

    表 : 120. パラメーター
    名前 タイプ 説明
    fieldName 文字列 クエリセットを並べ替えるフィールド。
    表 : 121. 返される内容
    タイプ 説明
    なし

    この例は、「order」の次に「number」で設定されたクエリを並べ替える方法を示しています。

    function UpdateProjectWBS(project) {
  var count = 0;
  var child = new GlideRecord('pm_project_task');
  child.addQuery('parent', project.sys_id);
  child.orderBy('order');
  child.orderBy('number');
  child.query();
  var len = child.getRowCount().toString().length;
  var seq = 0;
  while (child.next()) {
    count += UpdateProjectTaskWBS(child, 1, ++seq, len, '');
  }
  gs.addInfoMessage(count + ' Project Tasks updated');
}

    スコープ対応

    スコープ対象のアプリケーションで orderBy() メソッドを使用するには、対応するスコープ対象のメソッド orderBy() を使用します。

    GlideRecord - orderByDesc(文字列 fieldName)

    クエリセットを降順で並べ替えるために使用するフィールドを指定します。

    表 : 122. パラメーター
    名前 タイプ 説明
    fieldName 文字列 クエリ結果を降順で並べ替えるために使用するフィールドの名前。
    表 : 123. 返される内容
    タイプ 説明
    なし

    この例ではクエリセットを昇順または降順で並べ替える方法を示します。

    function(fiscalType, orderByDesc) {
  var now_GR = new GlideRecord('fiscal_period');
  now_GR.addQuery('fiscal_type', fiscalType);
  if (orderByDesc) {
    now_GR.orderByDesc('fiscal_start_date_time');
  } else {
    now_GR.orderBy('fiscal_start_date_time');
  }
  now_GR.setLimit(1);
  now_GR.query();
  now_GR.next();
  return now_GR.sys_id;
}

    スコープ対応

    スコープ対象のアプリケーションで orderByDesc() メソッドを使用するには、対応するスコープ対象のメソッド orderByDesc() を使用します。

    GlideRecord - query(文字列 field, 文字列 value)

    addQuery() や addEncodedQuery() などのクエリメソッドで指定されたフィルターに基づいてテーブルに対してクエリを実行します。

    このメソッドは、GlideRecord テーブルおよびそのテーブルの参照に対してクエリを実行します。詳細については、「 スクリプトでのテーブルのクエリ」を参照してください。

    注:
    テーブルに「query」と呼ばれるフィールドがある場合、このメソッドは失敗します。その場合は、 メソッド _query() を使用します。ドメイン分離されたインスタンスでクエリを実行するには、queryNoDomain() メソッドを使用します。

    クエリの構築と実行の詳細については、GlideRecord についての記事を参照してください。

    関連項目：
    表 : 124. パラメーター
    名前 タイプ 説明
    name 文字列 オプション - 値パラメーターも指定する必要があります。value パラメーターで指定された値を検索するフィールドの名前。
    注:
    通常、このメソッドは引数なしで実行されますが、名前と値のペアを指定して、指定した値を含むレコードをフィルタリングできます。パラメーターが指定されている場合、「name=value」条件がクエリに追加されます。
    value 文字列 オプション - field パラメーターも指定する必要があります。指定された field パラメーターで検索する値。
    表 : 125. 返される内容
    タイプ 説明
    なし

    次の例は、クエリフィールドを含むテーブルのシステムディクショナリ [sys_dictionary] をスキャンする方法を示しています。

    var tableArr = [];

var now_GR = new GlideRecord('sys_dictionary');
now_GR.addQuery('element', 'query');
now_GR.setLimit(6);

now_GR.query();

while(now_GR.next()){
   tableArr.push(now_GR.name.getValue());
};

gs.info('The following tables have a field column called "query":');

for (i = 0; i < tableArr.length; i++) {
   gs.info(tableArr[i]);
};

    出力：

    The following tables have a field column called "query":
cmdb_convert_bulk_services
cmdb_multisource_query_status
cmdb_qb_result_base
cmdb_qb_table_mapping
discovery_probes_cim_query
kb_feedback

    スコープ対応

    スコープ対象のアプリケーションで query() メソッドを使用するには、対応するスコープ対象のメソッド query() を使用します。

    GlideRecord - _query(文字列 field, 文字列 value)

    addQuery() や addEncodedQuery() などのクエリメソッドで指定されたフィルターに基づいてテーブルに対してクエリを実行します。 このメソッドは、「query」という名前の列があるテーブルで使用するためのものです。このような列のために、query() メソッドの実行中にエラーが発生する可能性があります。

    このメソッドは、GlideRecord テーブルおよびそのテーブルの参照に対してクエリを実行します。詳細については、「 スクリプトでのテーブルのクエリ」を参照してください。

    クエリの構築と実行の詳細については、GlideRecord についての記事を参照してください。

    関連項目：
    表 : 126. パラメーター
    名前 タイプ 説明
    name 文字列 オプション - 値パラメーターも指定する必要があります。value パラメーターで指定された値を検索するフィールドの名前。
    注:
    通常、このメソッドは引数なしで実行されますが、名前と値のペアを指定して、指定した値を含むレコードをフィルタリングできます。パラメーターが指定されている場合、「name=value」条件がクエリに追加されます。
    value 文字列 オプション - field パラメーターも指定する必要があります。指定された field パラメーターで検索する値。
    表 : 127. 返される内容
    タイプ 説明
    なし

    次の例は、ナレッジフィードバック [kb_feedback] テーブルをクエリし、Excel を含むコメントがある KB 記事をリストする方法を示しています。

    var rec = new GlideRecord('kb_feedback');
rec.addQuery('comments', 'CONTAINS', 'Excel');
rec._query();
while (rec.next()) { 
 gs.info(rec.getDisplayValue('article') + " comment: " + rec.getValue('comments'));
}

    出力:

    KB0000005 comment: 
	     Can you please add the version of Excel this applies to? All?
		
KB0000005 comment: 
	     Does this work for all Excel versions? OSX and Windows alike?

    スコープ対応

    スコープ対象のアプリケーションで _query() メソッドを使用するには、対応するスコープ対象のメソッド _query() を使用します。

    GlideRecord - queryNoDomain(文字列 field, 文字列 value)

    ドメイン分離インスタンスで使用されます。query() と同様に、addQuery() および addEncodedQuery() で指定されたフィルターに基づいてテーブルに対してクエリを実行しますが、ドメインは無視します。

    このメソッドは、GlideRecord テーブルおよびそのテーブルの参照に対してクエリを実行します。詳細については、「 スクリプトでのテーブルのクエリ」を参照してください。

    表 : 128. パラメーター
    名前 タイプ 説明
    name 文字列 オプション - 値パラメーターも指定する必要があります。value パラメーターで指定された値を検索するフィールドの名前。
    注:
    通常、このメソッドは引数なしで実行されますが、名前と値のペアを指定して、指定した値を含むレコードをフィルタリングできます。パラメーターが指定されている場合、「name=value」条件がクエリに追加されます。
    value 文字列 オプション - field パラメーターも指定する必要があります。指定された field パラメーターで検索する値。
    表 : 129. 返される内容
    タイプ 説明
    なし

    この例は、すべてのドメインのインシデントテーブルをクエリする方法を示しています。

    var rec = new GlideRecord('incident');
rec.queryNoDomain();
while (rec.next()) { 
 gs.print(rec.number + ' exists');
}

    GlideRecord - restoreLocation()

    現在のレコードを saveLocation() で保存されたレコードに設定します。saveLocation() が呼び出されていない場合、現在のレコードは GlideRecord の最初のレコードに設定されます。

    表 : 130. パラメーター
    名前 タイプ 説明
    なし
    表 : 131. 返される内容
    タイプ 説明
    なし

    この例は、現在のレコードの場所を保存し、次のレコードに移動してから、保存された場所に戻る方法を示しています。

    function() {
  var now_GR = new GlideRecord("incident");
  now_GR.query();
  now_GR.next();
  var firstID = now_GR.getValue("sys_id");
  now_GR.next();
  var restoreID = now_GR.getValue("sys_id");
  now_GR.saveLocation();
  now_GR.next();
  var lastID = now_GR.getValue("sys_id");
  now_GR.restoreLocation();
  now_GR.next();
  var thisID = now_GR.getValue("sys_id");
  var progress = "first id=" + firstID
    + "\n\t last id=" + lastID
    + "\n\t saved id=" + restoreID
    + "\n\t restored id=" + thisID;
  gs.print("Progress:\n\t" + progress);
}

    GlideRecord - saveLocation()

    現在の行番号を保存して、restoreLocation() メソッドを使用してこの場所に戻ることができるようにします。

    表 : 132. パラメーター
    名前 タイプ 説明
    なし
    表 : 133. 返される内容
    タイプ 説明
    なし

    この例は、現在のレコードの場所を保存し、次のレコードに移動してから、保存された場所に戻る方法を示しています。

    function() {
  var now_GR = new GlideRecord("incident");
  now_GR.query();
  now_GR.next();
  var firstID = now_GR.getValue("sys_id");
  now_GR.next();
  var restoreID = now_GR.getValue("sys_id");
  now_GR.saveLocation();
  now_GR.next();
  var lastID = now_GR.getValue("sys_id");
  now_GR.restoreLocation();
  now_GR.next();
  var thisID = now_GR.getValue("sys_id");
  var progress = "first id=" + firstID
    + "\n\t last id=" + lastID
    + "\n\t saved id=" + restoreID
    + "\n\t restored id=" + thisID;
  gs.print("Progress:\n\t" + progress);
}

    GlideRecord - setAbortAction(ブーリアン b)

    次のデータベースアクション (挿入、更新、削除) を中止するかどうかを示すフラグを設定します。

    onBefore ビジネスルールで使用して、データベースアクションが実行されないようにします。ビジネスルールは、setAbortAction() が呼び出された後も実行を続けます。setAbortAction() を呼び出しても、後続のビジネスルールの実行は停止されません。このメソッドを呼び出すと、データベースアクションの実行のみが防止されます。

    表 : 134. パラメーター
    名前 タイプ 説明
    b ブーリアン 次のアクションを中止する場合は true、次のアクションを許可する場合は false。
    表 : 135. 返される内容
    タイプ 説明
    なし 
    if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
  var start = current.u_date1.getGlideObject().getNumericValue();
  var end = current.u_date2.getGlideObject().getNumericValue();
  if (start > end) {
    gs.addInfoMessage('start must be before end');
    current.u_date1.setError('start must be before end');
    current.setAbortAction(true);
  }
}

    スコープ対応

    スコープ対象のアプリケーションで setAbortAction() メソッドを使用するには、対応するスコープ対象のメソッド setAbortAction() を使用します。

    GlideRecord - setDisplayValue(文字列 name, オブジェクト value)

    指定されたフィールドを指定された表示値に設定します。

    参照フィールドの場合、これはテーブルの表示値です。日付/時刻の場合、これは問い合わせユーザーの現在のタイムゾーンの時刻です。

    表 : 136. パラメーター
    名前 タイプ 説明
    name 文字列 表示値を設定するフィールドの名前。
    value オブジェクト 指定したフィールドの表示値。
    表 : 137. 返される内容
    タイプ 説明
    なし 
    var now_GR = new GlideRecord('incident');
now_GR.get('46f09e75a9fe198100f4ffd8d366d17b');
now_GR.setDisplayValue('opened_at','2011-02-13 4:30:00');
now_GR.update();

    GlideRecord - setForceUpdate(ブーリアン force)

    フィールドが変更されていない場合でもレコードを更新します。

    表 : 138. パラメーター
    名前 タイプ 説明
    force ブーリアン フィールドが変更されていない場合でも更新する場合は true、更新しない場合は false。
    表 : 139. 返される内容
    タイプ 説明
    なし

    この例は、itfm_cost_model テーブル内のレコードを変更せずに強制的に更新する方法を示しています。

    function() {
  gs.log("Update Script: Upgrade_cost_model_data.js started");
  var now_GR = new GlideRecord("itfm_cost_model");
  now_GR.initialize();
  now_GR.addNullQuery("source_table");
  now_GR.query();
  while (now_GR.next()) {
    now_GR.setForceUpdate(true);
    var sourceTable = getSourceTable(now_GR.getValue('clone_from'));
    if(sourceTable){
      now_GR.setValue("source_table", sourceTable);
      now_GR.setWorkflow(false);
      now_GR.update();
    }
  }
}

    GlideRecord - setLimit(数値 limit)

    クエリから GlideRecord で返すレコードの最大数を設定します。

    表 : 140. パラメーター
    名前 タイプ 説明
    limit 数値 フェッチするレコードの制限。
    表 : 141. 返される内容
    タイプ 説明
    なし

    この例では、クエリで返されるレコードの数を最大 10 に設定します。

    var now_GR = new GlideRecord('incident');
now_GR.orderByDesc('sys_created_on');
now_GR.setLimit(10);
now_GR.query();

    スコープ対応

    スコープ対象のアプリケーションで setLimit() メソッドを使用するには、対応するスコープ対象のメソッド setLimit() を使用します。

    GlideRecord - setLocation(数値 rowNumber)

    現在の行の場所を指定された値に設定します。

    表 : 142. パラメーター
    名前 タイプ 説明
    rowNumber 数値 現在の行として設定する行番号。
    表 : 143. 返される内容
    タイプ 説明
    なし

    この例は、インシデントテーブルにレコードの位置を設定する方法を示しています。

    verifySetLocation : function() {
  var now_GR = new GlideRecord("incident");
  now_GR.query();
  var recordIDs = new Array();
  while(now_GR.next()) {
  recordIDs.push(now_GR.getValue("sys_id"));
  }
  for (var ix = recordIDs.length - 1; ix >= 0; ix--) {
    now_GR.setLocation(ix);
    Assert.assertEquals(recordIDs[ix], now_GR.getValue("sys_id"),
      "The entry retrieved for the index " + ix + " is not valid");
  }
}

    GlideRecord - setNewGuid()

    新しい GUID を生成し、現在のレコードに対する一意の ID (sys_id) として設定します。

    この関数は新しいレコードにのみ適用されます。既存のレコードの GUID は変更できません。

    表 : 144. パラメーター
    名前 タイプ 説明
    なし
    表 : 145. 返される内容
    タイプ 説明
    文字列 現在のレコードの sys_id。

    この例では、新しいタスクレコードを作成し、その ID を task_rel_task テーブルに格納します。

    var task = new GlideRecord ('task');
var tsk_id = task.setNewGuid();
 
task.description = "Request: " + current.request.number;
task.description = task.description + "\n" + "Requested by: " + current.request.u_requested_by.name;
task.description = task.description + "\n" + "Requested for: " + current.request.u_requested_for.name;
task.description = task.description + "\n" + "Item: " + current.cat_item.name;
 
var now_GR = new GlideRecord ('task_rel_task');
//link the incident to the request
now_GR.parent = current.request;
now_GR.child = tsk_id;
now_GR.insert();

    GlideRecord - setNewGuidValue (文字列 guid)

    新しい GUID を生成し、新しいレコードを挿入するときに、現在のレコードに対する一意の ID として設定します。

    表 : 146. パラメーター
    名前 タイプ 説明
    guid 文字列 新しい GUID の値。
    表 : 147. 返される内容
    タイプ 説明
    なし

    この例では、新しい GUID を生成し、新しく作成された cmdb_software_instance レコードの一意の ID として設定します。

    var gobj = new GlideRecord('sys_db_object');
gobj.addQuery('name','cmdb_software_instance');
gobj.query();
if (!gobj.next()) {
  var si = new GlideRecord('cmdb_software_instance');
  si.query();
  var count = 0;
  while (si.next()) {
  if (!si.isValidField('sys_class_name')) {
    var ci = new GlideRecord('cmdb_ci');
    ci.name = si.name;
    ci.setNewGuidValue(si.sys_id);
    ci.sys_class_name = 'cmdb_software_instance';
    ci.insert();
    count++;
  }
}

    スコープ対応

    スコープ対象のアプリケーションで setNewGuidValue() メソッドを使用するには、対応するスコープ対象のメソッド setNewGuidValue() を使用します。

    GlideRecord - setQueryReferences(ブーリアン queryReferences)

    参照フィールドをクエリするときに、参照フィールドの表示名の使用を有効または無効にします。

    表 : 148. パラメーター
    名前 タイプ 説明
    queryReferences ブーリアン 生成するデータの時刻を示すフラグ。
    有効な値：
    • true：表示名の文字列を生成します。
    • false：sys_id の文字列を生成します。
    表 : 149. 返される内容
    タイプ 説明
    なし 
    var grByName = new GlideRecord(this.TEST_TABLE);
grByName.addQuery("caller_id", userDisplayName);
grByName.setQueryReferences(true);
grByName.query();
if (grByName.hasNext()) {
  while(grByName.next()) {
    gs.print("Incident caller_id=" + grByName.caller_id);
  }
} else {
  gs.print("NO RESULTS");
}

    GlideRecord - setUseEngines(ブーリアン e)

    任意のエンジン (承認ルール/アサインルール) の実行を無効または有効にします。

    警告:
    エンジンの実行を無効にすると、ServiceNow® インスタンスとその動作に重大な影響を与える可能性があります。本番環境に展開する前に、この変更を十分にテストしてください。
    表 : 150. パラメーター
    名前 タイプ 説明
    e ブーリアン エンジンの実行を有効または無効にするかどうかを示すフラグ。
    有効な値：
    • true：エンジンを有効にする
    • false：エンジンを無効にする
    表 : 151. 返される内容
    タイプ 説明
    なし

    この例では、クエリを実行する前にエンジンとビジネスルールを無効にする方法を示します。

    function auditOAuthInboundRequestsUsage(){
  var now_GR = new GlideRecord("oauth_credential");
  var oauthClient = now_GR.addJoinQuery("oauth_entity", "peer", "sys_id");
  now_GR.addQuery("type", "access_token");
  now_GR.addQuery("expires", ">", nowDateTime());
  now_GR.addNullQuery("oauth_requestor_profile");
  oauthClient.addCondition("active", "true");
  oauthClient.addCondition("type", "client");
  now_GR.setUseEngines(false);
  now_GR.setWorkflow(false);
  now_GR.query();
  return now_GR.hasNext();
}

    GlideRecord - setValue(文字列 name, オブジェクト value)

    指定されたフィールドを指定された値に設定します。

    通常、スクリプトは直接割り当てを行います (例：now_GR.category = value)。ただし、スクリプトで要素名が変数の場合は、now_GR.setValue(elementName, value) を使用できます。値を設定するときは、フィールドのデータタイプが入力する値のデータタイプと一致していることを確認してください。

    値パラメーターが null の場合、レコードは更新されず、エラーはスローされません。
    注:
    このメソッドはジャーナルフィールドでは使用できません。代わりに GlideElement.setJournalEntry() を使用してください。
    注:
    列レベル暗号化エンタープライズ プラグインが有効になっていて、インスタンスがキーにアクセスできる場合、このメソッドは暗号化されたデータを暗号化されたフィールドに挿入できます。インスタンスがキーにアクセスできない場合、このメソッドはエラーを返します。詳細については、「 プラットフォームの暗号化」を参照してください。
    表 : 152. パラメーター
    名前 タイプ 説明
    name 文字列 値を設定するフィールドの名前。
    value オブジェクト 指定されたフィールドで設定する値。
    表 : 153. 返される内容
    タイプ 説明
    なし

    この例は、planned_task テーブルのステータスフィールドの値を設定する方法を示しています。

    function() {
  var topTask = new GlideRecord('planned_task');
  topTask.setValue('state', -5);
  var childTask = new GlideRecord('planned_task');
  childTask.setValue('state', -5);
  var s = new PlannedTaskStateManagement(childTask, topTask);
  var state = s.manageStateChange(false);
  Assert.assertEquals("-5", state);
}

    スコープ対応

    スコープ対象のアプリケーションで setValue() メソッドを使用するには、対応するスコープ対象のメソッド setValue() を使用します。

    GlideRecord - setWorkflow(ブーリアン e)

    後続のアクションによって通常トリガーされるビジネスルールの実行を有効または無効にします。e パラメーターが false に設定されている場合、挿入/更新は監査されません。監査は GlideRecord 操作でパラメーターが true に設定されている場合にのみ行われます。

    注:
    後で deleteProblem() または deleteMultiple() メソッドを使用してカスケード削除を行う場合、setWorkflow() メソッドは無視されます。
    警告:
    ビジネスルールの実行を無効にすると、ServiceNow® インスタンスとその動作に重大な影響を与える可能性があります。本番環境に展開する前に、この変更を十分にテストしてください。
    表 : 154. パラメーター
    名前 タイプ 説明
    e ブーリアン ビジネスルールの実行を有効または無効にするかどうかを示すフラグ。
    有効な値：
    • true：ビジネスルールを有効にする
    • false：ビジネスルールを無効にする
    表 : 155. 返される内容
    タイプ 説明
    なし 
    doit('name1','name2'); 
 
function doit(username1,username2) { 
 
  var usr1 = new GlideRecord('sys_user');
  var usr2 = new GlideRecord('sys_user');
  var num = 0;
 
  if (usr1.get('user_name',username1) && usr2.get('user_name',username2)) {
    var ref;
    var dict = new GlideRecord('sys_dictionary');
    dict.addQuery('reference','sys_user');
    dict.addQuery('internal_type','reference');
    dict.query();
    while (dict.next()) {
      num = 0;
      ref = new GlideRecord(dict.name.toString());
      ref.addQuery(dict.element,usr1.sys_id);
      ref.query();
      while (ref.next()) {
        ref.setValue(dict.element.toString(),usr2.sys_id); 
        ref.setWorkflow(false);
        ref.update();
        num++;
      }
      if (num > 0) {
        gs.print(dict.element + ' changed from ' + usr1.user_name + 
          ' to ' + usr2.user_name + ' in ' + num + ' ' + dict.name + ' records');
      }
    }
  }
}

    スコープ対応

    スコープ対象のアプリケーションで setWorkflow() メソッドを使用するには、対応するスコープ対象の setWorkflow() メソッドを使用します。

    GlideRecord - update(オブジェクト reason)

    行われた変更で GlideRecord を更新します。レコードが存在しない場合は挿入されます。

    表 : 156. パラメーター
    名前 タイプ 説明
    理由 オブジェクト オプション。更新の理由。理由は監査レコードに表示されます。
    表 : 157. 返される内容
    タイプ 説明
    文字列 新規または更新レコードの sys_id。更新に失敗した場合は null を返します。

    この例では、task_ci テーブルのレコードを更新します。

    var now_GR = new GlideRecord('task_ci');
now_GR.addQuery();
now_GR.query();
var count = now_GR.getRowCount();
if (count > 0) {
   var allocation = parseInt(10000 / count) / 100;
   while (now_GR.next()) {
      now_GR.u_allocation = allocation;
      now_GR.update();
   }
}

    スコープ対応

    スコープ対象のアプリケーションで update() メソッドを使用するには、対応するスコープ対象のメソッド update() を使用します。

    GlideRecord - updateMultiple()

    指定された一連の変更を使用して、指定されたクエリの各 GlideRecord を更新します。

    ジャーナルエントリの追加については、setJournalEntry() メソッドを参照してください。

    システムプロパティは glide.db.forced.chunk.threshold 、チャンクレコードの削除と更新を強制するしきい値を設定します。チャンクは、巨大なテーブルでプライマリキー以外の削除によってレプリケーションの問題が発生するのを防ぐのに役立ちます。詳細については、「Available system properties」を参照してください。

    注:
    期待される結果を確実に得るには、直接の割り当ての代わりに setValue() メソッドを使用します。つまり、gr.<field_name> = 4 の代わりに gr.setValue('<field_name>', '4')); を使用します。
    注:
    大きなテーブルを操作する場合は、このメソッドと chooseWindow() または setLimit() を一緒に使用しないでください。

    このメソッドは新しい値を設定しますが、既存の値はクリアしません。既存の値をクリアするには、setValue() メソッドを使用し、フィールドを nullに設定します。

    表 : 158. パラメーター
    名前 タイプ 説明
    なし
    表 : 159. 返される内容
    タイプ 説明
    なし

    この例では、すべてのアクティブなインシデントのステータスを 4 -「ユーザー情報待ち」に更新する方法を説明します。

    var now_GR = new GlideRecord('incident');
now_GR.addQuery('active', true);
now_GR.setValue('state',  4);
now_GR.updateMultiple();

    スコープ対応

    スコープ対象のアプリケーションで updateMultiple() メソッドを使用するには、対応するスコープ対象のメソッド updateMultiple() を使用します。

    GlideRecord - updateWithReferences(オブジェクト reason)

    レコードを更新し、提供された情報で関連レコードの挿入または更新も行います。

    表 : 160. パラメーター
    名前 タイプ 説明
    理由 オブジェクト 更新の理由。理由は監査レコードに表示されます。
    表 : 161. 返される内容
    タイプ 説明
    文字列 更新されるレコードの sys_id。

    問い合わせユーザー ID が sys_user レコード「John Doe」を参照するように設定されているインシデントを処理する場合、次のコードは John Doe のユーザーレコードを更新します。問い合わせユーザー ID が指定されていないインシデントを処理する場合、次のコードは指定された情報 (first_name、last_name) で新しい sys_user レコードを作成し、新しく作成された sys_user レコードに問い合わせユーザー ID 値を設定します。

    var inc = new GlideRecord('incident');
inc.get(inc_sys_id);  // Looking up an existing incident record where 'inc_sys_id' represents the sys_id of a incident record
inc.caller_id.first_name = 'John';
inc.caller_id.last_name = 'Doe';
inc.updateWithReferences();
}