プロセッサー

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む2読むのに数分
  • プロセッサーは、任意のサーバーサイド JavaScript コードを実行して TEXT または JSON などを出力できる、カスタマイズ可能な URL エンドポイントを提供します。カスタムプロセッサーの作成は廃止されました。

    注:
    この機能は廃止されました。従来の既存のカスタムプロセッサーは引き続きサポートされますが、新しいカスタムプロセッサーの作成は廃止されました。代わりに、Scripted REST APIs を使用します。
    警告:
    プロセッサーを作成するときは、必ずプロセッサーに固有のパラメーター名を使用してください。たとえば、プロセッサーが法務レコードリストをエクスポートし、必要なパラメーターが受信者のメールアドレスである場合に、「email」といった語をパラメーター名として使用しないでください。プロセッサーの固有度が高いパラメーター名 (legal_export_recipient_email など) を作成します。これに従わずに、id、table、sys_id、service、catalog_id、view などをインスタンスパラメーター名として使用すると、予期しない結果が生じる可能性があります。

    プロセッサーを作成するタイミング

    カスタムプロセッサーを作成しないでください。この機能は廃止されました。カスタムプロセッサーを作成する代わりに REST API を使用してください。残りの情報は既存のプロセッサーのためにのみ残されます。

    プロセッサーフォーム

    フィールド 説明
    名前 プロセッサーの一意の名前。
    タイプ

    プロセッサースクリプトのプログラミング言語。

    次のオプションが含まれます。

    • java:このオプションを選択しないでください
    • スクリプト
    アプリケーション このレコードを含んでいるアプリケーションです。
    アクティブ レコードを有効または無効にするフラグ。
    CSRF 保護 インスタンスが CSRF トークンを使用しない限り、プロセッサーが実行されないように保護するオプション。
    説明 プロセッサーの機能または目的の説明。
    パラメーター

    利用可能な入力パラメーターのリスト。

    URL のパラメーター値を <parameter name>=<parameter value>として指定します。

    注:
    パラメーター名はプロセッサー固有である必要があります。他のプロセッサーが使用する可能性がある一般的なパラメーター名は選択しないでください。プロセッサーで idsys_idtable などの一般的なパラメーター名を使用すると、他の機能が中断させられる可能性があります。これは、そのパラメーターが URL に存在する場合に、プロセッサーの方が優先されるためです。たとえば、id パラメーターを持つプロセッサーは、同じレコード内のパス値に関係なく、ページ識別のためにそのパラメーターに依存する サービスポータル を中断します。
    パス

    このプロセッサーを呼び出すために使用される URI パス。

    URL から次のようにプロセッサーを呼び出します。

    https://<instance name>.service-now.com/<Path>.do

    スクリプト

    システムがこのプロセッサーを呼び出すときに実行される、即時実行関数。

    この関数は、次の API オブジェクトの入力パラメーターを自動的に提供します。

    • g_request
    • g_response
    • g_processor
    保護ポリシー

    このレコードのスクリプトを保護するために使用するポリシー。

    次のオプションが含まれます。

    • なし
    • 読み取り専用
    • 保護