---
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) 소요 시간: 4분

속성 API는 인스턴스 동작을 제어하는 시스템 속성\[sys_properties\]을 정의합니다.
주:  
최신 ServiceNow Fluent API 설명서 및 예제는 [ServiceNow Fluent API 참조](https://servicenow.github.io/sdk/) 및 [ServiceNow SDK 예제 리포지토리](https://github.com/ServiceNow/sdk-examples) 는 의 위치에 있습니다 GitHub.

시스템 속성에 대한 일반적인 정보는 다음 문서를 참조하십시오 [Add a system property](https://www.servicenow.com/docs/access?context=t_AddAPropertyUsingSysPropsList&version=australia&pubname=australia-platform-administration&ft:locale=en-US).
**관련 개념**   

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

## 속성 객체 {#ariaid-title2}

애플리케이션의 양상을 구성하기 위한 시스템 속성 \[sys_properties\]을 추가합니다.
{#property-object-now-ts__table_vy2_525_jq__entry__3}{#property-object-now-ts__now-id-desc2}

| 이름 | 유형 | 설명 |
|-|-|-|
| $id | 문자열 또는 숫자 | 필수 메타데이터 객체의 고유 ID입니다. 애플리케이션을 빌드할 때 이 ID는 고유한 sys_id으로 해시됩니다. 자세한 내용은 [ServiceNow Fluent 언어 구성](https://servicenow-prod.fluidtopics.net/bd4_Ogu8TJjhKosNwonOfw "ServiceNow Fluent 언어 구문은 API를 사용하여 ServiceNow Fluent 소스 코드에서 개발하기 위한 추가 기능을 제공합니다.") 문서를 참조하십시오. 형식: `Now.ID['문자열' 또는 숫자]` |
| 이름 | 문자열 | 필수 애플리케이션 범위로 시작하는 속성의 이름이며 <kbd class="ph userinput">&lt;scope&gt;.&lt;name&gt;</kbd> 형식입니다. |
| 값 | 모두 | 속성에 대한 값입니다. 값은 올바른 데이터 유형이어야 합니다. 모든 속성 값은 문자열로 저장됩니다. gs.getProperty() 메서드를 통해 속성을 검색할 때 결과를 문자열로 처리하십시오. 예를 들어, true\|false 속성은 부울값이 아닌 'true' 또는 'false'(문자열)를 반환합니다. |
| 유형 | 문자열 | 속성 값의 데이터 유형입니다. 유효한 값: 문자열, 정수, 부울, 선택 목록, 색상, date_format, 이미지, 암호, password2, short_string, time_format, 시간대, uploaded_image |
| 설명 | 문자열 | 속성이 수행하는 작업에 대한 설명입니다. |
| 선택 | 배열 | 쉼표로 구분된 선택 값 목록입니다. 이 속성은 유형 속성이 `선택 목록`으로 설정된 경우에만 적용됩니다. 다른 선택 레이블과 값이 필요한 경우 등호(=)를 사용하여 레이블과 값을 분리합니다. 예를 들어, `['Blue=0000FF', 'Red=FF0000', 'Green=00FF00']` 는 목록에 파란색, 빨간색 및 녹색 을 표시하고 해당하는 16진수 값은 속성 값 필드에 저장합니다. |
| 역할 | 객체 | 역할 객체의 변수 식별자 또는 속성에 대한 읽기 또는 쓰기 권한이 있는 역할의 이름입니다. 예: roles: { read: [activity_admin, 'app_user'], write: [admin] } 자세한 내용은 [역할 API - ServiceNow Fluent](https://servicenow-prod.fluidtopics.net/p7a0JJeQZFTB_DlS7zHXUg#role-api-now-ts "역할 API는 애플리케이션의 사용자에게 특정 권한을 부여하는 역할 [sys_user_role]을 정의합니다.") 문서를 참조하십시오. |
| 캐시 무시 | 부울 | 속성 값이 설정될 때 캐시 플러시를 할지 여부를 나타내는 플래그입니다. 시스템은 구성 설정을 위해 데이터베이스를 쿼리하지 않도록 시스템 속성 값을 서버 측 캐시에 저장합니다. 시스템 속성 값을 변경하면 시스템이 시스템 속성 \[sys_properties\] 테이블에 대한 캐시를 플러시합니다. 이 필드를 사용하여 다른 모든 서버 측 캐시에서 이 속성 값을 플러시할지 여부를 결정합니다. 유효한 값은 다음과 같습니다. * true: 시스템에서 일부 서버 쪽 캐시 플러시를 무시하므로 시스템 속성 \[sys_properties\] 테이블에 대한 캐시만 플러시하고 다른 모든 캐시에서 이전 속성 값을 유지합니다. 이 옵션을 사용하면 모든 캐시를 플러시하고 새 속성 값을 검색하는 성능 비용을 방지할 수 있습니다. 일반적으로 한 달에 두 번 이상 자주 변경되는 시스템 속성이 있고 속성 값이 시스템 속성 \[sys_properties\] 테이블 테이블에만 저장되는 경우에만 이 속성을 `true` 로 설정해야 합니다. * false: 시스템이 모든 서버 쪽 캐시를 플러시하고 데이터베이스에서 현재 속성 값을 검색합니다. 모든 캐시가 현재 속성 값을 갖도록 이 속성을 `아니오` 로 설정합니다. {#property-object-now-ts__ul_pcb_vss_pbc} 기본값: false |
| isPrivate | 부울 | 업데이트 세트를 통해 속성을 임포트하지 않도록 제외할지 여부를 나타내는 플래그입니다. 시스템 속성을 비공개로 유지하면 한 인스턴스의 설정이 다른 인스턴스의 값을 덮어쓰지 못하는 것을 방지할 수 있습니다. 예를 들어, 개발 인스턴스의 시스템 속성이 프로덕션 인스턴스와 동일한 값을 사용하는 것을 원하지 않을 수 있습니다. 유효한 값은 다음과 같습니다. * true: 속성이 업데이트 세트에 포함되지 않습니다. * false: 속성이 업데이트 세트에 포함됩니다. {#property-object-now-ts__ul_grl_bts_pbc} 기본값: false |
| $meta | 객체 | 애플리케이션 메타데이터의 메타데이터입니다. installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다. $meta: { installMethod: 'String' } installMethod에 유효한 값: * demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다. * 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다. {#property-object-now-ts__ul_n3q_y3s_42c} |
[표 1. 속성]

{#property-object-now-ts__table_vy2_525_jq}  

    import { Property } from '@servicenow/sdk/core'

    Property({
       $id: Now.ID['1234'],
       name: 'x_snc_app.some.new.prop',
       type: 'string',
       value: 'hello',
       description: 'A new property',
       roles: {
          read: ['admin'],
          write: [adminRole, managerRole],
       },
       ignoreCache: false,
       isPrivate: false,
    })

참조된 역할은 Role 객체를 사용하여 정의됩니다.

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