ロール API - ServiceNow Fluent

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

    • ロール API は、アプリケーションのユーザーに特定の権限を付与するロール [sys_user_role] を定義します。

    ユーザーロールに関する一般的な情報については、「 Managing roles」を参照してください。

    Role オブジェクト

    アプリケーションとその機能へのアクセスを制御するロール [sys_user_role] を作成します。

    表 : 1. プロパティ
    名前 タイプ 説明
    name 文字列 <scope>.<name> 形式の、アプリケーションスコープで始まるロールの名前。
    assignableBy 文字列 このロールをユーザーにアサインできるその他のロール。
    canDelegate ブール ロールを他のユーザーに委任できるかどうかを示すフラグ。詳細については、「Delegating roles」を参照してください。
    有効な値：
    • true：ロールを他のユーザーに委任できます。
    • false：ロールを他のユーザーに委任することはできません。

    デフォルト：true
    description 文字列 ロールがアクセスできるものの説明。
    昇格した特権 ブール ロールの機能にアクセスする前に、ロールを使用する責任を手動で受け入れる必要があるかどうかを示すフラグ。昇格された権限の詳細については、「昇格された権限ロール」を参照してください。
    有効な値：
    • true：機能にアクセスする前に、ロールを使用する責任を手動で受け入れる必要があります。
    • false：ロールを使用してその機能にアクセスする責任を手動で受け入れる必要はありません。

    デフォルト値：false
    grantable ブーリアン ロールを個別に付与できるかどうかを示すフラグ。
    有効な値：
    • true：ロールを個別に付与できます。
    • false：ロールを個別に付与することはできません。

    デフォルト：true
    ロールを含む アレイ このロールに含まれる他の Role オブジェクトの変数識別子。
    scopedAdmin ブール ロールがアプリケーションアドミニストレーターロールかどうかを示すフラグ。アプリケーション管理ロールの一般的な情報については、「アプリケーション管理」を参照してください。
    有効な値：
    • true：ロールはアプリケーションアドミニストレーターです。
    • false：ロールはアプリケーションアドミニストレーターではありません。

    デフォルト値：false
    $meta オブジェクト アプリケーションメタデータのメタデータ。
    installMethod プロパティを使用すると、特定の状況でのみロードされる出力ディレクトリにアプリケーションメタデータをマップできます。
    $meta: {
      installMethod: 'String'
}
    installMethod の有効な値:
    • demo:[デモデータのロード] オプションが選択されている場合、アプリケーションメタデータを metadata/unload.demo ディレクトリに出力して、アプリケーションとともにインストールします。
    • 初回インストール:アプリケーションがインスタンスに初めてインストールされたときにのみインストールされるように 、アプリケーションメタデータをメタデータ/アンロード ディレクトリに出力します。
    		 
    import { Role } from "@servicenow/sdk/core";

const managerRole = Role({ 
   $id: Now.ID['manager_role'], 
   name: 'x_snc_example.manager' 
})

const adminRole = Role({ 
   $id: Now.ID['admin_role'], 
   name: 'x_snc_example.admin', 
   containsRoles: [managerRole] 
})