---
sourceDocument: 호주 애플리케이션 빌드 또는 수정
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/application-development

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 애플리케이션 빌드 또는 수정

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# 역할 API

# 역할 API - ServiceNow Fluent {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

역할 API는 애플리케이션의 사용자에게 특정 권한을 부여하는 역할 \[sys_user_role\]을 정의합니다.
주:  
최신 ServiceNow Fluent API 설명서 및 예제는 [ServiceNow Fluent API 참조](https://servicenow.github.io/sdk/) 및 [ServiceNow SDK 예제 리포지토리](https://github.com/ServiceNow/sdk-examples) 는 의 위치에 있습니다 GitHub.

사용자 역할에 대한 일반적인 정보는 다음 문서를 참조하십시오 [Managing roles](https://www.servicenow.com/docs/access?context=ua-creating-roles&version=australia&pubname=australia-platform-administration&ft:locale=en-US).
**관련 개념**   

* [ServiceNow Fluent](https://servicenow-prod.fluidtopics.net/LkgjsL6Ogxn6hUPsJ73QXQ "도메인별 프로그래밍 언어를 사용하여 소스 코드에서 애플리케이션 메타데이터를 정의합니다.ServiceNow Fluent")

## 역할 객체 {#ariaid-title2}

애플리케이션 및 해당 기능에 대한 액세스를 제어하는 역할 \[sys_user_role\]을 생성합니다.
{#role-object-now-ts__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 애플리케이션 범위로 시작하는 역할의 이름이며 <kbd class="ph userinput">&lt;scope&gt;.&lt;name&gt;</kbd> 형식입니다. |
| assignableBy | 문자열 | 사용자에게 이 역할을 할당할 수 있는 다른 역할입니다. |
| canDelegate | 부울 | 역할을 다른 사용자에게 위임할 수 있는지 여부를 나타내는 플래그입니다. 자세한 내용은 [Delegating roles](https://www.servicenow.com/docs/access?context=c_DelegateRoles&version=australia&pubname=australia-platform-administration&ft:locale=en-US) 문서를 참조하십시오. 유효한 값은 다음과 같습니다. * true: 역할을 다른 사용자에게 위임할 수 있습니다. * false: 역할을 다른 사용자에게 위임할 수 없습니다. {#role-object-now-ts__ul_fjr_cc5_pbc} 기본값: true |
| 설명 | 문자열 | 역할이 액세스할 수 있는 항목에 대한 설명입니다. |
| 권한 상승 | 부울 | 역할의 기능에 액세스하기 전에 역할 사용의 책임을 수동으로 수락해야 하는지 여부를 나타내는 플래그입니다. 상승된 권한에 대한 자세한 내용은 [상승된 권한 역할을 참조하세요.](https://www.servicenow.com/docs/access?context=c_ElevatedPrivilege&version=australia&pubname=australia-platform-security&ft:locale=en-US) 유효한 값은 다음과 같습니다. * true: 해당 기능에 액세스하려면 먼저 역할 사용에 대한 책임을 수동으로 수락해야 합니다. * false: 기능에 액세스하기 위해 역할을 사용하는 책임을 수동으로 수락할 필요가 없습니다. {#role-object-now-ts__ul_ukv_qd5_pbc} 기본값: false |
| 부여 가능 | 부울 | 역할을 독립적으로 부여할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 역할이 독립적으로 부여될 수 있습니다. * false: 역할을 독립적으로 부여할 수 없습니다. {#role-object-now-ts__ul_gb2_zd5_pbc} 기본값: true |
| 포함역할 | 배열 | 이 역할에 포함된 다른 역할 객체의 변수 식별자입니다. |
| scoped관리자 | 부울 | 역할이 애플리케이션 관리자 역할인지 여부를 나타내는 플래그입니다. 애플리케이션 관리 역할에 대한 일반 정보는 다음 문서를 참조하십시오 [애플리케이션 관리](https://servicenow-prod.fluidtopics.net/vOPRcctowsWwW0uqeOsRRg "애플리케이션 관리를 사용하여 사용자가 애플리케이션 특정 역할을 획득하는 방법을 제한함으로써 중요한 애플리케이션 데이터를 보호합니다."). 유효한 값은 다음과 같습니다. * true: 역할이 애플리케이션 관리자입니다. * false: 역할이 애플리케이션 관리자가 아닙니다. {#role-object-now-ts__ul_nxt_325_pbc} 기본값: false |
| $meta | 객체 | 애플리케이션 메타데이터의 메타데이터입니다. installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다. $meta: { installMethod: 'String' } installMethod에 유효한 값: * demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다. * 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다. {#role-object-now-ts__ul_n3q_y3s_42c} |
[표 1. 속성]

{#role-object-now-ts__table_vy2_525_jq}  

    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] 
    })