PaCE ポリシーへパラメーターを渡す

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：2分

    • パラメーターを PaCE ポリシーに渡して、オブジェクト (テーブルとドキュメント ID) の更新を検証できます。これらの変数は、ローコードと JavaScript のどちらで作成する場合でも適用されます。ポリシーバージョンには、API 変数、構成パラメーター、レコード参照の 3 種類のパラメーター入力が含まれます。

    API 変数

    API 変数 (旧称：発信者入力) は、開発者による呼び出し時に PaCE API に渡されます。API 変数は、ポリシーが呼び出されるたびにポリシーに値を渡すことができる変数です。API を呼び出すときにこの API 変数の値を指定します。指定しない場合、ポリシーは実行されず、判断は下されません。コードエディターでの変数名は apiVars です。

    PaCE ポリシーごとに、SnapshotId と呼ばれる事前定義された API 変数が 1 つだけ存在します。この API 変数は不変であり、変更または削除することはできません。ポリシーに追加の API 変数を定義することはできません。

    構成パラメーター

    構成パラメーター (旧称：マッピングされた入力) は、ポリシーをオブジェクト (テーブルとドキュメント ID) にマッピングするときに渡すことができます。構成パラメーターを定義すると、ポリシーがマッピングされるたびにポリシーに値を渡すことができるパラメーターが作成されます。必須入力を定義する場合は、ポリシーのマッピング時にこれらの入力の値を指定する必要があります。定義した入力が必須でない場合、ポリシーは実行されず (ステータスは非アクティブに設定され)、判断は下されません。コードエディターでは、変数名は configParams です。

    たとえば、旅費ポリシーの場合、変数を追加してさまざまなタイプの経費の制限を定義できます。制限は、ポリシーをマッピングするときに指定され、このオブジェクトでポリシーが呼び出されたときに経費の制限を設定します。ある従業員グループの朝食費用の限度額を 25 ドルにし、別の従業員グループの朝食費の限度額を 50 ドルにすることができます。ポリシーが呼び出されるたびに、マッピングで指定された制限に従いポリシーによって経費が検証されます。

    レコード参照

    レコード参照は、ServiceNow® テーブルからデータを抽出するクエリを定義し、そのデータを使用してポリシーロジックを設定します。この機能を使用すると、ポリシーの定義中に必要になる可能性のある追加データを取得できます。レコード参照のアグリゲート関数を実行するクエリを定義できます。コード エディターでは、変数名は recordRefs です。

    データコレクター

    データコレクター機能は、ServiceNow または外部データソースから入力プロセスデータを収集して出力します。出力は、意思決定を下すためにポリシーロジックで使用できます。データコレクターを作成、編集、更新し、ポリシービルダーでアクティブ化することで、データコレクターを定義し、管理できます。

    データコレクターにアクセスするには、JavaScript の dataCollectors オブジェクトを使用します。
    注:
    オートコンプリートにより、使用可能なすべての出力とデータコレクタをリストで表示できます。

    ローコードでポリシーを編集している際は、構成されたデータコレクターの出力がドロップダウンメニューに表示されます。