GlideSystem - スコープ指定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:56分
  • スコープ対象の GlideSystem API は、システムに関する情報、現在ログインしているユーザー、およびその他のシステムレベルの情報を取得するための便利な方法を多数提供します。

    GlideSystem メソッドの多くは、クエリ範囲に日付を簡単に含めることを容易にし、フィルターやレポートで最もよく使用されます。

    スコープ付き GlideSystem - addErrorMessage(文字列メッセージ)

    現在のセッションのエラーメッセージを追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    message 文字列 追加するメッセージ。
    表 : 2. 返される内容
    タイプ 説明
    なし
    gs.include("PrototypeServer");
      var ValidatePasswordStronger = Class.create();
      ValidatePasswordStronger.prototype = {
           process : function() {
              var user_password = request.getParameter("user_password");
              var min_len = 8;
              var rules = "Password must be at least " + min_len + 
                 " characters long and contain a digit, an uppercase letter, and a lowercase letter.";
              if (user_password.length() < min_len) {
                 gs.addErrorMessage("TOO SHORT: " + rules);
                 return false;
              }
              var digit_pattern = new RegExp("[0-9]", "g");
              if (!digit_pattern.test(user_password)) {
                 gs.addErrorMessage("DIGIT MISSING: " + rules);
                 return false;
              }
              var upper_pattern = new RegExp("[A-Z]", "g");
              if (!upper_pattern.test(user_password)) {
                 gs.addErrorMessage("UPPERCASE MISSING: " + rules);
                 return false;
              }
              var lower_pattern = new RegExp("[a-z]", "g");
              if (!lower_pattern.test(user_password)) {
                 gs.addErrorMessage("LOWERCASE MISSING: " + rules);
                 return false;
              }
              return true; // password is OK
           }
      }

    スコープ付き GlideSystem - addHighMessage (文字列メッセージ)

    フォームの上部に高優先度のメッセージが表示されます。

    表 : 3. パラメーター
    名前 タイプ 説明
    message 文字列 表示する優先度の高いメッセージ。
    表 : 4. 戻り値
    タイプ 説明
    なし

    次の例は、フォームの上部に優先度の高いメッセージを表示する方法を示しています。

    gs.addHighMessage("This is a high priority message");

    スコープ付き GlideSystem - addInfoMessage(文字列メッセージ)

    現在のセッションの情報メッセージを追加します。このメソッドは、非同期ビジネスルールではサポートされていません。

    表 : 5. パラメーター
    名前 タイプ 説明
    message 文字列 追加する情報メッセージ。
    表 : 6. 返される内容
    タイプ 説明
    なし
    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);
      }
    }

    スコープ付き GlideSystem - addLowMessage (文字列メッセージ)

    優先度の低いメッセージをフォームの上部に表示します。

    表 : 7. パラメーター
    名前 タイプ 説明
    message 文字列 表示する優先度の低いメッセージ。
    表 : 8. 戻り値
    タイプ 説明
    なし

    次の例は、優先度の低いメッセージをフォームの上部に表示する方法を示しています。

    gs.addLowMessage("This is a low priority message");

    スコープ付き GlideSystem - addModerateMessage (文字列メッセージ)

    フォームの上部に中程度の優先度のメッセージを表示します。

    表 : 9. パラメーター
    名前 タイプ 説明
    message 文字列 表示する中程度のメッセージ。
    表 : 10. 戻り値
    タイプ 説明
    なし

    次の例は、フォームの上部に中程度の優先度のメッセージを表示する方法を示しています。

    gs.addModerateMessage("This is a moderate priority message");

    スコープ付き GlideSystem - addSuccessMessage (文字列メッセージ)

    アクションが成功したことを確認するメッセージがフォームの上部に表示されます。

    表 : 11. パラメーター
    名前 タイプ 説明
    message 文字列 表示する成功メッセージ。
    表 : 12. 戻り値
    タイプ 説明
    なし

    次の例は、成功メッセージを確認するメッセージをフォームの上部に表示する方法を示しています。

    gs.addSuccessMessage("This is a success message");

    スコープ付き GlideSystem - base64Encode(文字列ソース)

    指定された文字列から base64 文字列を作成します。

    表 : 13. パラメーター
    名前 タイプ 説明
    ソース 文字列 エンコードする文字列。
    表 : 14. 返される内容
    タイプ 説明
    文字列 エンコードされた base64 文字列。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    var mac = new CertificateEncryption;
    var key = "sample_key"; 
    key = gs.base64Encode(key);
    mac.generateMac(key, "HmacSHA256", "sample_data");

    スコープ付き GlideSystem - base64Decode(文字列ソース)

    指定された base64 文字列から ASCII 文字列を返します。

    表 : 15. パラメーター
    名前 タイプ 説明
    ソース 文字列 base64 でエンコードされた文字列。
    表 : 16. 返される内容
    タイプ 説明
    文字列 デコードされた文字列。

    スコープ付き GlideSystem - beginningOfLastMonth()

    ユーザーのセッションタイムゾーンの先月初めの日時を UTC タイムスタンプとして返します。

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 返される内容
    タイプ 説明
    文字列 先月初めの UTC (yyyy-mm-dd hh:mm:ss 形式)

    スコープ対象 GlideSystem - beginningOfLastWeek()

    ユーザーのセッションタイムゾーンでの先週の開始時を UTC タイムスタンプとして返します。

    表 : 19. パラメーター
    名前 タイプ 説明
    なし
    表 : 20. 返される内容
    タイプ 説明
    文字列 先週の初めの UTC、yyyy-mm-dd hh:mm:ss の形式で表示

    スコープ付き GlideSystem - beginningOfNextMonth()

    ユーザーのセッションタイムゾーンで来月初めの日時を UTC タイムスタンプとして返します。

    表 : 21. パラメーター
    名前 タイプ 説明
    なし
    表 : 22. 返される内容
    タイプ 説明
    文字列 来月初めの UTC (yyyy-mm-dd hh:mm:ss 形式)

    スコープ付き GlideSystem - beginningOfNextWeek()

    ユーザーのセッションタイムゾーンで来週の初めの日時を UTC タイムスタンプとして返します。

    表 : 23. パラメーター
    名前 タイプ 説明
    なし
    表 : 24. 返される内容
    タイプ 説明
    文字列 来週の UTC の初め (yyyy-mm-dd hh:mm:ss 形式)。

    スコープ付き GlideSystem - beginningOfNextYear()

    ユーザーのセッションタイムゾーンの来年の初めの日時を UTC タイムスタンプとして返します。

    表 : 25. パラメーター
    名前 タイプ 説明
    なし
    表 : 26. 返される内容
    タイプ 説明
    文字列 来年初めの UTC (yyyy-mm-dd hh:mm:ss 形式)

    スコープ付き GlideSystem - beginningOfThisMonth()

    ユーザーのセッションタイムゾーンで今月初めの日時を UTC タイムスタンプとして返します。

    表 : 27. パラメーター
    名前 タイプ 説明
    なし
    表 : 28. 返される内容
    タイプ 説明
    文字列 今月初めの UTC (yyyy-mm-dd hh:mm:ss 形式)

    スコープ付き GlideSystem - beginningOfThisQuarter()

    ユーザーのセッションタイムゾーンで、この四半期の開始時を UTC タイムスタンプとして返します。

    表 : 29. パラメーター
    名前 タイプ 説明
    なし
    表 : 30. 返される内容
    タイプ 説明
    文字列 今四半期の初めの UTC (yyyy-mm-dd hh:mm:ss 形式)

    スコープ付き GlideSystem - beginningOfThisWeek()

    ユーザーのセッションタイムゾーンで今週の開始時を UTC タイムスタンプとして返します。

    表 : 31. パラメーター
    名前 タイプ 説明
    なし
    表 : 32. 返される内容
    タイプ 説明
    文字列 今週の初めの UTC 形式 (yyyy-mm-dd hh:mm:ss)

    スコープ指定 GlideSystem - beginningOfThisYear()

    ユーザーのセッションタイムゾーンの今年の初めの日時を UTC タイムスタンプとして返します。

    表 : 33. パラメーター
    名前 タイプ 説明
    なし
    表 : 34. 返される内容
    タイプ 説明
    文字列 今年の初めの UTC、yyyy-mm-dd hh:mm:ss の形式で

    スコープ付き GlideSystem - dateGenerate(String date, String range)

    ユーザーのセッションタイムゾーンで指定された日付の日時を UTC タイムスタンプとして生成します。

    表 : 35. パラメーター
    名前 タイプ 説明
    date 文字列 UTC を生成する日付。

    形式:yyyy-mm-dd

    範囲 文字列 開始、終了、または 24 時間形式の時刻 hh:mm:ss。
    表 : 36. 返される内容
    タイプ 説明
    文字列 生成された日時。

    範囲が start の場合、戻り値は yyyy-mm-dd 00:00:00 です。

    range が end の場合、戻り値は yyyy-mm-dd 23:59:59 です。

    形式:yyyy-mm-dd hh:mm:ss

    この例では、インシデントテーブルのレコードをクエリするときに 、dateGenerate() を使用して開始日を設定する方法を示しています。

    var tableData = new GlideRecord('incident');
    tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2");
    tableData.query();
    gs.info("Count: " + tableData.getRowCount());

    出力:

    Count: 7

    スコープ対象 GlideSystem - daysAgo(日数)

    ユーザーのセッションタイムゾーンから指定された日時を UTC タイムスタンプとして返します。

    表 : 37. パラメーター
    名前 タイプ 説明
    days 番号 整数の日数
    表 : 38. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC
    function contractNoticeDue() {
        var now_GR = new GlideRecord("contract");
        now_GR.addQuery("u_contract_status", "Active");
        now_GR.query();
        while (now_GR.next()) {
        if ((now_GR.u_termination_date <= gs.daysAgo(-90)) && (now_GR.u_contract_duration == "Long")) {
                now_GR.u_contract_status = "In review";
            } 
            else if ((now_GR.u_termination_date <= gs.daysAgo(-50)) && (now_GR.u_contract_duration == "Medium")) {
            now_GR.u_contract_status = "In review";
            } 
            else if ((now_GR.u_termination_date <= gs.daysAgo(-10)) && (now_GR.u_contract_duration == "Short")) {
                now_GR.u_contract_status = "In review";
            }
        }
        now_GR.update();
    }

    スコープ指定 GlideSystem - daysAgoEnd(日数)

    指定された日数前の 1 日の終わりの日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 39. パラメーター
    名前 タイプ 説明
    days 番号 整数の日数
    表 : 40. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式での UTC 1 日の終わり

    スコープ対象 GlideSystem - daysAgoStart(日数)

    指定された日数前の 1 日の開始の日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 41. パラメーター
    名前 タイプ 説明
    days 文字列 整数の日数
    表 : 42. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式での UTC 1 日の始まり
    var now_GR = new GlideRecord('sysapproval_approver');
    now_GR.addQuery('state', 'requested');
    now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5));
    now_GR.query();

    スコープ指定 GlideSystem - debug(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    デバッグメッセージをシステムログに書き込みます。

    表 : 43. パラメーター
    名前 タイプ 説明
    message 文字列 変数引数のプレースホルダーを含むログメッセージ。
    パラメーター 1 オブジェクト (オプション)最初の変数引数。
    パラメーター 2 オブジェクト (オプション)2 番目の変数引数。
    param3 オブジェクト (オプション)3 番目の変数引数。
    param4 オブジェクト (オプション)4 番目の変数引数。
    param5 オブジェクト (オプション)5 番目の変数引数。
    表 : 44. 返される内容
    タイプ 説明
    なし
    gs.debug("This is a debug message");
    var myFirstName = "Abel";
    var myLastName = "Tuter";
    gs.debug("This is a debug message from {0}.{1}", myFirstName, myLastName);
    出力:
    This is a debug message (sys.scripts extended logging)
    This is a debug message from Abel.Tuter (sys.scripts extended logging)

    スコープ付き GlideSystem - endOfLastMonth()

    ユーザーのセッションタイムゾーンの先月末の日時を UTC タイムスタンプとして返します。

    表 : 45. パラメーター
    名前 タイプ 説明
    なし
    表 : 46. 返される内容
    タイプ 説明
    文字列 先月末の UTC (yyyy-mm-dd hh:mm:ss 形式)

    スコープ指定 GlideSystem - endOfLastWeek()

    ユーザーのセッションタイムゾーンで先週末の日時を UTC タイムスタンプとして返します。

    表 : 47. パラメーター
    名前 タイプ 説明
    なし
    表 : 48. 返される内容
    タイプ 説明
    文字列 先週末の UTC (yyyy-mm-dd hh:mm:ss 形式)

    スコープ指定 GlideSystem - endOfLastYear()

    ユーザーのセッションタイムゾーンの昨年末の日時を UTC タイムスタンプとして返します。

    表 : 49. パラメーター
    名前 タイプ 説明
    なし
    表 : 50. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ付き GlideSystem - endOfNextMonth()

    ユーザーのセッションタイムゾーンで来月末の日時を UTC タイムスタンプとして返します。

    表 : 51. パラメーター
    名前 タイプ 説明
    なし
    表 : 52. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ付き GlideSystem - endOfNextWeek()

    ユーザーのセッションタイムゾーンで来週末の日時を UTC タイムスタンプとして返します。

    表 : 53. パラメーター
    名前 タイプ 説明
    なし
    表 : 54. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ付き GlideSystem - endOfNextYear()

    ユーザーのセッションタイムゾーンで来年末の日時を UTC タイムスタンプとして返します。

    表 : 55. パラメーター
    名前 タイプ 説明
    なし
    表 : 56. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ付き GlideSystem - endOfThisMonth()

    ユーザーのセッションタイムゾーンで今月末の日時を UTC タイムスタンプとして返します。

    表 : 57. パラメーター
    名前 タイプ 説明
    なし
    表 : 58. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    この例では、 endOfThisMonth() を使用して GlideDateTime オブジェクトを現在の月末に設定する方法を示します。

    setEndDate : function(dt) {
      var gdt2 = new GlideDateTime(dt);
      gdt2.setValue(gs.endOfThisMonth());
    }

    スコープ指定 GlideSystem - endOfThisQuarter()

    ユーザーのセッションタイムゾーンで、この四半期末の日時を UTC タイムスタンプとして返します。

    表 : 59. パラメーター
    名前 タイプ 説明
    なし
    表 : 60. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ付き GlideSystem - endOfThisWeek()

    ユーザーのセッションタイムゾーンで今週末の日時を UTC タイムスタンプとして返します。

    表 : 61. パラメーター
    名前 タイプ 説明
    なし
    表 : 62. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ指定 GlideSystem - endOfThisYear()

    ユーザーのセッションタイムゾーンで今年末の日時を UTC タイムスタンプとして返します。

    表 : 63. パラメーター
    名前 タイプ 説明
    なし
    表 : 64. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ指定 GlideSystem - error(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    エラーメッセージをシステムログに書き込みます。

    このメソッドは、Java MessageFormat プレースホルダー置換パターンを使用して、メッセージ内で最大 5 つの変数引数 (vararg) を受け入れます。

    注:
    正しい出力を提供するには、このメソッドの変数に有効な値が含まれている必要があります。
    表 : 65. パラメーター
    名前 タイプ 説明
    message 文字列 変数引数のプレースホルダーを含むログメッセージ。
    パラメーター 1 オブジェクト (オプション)最初の変数引数。
    パラメーター 2 オブジェクト (オプション)2 番目の変数引数。
    param3 オブジェクト (オプション)3 番目の変数引数。
    param4 オブジェクト (オプション)4 番目の変数引数。
    param5 オブジェクト (オプション)5 番目の変数引数。
    表 : 66. 返される内容
    タイプ 説明
    なし
    gs.error("This is an error message");
    var myFirstName = "Abel";
    var myLastName = "Tuter";
    gs.error("This is an error message from {0}.{1}", myFirstName, myLastName);
    出力:
    This is an error message
    This is an error message from Abel.Tuter

    スコープ付き GlideSystem - eventQueue(文字列名, オブジェクトインスタンス, 文字列パラメーター 1, 文字列パラメーター 2, 文字列キュー)

    イベントマネージャーのイベントをキューに入れます。

    表 : 67. パラメーター
    名前 タイプ 説明
    name 文字列 キューに入れられるイベントの名前。
    インスタンス オブジェクト GlideRecord オブジェクト (「current」など)。
    parm 1 文字列 オプション。指定されている場合はインスタンスとともに保存されます。
    parm 2 文字列 オプション。指定されている場合はインスタンスとともに保存されます。
    キュー 文字列 オプション。キューの名前。
    表 : 68. 返される内容
    タイプ 説明
    なし
    if (current.operation() != 'insert' && current.comments.changes()) {
        gs.eventQueue('incident.commented', current, gs.getUserID(), gs.getUserName());
    }

    スコープ付き GlideSystem - eventQueueScheduled(String name, Object instance, String parm1, String parm2, Object expiration)

    イベントマネージャーでイベントをキューに入れます。

    渡されたイベントスケジュール情報は、イベント [sysevent] テーブルに格納されます。イベントの詳細については、「 イベント」を参照してください。

    表 : 69. パラメーター
    名前 タイプ 説明
    name 文字列 キューに入れるイベントの名前。
    インスタンス オブジェクト/文字列 GlideRecord オブジェクト、またはこのイベントが適用されるレコードのsys_id。
    parm 1 文字列 オプション。イベントスクリプトに渡す文字列。このパラメーターは自由形式であり、イベントスクリプトの実装に依存します。

    デフォルト: instance パラメーターが GlideRecord オブジェクトの場合、デフォルトはその GlideRecord の表示値 (now_GR.getDisplayValue)。それ以外の場合は null です。

    parm 2 文字列 オプション。イベントスクリプトに渡す文字列。このパラメーターは自由形式であり、イベントスクリプトの実装に依存します。

    デフォルト値: null

    有効期限 オブジェクト オプション。GlideDateTime オブジェクト、またはイベントを処理する日時を指定する日付/時刻タイプの要素。

    デフォルト:現在の日付/時刻

    表 : 70. 返される内容
    タイプ 説明
    なし

    この例では、GlideRecord、イベントスクリプトに渡される 2 つのパラメーター、およびイベントをスケジュールする指定された時間を使用してメソッドを呼び出す方法を示します。

    var requestXml = requestBody.dataString;
    var processTime = new GlideDateTime();
    processTime.addDaysLocalTime(7);
    gs.eventQueueScheduled('sn_app.user.deactivate', now_GR, requestXML, gs.getUserID(), processTime);

    この例では、sys_idとオプションのパラメーターのデフォルト値を使用してメソッドを呼び出す方法を示します。

    gs.eventQueueScheduled('event.test', '0e29421383101000dada83ec37d9292d', '', '', '');

    スコープ付き GlideSystem - executeNow (GlideRecord ジョブ)

    スコープ対象のアプリケーションのジョブを実行します。

    このメソッドは、このメソッドを呼び出すスクリプトと同じアプリケーション内のジョブでのみ使用できます。

    表 : 71. パラメーター
    名前 タイプ 説明
    ジョブ GlideRecord 実行するジョブ。
    表 : 72. 返される内容
    タイプ 説明
    文字列 スケジュール済みジョブのsys_idを返します。ジョブがグローバルの場合は null を返します。
    scheduleImportJob: function () {
      var jobId = '61847fe04c603300fa9bb64c2b491dac';
      var now_GR = new GlideRecord('sysauto_script');
      if (!now_GR.get(jobId)) {
        throw new Error('Unable to find import job');
      }
      gs.executeNow(now_GR);
    }

    スコープ付き GlideSystem - generateGUID()

    一意の識別子が必要な場合に使用できる GUID を生成します。

    表 : 73. パラメーター
    名前 タイプ 説明
    なし
    表 : 74. 返される内容
    タイプ 説明
    文字列 32 文字の 16 進数 GUID。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    personalId = gs.generateGUID();
    gs.info(personalId);

    出力:

    af770511ff013100e04bfffffffffff6

    スコープ付き GlideSystem - getCallerScopeName()

    呼び出し元スコープ名を取得します。呼び出し元がない場合は null を返します。

    表 : 75. パラメーター
    名前 タイプ 説明
    なし
    表 : 76. 返される内容
    タイプ 説明
    文字列 呼び出し元のスコープ名、または呼び出し元がいない場合は null。

    この例は、[すべてのアプリケーションスコープからアクセス可能] に設定された 2 つのスクリプトインクルードを示しています。app_scope_a内に 1 つのスクリプトインクルードが作成されます。

    var Scopea = Class.create(); 
     
    Scopea.prototype = { 
        initialize: function() { 
        }, 
     
        callerScope: function() { 
            var scopeb = new app_scope_b.Scopeb(); 
            return scopeb.callerscope(); 
        }, 
     
        type: 'Scopea' 
    }

    出力:

    この例は、app_scope_b内で作成された別のスクリプトインクルードを示しています。

    var Scopeb = Class.create(); 
     
    Scopeb.prototype = { 
        initialize: function() { 
            this._constructorCallerScope = gs.getCallerScopeName(); 
        }, 
     
        callerscope: function() { 
            return gs.getCallerScopeName(); 
        }, 
     
        getConstructorCallerScope: function() { 
            return this._constructorCallerScope; 
        }, 
     
        type: 'Scopeb' 
    }

    出力:

    このスクリプトをスコープ app_scope_a 内で使用して、呼び出し元のスコープ名 (この場合は app_scope_b) を取得できます。

    gs.info(new Scopea().getCallerScopeName());

    スコープ付き GlideSystem - getCssCacheVersionString()

    CSS ファイルのキャッシュバージョンを表す文字列を取得します。

    表 : 77. パラメーター
    名前 タイプ 説明
    なし
    表 : 78. 返される内容
    タイプ 説明
    文字列 CSS キャッシュのバージョン。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    var verStr = gs.getCssCacheVersionString();
    gs.info(verStr);

    出力:

    _d82979516f0171005be8883e6b3ee4cf&theme=

    スコープ付き GlideSystem - getCurrentApplicationId()

    アプリケーションピッカーを使用して、設定した現在のアプリケーションの ID を取得します。

    表 : 79. パラメーター
    名前 タイプ 説明
    なし
    表 : 80. 返される内容
    タイプ 説明
    文字列 現在のアプリケーションのsys_id、または global in none が設定されます。
    var currentId = gs.getCurrentApplicationId();
    gs.info(currentId);

    出力

    04936cb16f30b1005be8883e6b3ee4e0

    スコープ付き GlideSystem - getCurrentScopeName()

    現在のスコープの名前を取得します。

    表 : 81. パラメーター
    名前 タイプ 説明
    なし
    表 : 82. 返される内容
    タイプ 説明
    文字列 現在のスコープ名。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    var currentScope = gs.getCurrentScopeName();
    gs.info(currentScope);

    出力:

    s_snc_test_scope

    スコープ付き GlideSystem - getDateFormat(String)

    現在のユーザーに関連付けられている日付形式を返します。

    表 : 83. パラメーター
    名前 タイプ 説明
    なし
    表 : 84. 返される内容
    タイプ 説明
    文字列 現在のユーザーに関連付けられている日付形式。

    次の例では、ユーザーに関連付けられた日付形式を返します。

    var userDateFormat = gs. getDateFormat();
    gs.info(userDateFormat);
    

    出力:

    yyyy-MM-dd

    スコープ付き GlideSystem - getDateTimeFormat()

    現在のユーザーに関連付けられている日付と時刻の形式を返します。

    表 : 85. パラメーター
    名前 タイプ 説明
    なし
    表 : 86. 返される内容
    タイプ 説明
    文字列 現在のユーザーに関連付けられている日付と時刻の形式。

    次の例では、ユーザーに関連付けられている日付と時刻の形式を返します。

    var userDateTimeFormat = gs.getDateTimeFormat();
    gs.info(userDateTimeFormat);
    

    出力:

    yyyy-MM-dd HH:mm:ss

    スコープ付き GlideSystem - getErrorMessages()

    addErrorMessage() によってセッションに追加されたエラーメッセージを返します。

    表 : 87. パラメーター
    名前 タイプ 説明
    なし
    表 : 88. 返される内容
    タイプ 説明
    文字列のアレイ セッションに関連するエラーメッセージ。

    スコープ指定 GlideSystem - getEscapedMessage(文字列 id, アレイ引数)

    メッセージ [sys_ui_message] テーブルから指定されたメッセージを取得します。メッセージに HTML 特殊文字が含まれている場合は、対応する HTML 名コードに置き換えます。たとえば、 && になります。

    指定されたメッセージ識別子 (キー) が現在の言語のメッセージ [sys_ui_message] テーブルに存在する場合、このメソッドは、エスケープシーケンスとして返されるすべての特殊文字を含む翻訳されたメッセージを返します。指定されたメッセージ識別子が現在の言語に存在しない場合、このメソッドは、すべての特殊文字がエスケープシーケンスとして返された英語版のメッセージを返します。メッセージ識別子がテーブルに存在しない場合は、メッセージ ID が返されます。

    メッセージテーブルの詳細については、「 メッセージテーブル」を参照してください。

    注:
    UI メッセージにチェックマーク (') が付いている場合は、スクリプト内のメッセージに問題がある可能性があります。目盛り (') をエスケープするには、 getMessageS(String, Object) を使用します。
    表 : 89. パラメーター
    名前 タイプ 説明
    ID 文字列 メッセージ識別子。この値は、メッセージ [sys_ui_message] テーブルの [キー] フィールドにあります。[キー] フィールドは、実際のメッセージ文字列とまったく同じように見える場合があります。
    args アレイ オプション。指定されたメッセージ内の変数を置き換える、java.text.MessageFormat で定義された文字列またはその他の値のリスト。

    例: gs.getMessage("アクション '{0}' の追加を中止します。同じサブフローをこのサブフローで 2 回追加することはできません。", current.action.name);

    この例では 、「{0}」current.action.name の内容に置き換えられます。

    注:
    渡された値は翻訳されません。これらはメッセージに逐語的に挿入されます。
    表 : 90. 返される内容
    タイプ 説明
    文字列 HTML 特殊文字を HTML 名コードに置き換えた UI メッセージ。

    この例は、アンパサンド文字が同等のアンパサンド HTML 名コードに置き換えられていることを示しています。

    var my_message = gs.getEscapedMessage("Is the summary & details accurate?");
    alert(my_message);

    出力

    Is the summary & details accurate?

    この例では、メッセージ内の単一の変数を置き換える方法と、メッセージ内の<記号と>記号が、対応する HTML 名コード < と > にどのように転置されるかを示しています。

    // current.action.name is "update record"
    var my_message = gs.getEscapedMessage("Abort adding action '{0}', same <subflow> can't be added twice in this subflow.", current.action.name);
    alert(my_message);

    出力

    Abort adding action update record, same &ltsubflow&gt can't be added twice in this subflow.

    スコープ付き GlideSystem - getMessage(文字列 id, アレイ引数)

    メッセージ [sys_ui_message] テーブルから翻訳されたメッセージを取得して UI に表示します。

    指定されたメッセージ識別子 (キー) が現在の言語のメッセージ [sys_ui_message] テーブルに存在する場合、メソッドは翻訳されたメッセージを返します。指定されたメッセージ識別子が現在の言語に存在しない場合、このメソッドは英語版のメッセージを返します。メッセージ識別子がテーブルに存在しない場合は、メッセージ ID が返されます。

    メッセージテーブルの詳細については、「メッセージテーブル」を参照してください

    注:
    UI メッセージにチェックマーク (') が付いている場合は、スクリプト内のメッセージに問題がある可能性があります。目盛り (') をエスケープするには、 getMessageS(String, Object) を使用します。
    表 : 91. パラメーター
    名前 タイプ 説明
    ID 文字列 メッセージ識別子。この値は、メッセージ [sys_ui_message] テーブルの [キー] フィールドにあります。[キー] フィールドは実際のメッセージとまったく同じ場合があることに注意してください。
    args アレイ オプション。指定されたメッセージ内の変数を置き換える、java.text.MessageFormat で定義された文字列またはその他の値のリスト。

    例: gs.getMessage("アクション '{0}' の追加を中止します。同じサブフローをこのサブフローで 2 回追加することはできません。", current.action.name);

    この例では 、「{0}」current.action.name の内容に置き換えられます。

    注:
    渡された値は翻訳されません。これらはメッセージに逐語的に挿入されます。
    表 : 92. 返される内容
    タイプ 説明
    文字列 UI メッセージ。

    この例は、スペイン語が現在の言語である場合に現在のユーザーに返されるメッセージを示しています。

    var my_message = gs.getMessage("rows will not be updated");
    alert(my_message);

    出力:

    las filas no se actualizarán

    この例では、メッセージ内の単一の変数を置き換える方法を示します。

    // current.action.name is "update record"
    var my_message = gs.getMessage("Abort adding action '{0}', same subflow can't be added twice in this subflow.", current.action.name);
    alert(my_message);

    出力:

    Abort adding action update record, same subflow can't be added twice in this subflow.

    この例では、メッセージ内の複数の変数を置き換える方法を示します。

    // current.sub_flow.name is 'schedule users'
    // current.action.name is "update record"
    var my_message = gs.getEscapedMessage("Abort adding action '{0}', same subflow can't be added twice in {1} subflow.", [current.action.name, current.sub_flow.name]);
    alert(my_message);

    出力:

    Abort adding action update record, same subflow can't be added twice in schedule users subflow.

    スコープ付き GlideSystem - getProperty(String key, Object alt)

    Glide プロパティの値を取得します。プロパティが見つからない場合は、代替値を返します。

    表 : 93. パラメーター
    名前 タイプ 説明
    key 文字列 値を返すプロパティのキー。
    代替 オブジェクト (オプション)プロパティが見つからない場合に返す代替オブジェクト。
    表 : 94. 返される内容
    タイプ 説明
    文字列 Glide プロパティの値、または上記で定義した代替オブジェクト。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    var attachment_link = gs.getProperty('glide.servlet.uri');
    gs.info(attachment_link);

    出力:

    https://instance.service-now.com/

    スコープ付き GlideSystem - getSession()

    現在の Glide セッションへの参照を取得します。

    表 : 95. パラメーター
    名前 タイプ 説明
    なし
    表 : 96. 返される内容
    タイプ 説明
    文字列 現在のセッションの参照。
    if (!gs.hasRole("admin") && !gs.hasRole("user_admin") && gs.getSession().isInteractive()) {
      current.addQuery("active", "true");
    }

    スコープ付き GlideSystem - getSessionID()

    GlideSession セッション ID を取得します。

    表 : 97. パラメーター
    名前 タイプ 説明
    なし
    表 : 98. 返される内容
    タイプ 説明
    文字列 セッション ID。
    var myUserObject = gs.getSessionID();
    gs.info(myUserObject);
    出力:
    A0D4E5416F3F21005BE8883E6B3EE4B8

    スコープ付き GlideSystem - getSessionToken()

    この方法は使用できなくなりました。代わりに、 gs.getSession().getSessionToken() を使用します。

    表 : 99. パラメーター
    名前 タイプ 説明
    なし
    表 : 100. 返される内容
    タイプ 説明
    文字列 セッショントークン。

    スコープ付き GlideSystem - getTimeFormat()

    現在のユーザーに関連付けられている時間形式を返します。

    表 : 101. パラメーター
    名前 タイプ 説明
    なし
    表 : 102. 返される内容
    タイプ 説明
    文字列 現在のユーザーに関連付けられている時間形式。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    var userTimeFormat = gs. getTimeFormat();
    gs.info(userTimeFormat);
    

    出力:

    HH:mm:ss

    スコープ付き GlideSystem - getTimeZoneName()

    現在のユーザーに関連付けられているタイムゾーンの名前を返します。

    このメソッドは廃止されました。代わりに、GlideSession API の getTimeZoneName() メソッドを使用します。

    表 : 103. パラメーター
    名前 タイプ 説明
    なし
    表 : 104. 返される内容
    タイプ 説明
    文字列 タイムゾーン名。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    gs.info(gs.getTimeZoneName());

    スコープ付き GlideSystem - getUrlOnStack()

    セッションの現在の URI を取得します。

    表 : 105. パラメーター
    名前 タイプ 説明
    なし
    表 : 106. 返される内容
    タイプ 説明
    文字列 URI。
    gs.info(gs.getUrlOnStack());

    スコープ付き GlideSystem - getUser()

    現在のユーザーのスコープ対象の GlideUser オブジェクトへの参照を返します。

    使用可能なメソッドのリストについては、「 GlideUser - スコープ指定」を参照してください。

    表 : 107. パラメーター
    名前 タイプ 説明
    なし
    表 : 108. 返される内容
    タイプ 説明
    GlideUser スコープ対象ユーザーオブジェクトへの参照。
    var myUserObject = gs.getUser();
    gs.info(myUserObject);

    出力

    com.glide.script.fencing.ScopedUser@6c0645

    スコープ付き GlideSystem - getUserDisplayName()

    現在のユーザーの表示名を取得します。

    表 : 109. パラメーター
    名前 タイプ 説明
    なし
    表 : 110. 返される内容
    タイプ 説明
    文字列 現在のユーザーの名前フィールド。

    たとえば、このメソッドは abel.tuter ではなく Abel Tuter を返します。

    この例では、現在のユーザーの表示名を取得します。

    gs.info(gs.getUserDisplayName());

    出力:

    System Administrator

    スコープ付き GlideSystem - getUserID()

    現在のユーザーのsys_idを取得します。

    表 : 111. パラメーター
    名前 タイプ 説明
    なし
    表 : 112. 返される内容
    タイプ 説明
    文字列 現在のユーザーのsys_id。

    次の例は、現在のユーザーに割り当てられているすべてのアクティブなインシデントレコードのアサインを解除する方法を示しています。

    var incidentGR = new GlideRecord('incident');
    incidentGR.addActiveQuery();
    
    // Filter results to incidents assigned to the current user
    var currentUserSysId = gs.getUserID();
    incidentGR.addQuery('assigned_to', currentUserSysId);
    incidentGR.query();
    
    while (incidentGR.next()) {
        incidentGR.setValue('assigned_to', 'NULL');
        incidentGR.update();
        gs.info(
            'Unassigned Incident: {0}: {1}',
            incidentGR.number.toString(),
            incidentGR.short_description.toString()
        );
    }

    出力:

    Unassigned Incident: INC0000057: Performance problems with wifi
    Unassigned Incident: INC0009001: Unable to post content on a Wiki page
    Unassigned Incident: INC0008111: ATF : Test1

    スコープ付き GlideSystem - getUserName()

    現在のユーザーのユーザー名を返します。

    表 : 113. パラメーター
    名前 タイプ 説明
    なし
    表 : 114. 返される内容
    タイプ 説明
    文字列 現在のユーザーのユーザー名。

    たとえば、このメソッドは Abel Tuter ではなく abel.tuter を返します。

    この例では、現在のユーザーのユーザー名を取得します。

    gs.info("The current user name is: " + gs.getUserName());
    出力:
    The current user name is: admin

    スコープ付き GlideSystem - hasRole (オブジェクトロール)

    現在のユーザーが指定されたロールを持っているかどうかを判定します。

    表 : 115. パラメーター
    名前 タイプ 説明
    ロール オブジェクト 確認するロール。
    表 : 116. 返される内容
    タイプ 説明
    ブーリアン ユーザーがロールを持っていた場合は True。アドミニストレーターロールを持つユーザーの場合は true を返します。
    if (!gs.hasRole("admin") && !gs.hasRole("groups_admin")  && gs.getSession().isInteractive()) {
      var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups... 
      qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group
      gs.info("User has admin and groups admin roles");
    }
    else {
      gs.info("User does not have both admin and groups admin roles");
    }

    スコープ対象 GlideSystem - hoursAgo(時間数)

    指定された時間数前の日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 117. パラメーター
    名前 タイプ 説明
    時間 番号 整数時間数
    表 : 118. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC
    if (current.operation() == 'insert') {
     // If no due date was specified, calculate a default
     if (current.due_date == '') {
     
      if (current.urgency == '1') {
       // Set due date to 4 hours ahead of current time
       current.due_date = gs.hoursAgo(-4);
      }
     
      if (current.urgency == '2') {
       // Set due date to 2 days ahead of current time
       current.due_date = gs.daysAgo(-2);
      }
     
      if (current.urgency == '3') {
       // Set due date to 7 days ahead of current time
       current.due_date = gs.daysAgo(-7);
      }
     }
    }

    スコープ指定 GlideSystem - hoursAgoEnd(Number hours)

    指定された時間数前の 1 時間目の終わりの日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 119. パラメーター
    名前 タイプ 説明
    時間 番号 整数時間数
    表 : 120. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ付き GlideSystem - hoursAgoStart(Number hours)

    指定された時間数前の時間の開始日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 121. パラメーター
    名前 タイプ 説明
    時間 番号 整数時間数
    表 : 122. 返される内容
    タイプ 説明
    文字列 yyyy-mm-dd hh:mm:ss 形式の UTC

    スコープ指定 GlideSystem - include(文字列名)

    サンドボックスからスクリプトインクルードを呼び出す安全な方法を提供し、信頼できるスクリプトのみを含めることができます。

    表 : 123. パラメーター
    名前 タイプ 説明
    name 文字列 含めるスクリプトの名前。
    表 : 124. 返される内容
    タイプ 説明
    ブーリアン スクリプトインクルードが機能したかどうかを示すフラグ。
    可能な値:
    • true:スクリプトインクルードが機能しました。
    • false:スクリプトインクルードが失敗しました。

    この例では、現在のスクリプトコンテキストで LDAPUtils を取得します。

    var ldapServer = new GlideRecord("ldap_server_config");
    ldapServer.addActiveQuery();
    ldapServer.query();
    gs.include("LDAPUtils");
    var ldapUtils = new LDAPUtils();
    var errMsg = "";
    while (ldapServer.next()) {
      var ldap = new GlideLDAP();
      var dn = ldapServer.dn;
      var env = ldap.setup();
      if (env == null) {
        errMsg = "Failed environment setup, missing URL";
        gs.eventQueue("ldap.connection_failed",   ldapServer, ldapServer.getDisplayValue(), errMsg);
        gs.logError("LDAP server " + ldapServer.getDisplayValue() + " failed scheduled connection test: " + errMsg, "LDAP");
     }
    }

    スコープ指定 GlideSystem - info(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    情報メッセージをシステムログに書き込みます。

    表 : 125. パラメーター
    名前 タイプ 説明
    message 文字列 変数引数のプレースホルダーを含むログメッセージ。
    パラメーター 1 オブジェクト (オプション)最初の変数引数。
    パラメーター 2 オブジェクト (オプション)2 番目の変数引数。
    param3 オブジェクト (オプション)3 番目の変数引数。
    param4 オブジェクト (オプション)4 番目の変数引数。
    param5 オブジェクト (オプション)5 番目の変数引数。
    表 : 126. 返される内容
    タイプ 説明
    なし
    gs.info("This is an info message");
    var myFirstName = "Abel";
    var myLastName = "Tuter";
    gs.info("This is an info message from {0}.{1}", myFirstName, myLastName);
    出力:
    This is an info message
    This is an info message from Abel.Tuter

    スコープ指定 GlideSystem - isDebugging()

    特定のスコープに対してデバッグがアクティブかどうかを決定します。

    表 : 127. パラメーター
    名前 タイプ 説明
    なし
    表 : 128. 返される内容
    タイプ 説明
    ブーリアン 指定されたスコープに対してセッションデバッグがアクティブであるか、ログレベルがデバッグに設定されている場合は True。
    gs.debug("This is a log message");
    var myFirstName = "Abel";
    var myLastName = "Tuter";
    gs.debug("This is a log message from {0}.{1}", myFirstName, myLastName);
    gs.info(gs.isDebugging());

    スコープ付き GlideSystem - isInteractive()

    現在のセッションがインタラクティブかどうかを確認します。インタラクティブセッションの例は、ユーザーが通常どおりログインする場合です。非インタラクティブセッションの例として、SOAP 要求を使用したデータの取得があります。

    表 : 129. パラメーター
    名前 タイプ 説明
    なし
    表 : 130. 返される内容
    タイプ 説明
    ブーリアン セッションがインタラクティブである場合は True。
    if (!gs.hasRole("admin") && gs.getSession().isInteractive()) {
        var qc1 = current.addQuery('u_group',"");
        var gra = new GlideRecord('sys_user_grmember');
        gra.addQuery('user', gs.getUserID());
        gra.query();
        while (gra.next()) {
            qc1.addOrCondition('u_group', gra.group);
        }
    }

    スコープ付き GlideSystem - isLoggedIn()

    現在のユーザーが現在ログインしているかどうかを判定します。

    表 : 131. パラメーター
    名前 タイプ 説明
    なし
    表 : 132. 返される内容
    タイプ 説明
    ブーリアン 現在のユーザーがログインしている場合は True。
    gs.info(gs.isLoggedIn());

    スコープ付き GlideSystem - isMobile()

    要求がモバイルデバイスから送信されたかどうかを判断できます。

    このメソッドは、UI アクション条件とビジネスルールで使用できます。

    表 : 133. パラメーター
    名前 タイプ 説明
    なし
    表 : 134. 返される内容
    タイプ 説明
    ブーリアン 要求がモバイルデバイスから送信された場合は True。それ以外の場合は false です。
    if (gs.isMobile())
      gs.info("submitted from mobile UI");
     else 
       gs.info("NOT submitted from mobile UI");

    出力

    NOT submitted from mobile UI

    スコープ指定 GlideSystem - minutesAgoEnd(Number minutes)

    指定した分数前の終了日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 135. パラメーター
    名前 タイプ 説明
    番号 5 や 126 など、分前の整数です。
    表 : 136. 返される内容
    タイプ 説明
    文字列 指定された分数前の 1 分 (59 秒) の終わりの UTC。

    形式:yyyy-mm-dd hh:mm:ss

    次の例では、現在の日付と時刻と 30 分前の日付と時刻を 1 分の終わりに UTC で表示しています。

    var nowDateTime = new GlideDateTime();
    gs.info("Now: " + nowDateTime);
    var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
    gs.info("Thirty minutes ago end time: " + thirtyMinutesAgoDateTime);

    出力:

    Now: 2021-10-20 15:22:13
    Thirty minutes ago end time: 2021-10-20 14:52:59

    スコープ指定 GlideSystem - minutesAgoStart(分数)

    指定された分数前までの分数の開始日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 137. パラメーター
    名前 タイプ 説明
    番号 15 や 112 など、分前の整数です。
    表 : 138. 返される内容
    タイプ 説明
    文字列 指定された分数前の UTC (分の開始時)。

    形式:yyyy-mm-dd hh:mm:ss

    次の例では、現在の日付と時刻、および 30 分前の開始時刻を UTC で表示しています。

    var nowDateTime = new GlideDateTime();
    gs.info("Now: " + nowDateTime);
    var thirtyMinutesAgoDateTime = gs.minutesAgoStart(30);
    gs.info("Thirty minutes ago: " + thirtyMinutesAgoDateTime);

    出力:

    Now: 2021-10-20 14:56:18
    Thirty minutes ago: 2021-10-20 14:26:00

    スコープ対象 GlideSystem - monthsAgo(月数)

    ユーザーのセッションタイムゾーンで指定された月数前の日時を UTC タイムスタンプとして返します。

    表 : 139. パラメーター
    名前 タイプ 説明
    番号 月前の整数。
    表 : 140. 返される内容
    タイプ 説明
    文字列 指定された月数前のまったく同じ時間の UTC。

    形式:yyyy-mm-dd hh:mm:ss

    次の例では、現在の日付と時刻と 1 か月前の日時を同時に UTC で表示します。

    var nowDateTime = new GlideDateTime();
    gs.info("Now: " + nowDateTime);
    var oneMonthAgoDateTime = gs.monthsAgo(1);
    gs.info("One month ago: " + oneMonthAgoDateTime);

    出力:

    Now: 2021-10-20 15:29:15
    One month ago: 2021-09-20 15:29:15

    スコープ対象 GlideSystem - monthsAgoEnd(月数)

    指定された月数前の月の最終日の日時を返します。

    表 : 141. パラメーター
    名前 タイプ 説明
    数値 (整数) 月数 (4 や 16 など)。
    表 : 142. 返される内容
    タイプ 説明
    文字列 指定された月数前の月の日時スタンプ (現地時間)。

    形式:UTC yyyy-mm-dd hh:mm:ss

    次の例では、営業月末の現在の日付と時刻と 2 か月前の日付と時刻を表示します。

    var nowDateTime = new GlideDateTime();
    gs.info("Now: " + nowDateTime);
    var endOfTheMonthDateTime = gs.monthsAgoEnd(2);
    gs.info("End of the month: " + endOfTheMonthDateTime);

    出力:

    Now: 2021-10-20 19:23:35
    End of the month: 2021-08-01 06:59:59

    スコープ指定 GlideSystem - monthsAgoStart(月数)

    指定された月数前の月初の日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 143. パラメーター
    名前 タイプ 説明
    番号 3 や 14 など、月前の整数です。
    表 : 144. 返される内容
    タイプ 説明
    文字列 指定された月数前の月の UTC の開始。

    形式:yyyy-mm-dd hh:mm:ss

    次の例では、現在の日付と時刻と 3 か月前の日時を UTC で表示します。

    var nowDateTime = new GlideDateTime();
    gs.info("Now: " + nowDateTime);
    var threeMonthsAgoDateTime = gs.monthsAgoStart(3);
    gs.info("Three months ago start date and time: " + threeMonthsAgoDateTime);

    出力:

    Now: 2021-10-20 15:05:27
    Three months ago start date and time: 2021-07-01 07:00:00

    スコープ付き GlideSystem:nil(オブジェクト o)

    オブジェクトをクエリし、オブジェクトが null、未定義、または空の文字列を含んでいる場合は true を返します。

    表 : 145. パラメーター
    名前 タイプ 説明
    o オブジェクト チェックするオブジェクト。
    表 : 146. 返される内容
    タイプ 説明
    ブーリアン オブジェクトが null、未定義、または空の文字列を含む場合は True。それ以外の場合は false を返します。
    var now_GR = new GlideRecord();
    gs.info(gs.nil(now_GR));

    出力

    true

    スコープ対象 GlideSystem - quartersAgoEnd(Number quarters)

    指定した四半期前の四半期の最終日の日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 147. パラメーター
    名前 タイプ 説明
    四半期 番号 四半期の整数番号
    表 : 148. 返される内容
    タイプ 説明
    文字列 四半期前に指定された数の四半期末 (yyyy-mm-dd hh:mm:ss 形式) の UTC

    スコープ対象 GlideSystem - quartersAgoStart(Number quarters)

    指定した四半期前の四半期の初日の日時を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 149. パラメーター
    名前 タイプ 説明
    四半期 番号 四半期の整数番号
    表 : 150. 返される内容
    タイプ 説明
    文字列 四半期前に指定された数の UTC 月末 (yyyy-mm-dd hh:mm:ss 形式)

    スコープ付き GlideSystem - setProperty(String key, String value, String description)

    プロパティがスクリプトのスコープ内にある場合は、指定されたキーを指定された値に設定します。

    注:
    このメソッドを使用してシステムプロパティ (sys_properties) を設定すると、システム全体のキャッシュフラッシュが発生するため、注意が必要です。フラッシュのたびに、キャッシュの再ビルド中にシステムのパフォーマンスが低下する可能性があります。値を頻繁に更新する必要がある場合は、システムプロパティとして保存しないでください。一般に、sys_propertiesテーブルには頻繁に変更されない値のみを配置する必要があります。
    表 : 151. パラメーター
    名前 タイプ 説明
    key 文字列 設定するプロパティのキー。
    value 文字列 設定するプロパティの値。
    description 文字列 プロパティの説明。
    表 : 152. 返される内容
    タイプ 説明
    なし

    次のコード例は、このメソッドを呼び出す方法を示しています。

    gs.setProperty("glide.foo","bar","foo");
    gs.info(gs.getProperty("glide.foo"));

    出力:

    bar

    スコープ付き GlideSystem - setRedirect(Object o)

    このトランザクションのリダイレクト URI を設定します。これにより、ユーザーに表示される次のページが決まります。

    表 : 153. パラメーター
    名前 タイプ 説明
    o オブジェクト リダイレクトとして設定する URI オブジェクトまたは URI 文字列
    表 : 154. 返される内容
    タイプ 説明
    なし
    gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" 
    + current.sys_id + "&sysparm_email=" + current.email)

    スコープ対象 GlideSystem - tableExists(文字列名)

    データベーステーブルが存在するかどうかを判断します。

    表 : 155. パラメーター
    名前 タイプ 説明
    name 文字列 存在を確認するテーブルの名前。
    表 : 156. 返される内容
    タイプ 説明
    ブーリアン テーブルが存在する場合は True。テーブルが見つからなかった場合は false。

    この例では、インシデントテーブルと foo テーブルが ServiceNow インスタンスに存在するかどうかを確認する方法を示しています。

    gs.info("Does the incident table exist? " + gs.tableExists("incident"));
    
    gs.info("Does the foo table exist? " + gs.tableExists("foo"));

    出力:

    Does the incident table exist? true
    Does the foo table exist? false

    スコープ対象 GlideSystem - urlEncode(文字列 url)

    返された文字列がインターネットで使用できるように、非 ASCII 文字、安全でない ASCII 文字、およびスペースをエンコードします。UTF-8 エンコーディングを使用します。パーセント (%) エンコーディングを使用します。

    表 : 157. パラメーター
    名前 タイプ 説明
    URL 文字列 エンコードする文字列。
    表 : 158. 返される内容
    タイプ 説明
    文字列 非 ASCII 文字、安全でない ASCII 文字、およびスペースがエンコードされた文字列。

    スコープ付き GlideSystem - urlDecode(String url)

    UTF-8 エンコード文字を ASCII 文字に置き換えます。

    表 : 159. パラメーター
    名前 タイプ 説明
    URL 文字列 UTF-8 パーセント (%) エンコード文字。
    表 : 160. 返される内容
    タイプ 説明
    文字列 エンコード文字が ASCII 文字に置き換えられました。

    スコープ指定 GlideSystem - warn(String message, Object parm1, Object parm2, Object parm3, Object parm4, Object parm5)

    警告メッセージをシステムログに書き込みます。

    表 : 161. パラメーター
    名前 タイプ 説明
    message 文字列 変数引数のプレースホルダーを含むログメッセージ。
    パラメーター 1 オブジェクト (オプション)最初の変数引数。
    パラメーター 2 オブジェクト (オプション)2 番目の変数引数。
    param3 オブジェクト (オプション)3 番目の変数引数。
    param4 オブジェクト (オプション)4 番目の変数引数。
    param5 オブジェクト (オプション)5 番目の変数引数。
    表 : 162. 返される内容
    タイプ 説明
    なし
    gs.warn("This is a warning");
    var myFirstName = "Abel";
    var myLastName = "Tuter";
    gs.warn("This is a warning from {0}.{1}", myFirstName, myLastName);
    出力:
    This is a warning
    This is a warning from Abel.Tuter

    スコープ付き GlideSystem - xmlToJSON(文字列 xmlString)

    XML 文字列を取得し、JSON オブジェクトを返します。

    表 : 163. パラメーター
    名前 タイプ 説明
    xmlString 文字列 変換する XML 文字列。
    表 : 164. 返される内容
    タイプ 説明
    オブジェクト XML 文字列を表す JSON オブジェクト。XML 文字列を処理できない場合は null。

    次のコード例は、このメソッドを呼び出す方法を示しています。

    var jsonObject = gs.xmlToJSON(xmlString);

    スコープ対象 GlideSystem - 年前 (年数)

    ユーザーのセッションタイムゾーンの特定の年数前の日時を UTC タイムスタンプとして返します。

    表 : 165. パラメーター
    名前 タイプ 説明
    番号 整数の年数
    表 : 166. 返される内容
    タイプ 説明
    文字列 指定された年数前の UTC (yyyy-mm-dd hh:mm:ss 形式)。

    スコープ対象 GlideSystem - yesterday()

    昨日の時刻 (24 時間前) を返します。ユーザーのセッションタイムゾーンで UTC タイムスタンプとして返されます。

    表 : 167. パラメーター
    名前 タイプ 説明
    なし
    表 : 168. 返される内容
    タイプ 説明
    文字列 24 時間前の UTC (yyyy-mm-dd hh:mm:ss 形式)