애플리케이션 메뉴 API - ServiceNow Fluent

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 3분

    • 애플리케이션 메뉴 API는 애플리케이션 네비게이터 [sys_app_application]에서 메뉴를 정의합니다.

    애플리케이션 메뉴에 대한 일반적인 정보는 다음 문서를 참조하십시오 애플리케이션 메뉴 생성.

    ApplicationMenu 객체

    애플리케이션 [sys_app_application]에 대한 메뉴를 생성합니다.

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

    형식: Now.ID['문자열' 또는 숫자]
    제목 문자열 필수 애플리케이션 네비게이터의 메뉴 레이블입니다.
    활성 부울 메뉴가 애플리케이션 네비게이터에 표시되는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 메뉴가 나타납니다.
    • false: 메뉴가 숨겨져 있습니다.

    기본값: true
    역할 배열 역할 개체의 변수 식별자 목록 또는 에 액세스할 수 있는 역할 이름입니다. 메뉴. 자세한 내용은 역할 API - ServiceNow Fluent 문서를 참조하십시오.
    범주 참조 탐색 메뉴 스타일을 정의하는 메뉴 범주 [sys_app_category]의 변수 식별자입니다. 메뉴 범주를 정의하려면 을 사용합니다 기록 API - ServiceNow Fluent.

    메뉴 범주에 대한 일반 정보는 다음 문서를 참조하십시오 Customize menu categories.
    힌트 문자열 마우스로 가리킬 때 도구 설명으로 표시되는 메뉴에 대한 간단한 설명입니다.
    설명 문자열 애플리케이션의 기능에 대한 추가 정보입니다.
    이름 문자열 제목이 같은 애플리케이션을 구별하기 위한 내부 이름입니다.
    순서 번호 애플리케이션 네비게이터에서 애플리케이션 메뉴의 상대적 위치입니다.

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

ApplicationMenu({
   $id: Now.ID['my_app_menu'],
   title: 'My App Menu',
   hint: 'This is a hint',
   description: 'This is a description',
   category: appCategory,
   roles: ['admin'],
   active: true,
})
    참조된 범주는 Record 객체를 사용하여 정의됩니다.
    import { Record } from "@servicenow/sdk/core";

export const appCategory = Record({
   table: 'sys_app_category',
   $id: Now.ID[9],
   data: {
      name: 'example',
      style: 'border-color: #a7cded; background-color: #e3f3ff;',
   },
})