역할 API - ServiceNow Fluent

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기2분
  • 역할 API에는 애플리케이션의 사용자에 대한 역할 [sys_user_role]을 정의하는 개체가 포함되어 있습니다.

    역할 객체

    역할 생성 [sys_user_role] 애플리케이션 및 해당 기능에 대한 액세스를 제어합니다.

    표 1. 속성
    이름 유형 설명
    $id 문자열 또는 숫자 필수 다음 형식으로 제공되는 메타데이터 개체의 고유 ID입니다. 여기서 <value> 는 문자열 또는 숫자입니다.
    $id: Now.ID[<value>]

    애플리케이션을 빌드할 때 이 ID는 고유한 sys_ID로 해시됩니다.

    이름 문자열 애플리케이션 범위로 시작하는 역할의 이름으로, <scope>.<name> 형식입니다.
    assignable_by 문자열 사용자에게 이 역할을 할당할 수 있는 기타 역할입니다.
    can_delegate 부울 역할을 다른 사용자에게 위임할 수 있는지 여부를 나타내는 플래그입니다. 자세한 내용은 Delegating roles 문서를 참조하십시오.
    유효한 값은 다음과 같습니다.
    • true: 역할을 다른 사용자에게 위임할 수 있습니다.
    • false: 역할을 다른 사용자에게 위임할 수 없습니다.

    기본값: true

    설명 문자열 역할이 액세스할 수 있는 내용에 대한 설명입니다.
    elevated_privilege 부울 역할의 기능에 액세스하기 전에 역할 사용 책임을 수동으로 수락해야 하는지 여부를 나타내는 플래그입니다. 상승된 권한에 대한 자세한 내용은 상승된 권한 역할을 참조하세요.
    유효한 값은 다음과 같습니다.
    • true: 먼저 역할 사용에 대한 책임을 수동으로 수락해야 해당 기능에 액세스할 수 있습니다.
    • false: 역할을 사용하여 해당 기능에 액세스하는 책임을 수동으로 수락할 필요가 없습니다.

    기본값: false

    부여 가능 부울 역할을 독립적으로 부여할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 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] 
    })