역할 API - ServiceNow Fluent

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분

    • 역할 API는 애플리케이션의 사용자에게 특정 권한을 부여하는 역할 [sys_user_role]을 정의합니다.

    주:
    최신 ServiceNow Fluent API 설명서 및 예제는 ServiceNow Fluent API 참조 및 ServiceNow SDK 예제 리포지토리 는 의 위치에 있습니다 GitHub.

    사용자 역할에 대한 일반적인 정보는 다음 문서를 참조하십시오 Managing roles.

    역할 객체

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

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

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

    기본값: false
    부여 가능 부울 역할을 독립적으로 부여할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 역할이 독립적으로 부여될 수 있습니다.
    • false: 역할을 독립적으로 부여할 수 없습니다.

    기본값: true
    포함역할 배열 이 역할에 포함된 다른 역할 객체의 변수 식별자입니다.
    scoped관리자 부울 역할이 애플리케이션 관리자 역할인지 여부를 나타내는 플래그입니다. 애플리케이션 관리 역할에 대한 일반 정보는 다음 문서를 참조하십시오 애플리케이션 관리.
    유효한 값은 다음과 같습니다.
    • 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] 
})