GlideServletRequest - スコープ指定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:4分
  • GlideServletRequest API は、プロセッサースクリプトで使用するメソッドを提供します。

    ServiceNow プロセッサスクリプトは Java サーブレットに相当します。プロセッサースクリプトは、任意のサーバーサイド JavaScript コードを実行し、TEXT、JSON、HTML などの出力を生成できるカスタマイズ可能な URL エンドポイントを提供します。プロセッサースクリプトで GlideServletRequest API を使用して、 HttpServletRequest オブジェクトにアクセスします。GlideServletRequest オブジェクトは、 HttpServletRequest API のサブセットを提供します。メソッドは、グローバル変数 g_request を使用して呼び出されます。

    便利なグローバル変数 g_target は、プロセッサースクリプトで使用できます。URL から抽出されたテーブル名が含まれています。

    プロセッサーへの URL の形式 https://<インスタンス名.servicenow.com>/<パスエンドポイント>.do?<パラメーターエンドポイント>=<値> には、パスエンドポイントとパラメーターエンドポイントがプロセッサーフォームで定義されています。

    GlideServletRequest - getContentType()

    要求の本文の MIME タイプを返します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    表 : 2. 返される内容
    タイプ 説明
    文字列 コンテンツタイプ (コンテンツタイプが不明な場合、null を返します)。
    var contentType = g_request.getContentType();

    GlideServletRequest - getHeader (文字列名)

    ヘッダー値を返します。

    表 : 3. パラメーター
    名前 タイプ 説明
    name 文字列 取得されるヘッダーの名前。
    表 : 4. 返される内容
    タイプ 説明
    文字列 ヘッダー。
    var headerValue = g_request.getHeader("host");

    出力:

    demonightlyus.service-now.com

    GlideServletRequest - getHeaderNames()

    ヘッダー名のカンマ区切りリストを返します。

    表 : 5. パラメーター
    名前 タイプ 説明
    なし
    表 : 6. 返される内容
    タイプ 説明
    アレイ 文字列としてのヘッダー名のアレイ。
    var headerList = g_request.getHeaderNames();

    出力:

    host,connection,cache-control,authorization,accept,user-agent,accept-encoding,accept-language,
    cookie,x-forwarded-proto,x-forwarded-host,x-forwarded-for

    GlideServletRequest - getHeaders(文字列名)

    ヘッダー値を返します。

    表 : 7. パラメーター
    名前 タイプ 説明
    name 文字列 取得されるヘッダーの名前。
    表 : 8. 返される内容
    タイプ 説明
    アレイ 文字列としてのヘッダー値のアレイ。
    var headerValue = g_request.getHeaders("host");

    出力:

    demonightlyus.service-now.com

    GlideServletRequest - getParameter (文字列名)

    要求 URL に含まれるパラメーターの値を返します。

    表 : 9. パラメーター
    名前 タイプ 説明
    name 文字列 取得されるパラメーターの名前。これは、プロセッサーフォームのパラメーターエンドポイントにすることができます。
    表 : 10. 返される内容
    タイプ 説明
    オブジェクト パラメーター値。パラメーターが見つからない場合は null を返します。
    var name = g_request.getParameter("x_snc_custom_x_snc_name");

    GlideServletRequest - getParameterNames()

    要求 URI で使用された URL パラメーターのリストを返します。

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    アレイ 文字列としてのパラメーター名のアレイ。
    var paramList = g_request.getParameterNames();

    GlideServletRequest - getQueryString()

    要求からクエリ文字列を返します。

    表 : 13. パラメーター
    名前 タイプ 説明
    なし
    表 : 14. 返される内容
    タイプ 説明
    文字列 クエリー文字列。

    この例では、要求 URL (https://instance.service-now.com/x_custom_app_customApp.do?x_custom_app_name=George&bell=rung) を使用しています。

    var queryString = g_request.getQueryString();
    g_processor.writeOutput("The query string is: " + queryString);
    出力:
    The query string is: x_custom_app_name=George&bell=rung