ロール API - ServiceNow Fluent

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:2分
  • ロール API には、アプリケーションのユーザーのロール [sys_user_role] を定義するオブジェクトが含まれます。

    Role オブジェクト

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

    表 : 1. プロパティ
    名前 タイプ 説明
    $id 文字列または数値 必須。次の形式で提供されるメタデータオブジェクトの一意の ID。ここで、<value> は文字列または数値です。
    $id: Now.ID[<value>]

    アプリケーションをビルドすると、この ID は一意の sys_ID にハッシュされます。

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

    デフォルト:true

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

    デフォルト値:false

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

    デフォルト:true

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

    デフォルト値:false

    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', 
       contains_roles: [managerRole] 
    })