クロススコープ特権 API - ServiceNow Fluent

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • Cross-Scope Privilege API は、実行時アクセス追跡のクロススコープ特権 [sys_scope_privilege] を定義します。

    注:
    最新の ServiceNow Fluent API ドキュメントと例については、 ServiceNow Fluent API リファレンス および ServiceNow SDK のサンプルリポジトリ ( GitHub)。

    アドミニストレーターは、実行時のアクセス追跡により、実行を許可するスクリプト操作とターゲットのリストを作成して、アプリケーション リソースに対するスクリプト アクセスを管理できます。クロススコープ特権に関する一般的な情報については、「 クロススコープ特権レコード」を参照してください。

    CrossScopePrivilege オブジェクト

    システムがアプリケーションで実行できるスクリプト操作とターゲットを決定するクロススコープ権限 [sys_scope_privilege] を構成します。

    表 : 1. プロパティ
    名前 タイプ 説明
    $id 文字列または数値 必須。メタデータオブジェクトの一意の ID。アプリケーションをビルドすると、この ID は一意のsys_idにハッシュされます。詳細については、「ServiceNow Fluent 言語構成」を参照してください。

    形式: Now.ID['string' or number]
    ステータス 文字列 必須。このレコードの認証。
    有効な値：
    • requested (要求済み)
    • allowed
    • denied
    操作 文字列 必須。スクリプトがターゲットに対して実行する操作。ターゲット タイプによって、使用可能な操作が決まります。

    テーブル [sys_db_object] は、読み取り、書き込み、作成、および削除操作をサポートしています。スクリプトインクルード [sys_script_include] とスクリプトオブジェクト [sys_db_object] は、実行操作のみをサポートします。

    有効な値：
    • create
    • delete
    • read
    • 書き込み
    • 実行
    ターゲット名 文字列 必須。要求されているテーブル、スクリプトインクルード、またはスクリプト オブジェクトの名前。
    ターゲットスコープ 文字列 必須。リソースが要求されるアプリケーションスコープ。
    ターゲットタイプ 文字列 必須。要求のタイプ:スクリプトインクルード、スクリプトオブジェクト、またはテーブル。
    有効な値：
    • sys_script_include
    • スクリプト可能
    • sys_db_object
    $meta オブジェクト アプリケーションメタデータのメタデータ。
    installMethod プロパティを使用すると、特定の状況でのみロードされる出力ディレクトリにアプリケーションメタデータをマップできます。
    $meta: {
      installMethod: 'String'
}
    installMethod の有効な値:
    • demo:[デモデータのロード] オプションが選択されている場合、アプリケーションメタデータを metadata/unload.demo ディレクトリに出力して、アプリケーションとともにインストールします。
    • 初回インストール:アプリケーションがインスタンスに初めてインストールされたときにのみインストールされるように 、アプリケーションメタデータをメタデータ/アンロード ディレクトリに出力します。
    		 
    import { CrossScopePrivilege } from '@servicenow/sdk/core'

CrossScopePrivilege({
   $id: Now.ID['cross_1'],
   status: 'allowed',
   operation: 'execute',
   targetName: 'Script type',
   targetScope: 'x_snc_example',
   targetType: 'scriptable',
})