속성 API - ServiceNow Fluent

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

    • 속성 API는 인스턴스 동작을 제어하는 시스템 속성[sys_properties]을 정의합니다.

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

    시스템 속성에 대한 일반적인 정보는 다음 문서를 참조하십시오 Add a system property.

    속성 객체

    애플리케이션의 양상을 구성하기 위한 시스템 속성 [sys_properties]을 추가합니다.

    표 1. 속성
    이름 유형 설명
    $id 문자열 또는 숫자 필수 메타데이터 객체의 고유 ID입니다. 애플리케이션을 빌드할 때 이 ID는 고유한 sys_id으로 해시됩니다. 자세한 내용은 ServiceNow Fluent 언어 구성 문서를 참조하십시오.

    형식: Now.ID['문자열' 또는 숫자]
    이름 문자열 필수 애플리케이션 범위로 시작하는 속성의 이름이며 <scope>.<name> 형식입니다.
    값 모두 속성에 대한 값입니다. 값은 올바른 데이터 유형이어야 합니다.

    모든 속성 값은 문자열로 저장됩니다. 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 문서를 참조하십시오.
    캐시 무시 부울 속성 값이 설정될 때 캐시 플러시를 할지 여부를 나타내는 플래그입니다.

    시스템은 구성 설정을 위해 데이터베이스를 쿼리하지 않도록 시스템 속성 값을 서버 측 캐시에 저장합니다. 시스템 속성 값을 변경하면 시스템이 시스템 속성 [sys_properties] 테이블에 대한 캐시를 플러시합니다. 이 필드를 사용하여 다른 모든 서버 측 캐시에서 이 속성 값을 플러시할지 여부를 결정합니다.

    유효한 값은 다음과 같습니다.
    • true: 시스템에서 일부 서버 쪽 캐시 플러시를 무시하므로 시스템 속성 [sys_properties] 테이블에 대한 캐시만 플러시하고 다른 모든 캐시에서 이전 속성 값을 유지합니다. 이 옵션을 사용하면 모든 캐시를 플러시하고 새 속성 값을 검색하는 성능 비용을 방지할 수 있습니다. 일반적으로 한 달에 두 번 이상 자주 변경되는 시스템 속성이 있고 속성 값이 시스템 속성 [sys_properties] 테이블 테이블에만 저장되는 경우에만 이 속성을 true 로 설정해야 합니다.
    • false: 시스템이 모든 서버 쪽 캐시를 플러시하고 데이터베이스에서 현재 속성 값을 검색합니다. 모든 캐시가 현재 속성 값을 갖도록 이 속성을 아니오 로 설정합니다.

    기본값: false
    isPrivate 부울 업데이트 세트를 통해 속성을 임포트하지 않도록 제외할지 여부를 나타내는 플래그입니다.

    시스템 속성을 비공개로 유지하면 한 인스턴스의 설정이 다른 인스턴스의 값을 덮어쓰지 못하는 것을 방지할 수 있습니다. 예를 들어, 개발 인스턴스의 시스템 속성이 프로덕션 인스턴스와 동일한 값을 사용하는 것을 원하지 않을 수 있습니다.

    유효한 값은 다음과 같습니다.
    • true: 속성이 업데이트 세트에 포함되지 않습니다.
    • false: 속성이 업데이트 세트에 포함됩니다.

    기본값: false
    $meta 객체 애플리케이션 메타데이터의 메타데이터입니다.
    installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다.
    $meta: {
      installMethod: 'String'
}
    installMethod에 유효한 값:
    • demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    • 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    		 
    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] 
})