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

애플리케이션 메뉴 API는 애플리케이션 네비게이터 \[sys_app_application\]에서 메뉴를 정의합니다.
주:  
최신 ServiceNow Fluent API 설명서 및 예제는 [ServiceNow Fluent API 참조](https://servicenow.github.io/sdk/) 및 [ServiceNow SDK 예제 리포지토리](https://github.com/ServiceNow/sdk-examples) 는 의 위치에 있습니다 GitHub.

애플리케이션 메뉴에 대한 일반적인 정보는 다음 문서를 참조하십시오 [애플리케이션 메뉴 생성](https://servicenow-prod.fluidtopics.net/CBKU7r0zJ71WgV5GOCX6bw#t_CreateAnApplicationMenu "애플리케이션 메뉴는 사용자가 애플리케이션 내비게이터에서 액세스할 수 있는 메인 콘텐츠를 정의합니다. 애플리케이션 네비게이터에 표시할 애플리케이션을 구성할 수 있습니다.").
**관련 개념**   

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

## ApplicationMenu 객체 {#ariaid-title2}

애플리케이션 \[sys_app_application\]에 대한 메뉴를 생성합니다.
{#appmenu-object-now-ts__table_vy2_525_jq__entry__3}{#appmenu-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['문자열' 또는 숫자]` |
| 직위 | 문자열 | 필수 애플리케이션 네비게이터의 메뉴 레이블입니다. |
| 활성 | 부울 | 메뉴가 애플리케이션 네비게이터에 표시되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 메뉴가 나타납니다. * false: 메뉴가 숨겨져 있습니다. {#appmenu-object-now-ts__ul_cxj_srr_4bc} 기본값: true |
| 역할 | 배열 | 역할 개체의 변수 식별자 목록 또는 에 액세스할 수 있는 역할 이름입니다. 메뉴. 자세한 내용은 [역할 API - ServiceNow Fluent](https://servicenow-prod.fluidtopics.net/p7a0JJeQZFTB_DlS7zHXUg#role-api-now-ts "역할 API는 애플리케이션의 사용자에게 특정 권한을 부여하는 역할 [sys_user_role]을 정의합니다.") 문서를 참조하십시오. |
| 범주 | 참조 | 탐색 메뉴 스타일을 정의하는 메뉴 범주 \[sys_app_category\]의 변수 식별자입니다. 메뉴 범주를 정의하려면 을 사용합니다 [기록 API - ServiceNow Fluent](https://servicenow-prod.fluidtopics.net/hyuCHlsrqrpWvohjEtzJiA#record-api-now-ts "기록 API는 모든 테이블의 기록을 정의합니다. 기록 API를 사용하여 전용 ServiceNow Fluent API가 없는 애플리케이션 메타데이터를 정의합니다."). 메뉴 범주에 대한 일반 정보는 다음 문서를 참조하십시오 [Customize menu categories](https://www.servicenow.com/docs/access?context=customize-menu-categories&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US). |
| 힌트 | 문자열 | 마우스로 가리킬 때 도구 설명으로 표시되는 메뉴에 대한 간단한 설명입니다. |
| 설명 | 문자열 | 애플리케이션의 기능에 대한 추가 정보입니다. |
| 이름 | 문자열 | 제목이 같은 애플리케이션을 구별하기 위한 내부 이름입니다. |
| 순서 | 번호 | 애플리케이션 네비게이터에서 애플리케이션 메뉴의 상대적 위치입니다. 기본값: 100 |
| $meta | 객체 | 애플리케이션 메타데이터의 메타데이터입니다. installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다. $meta: { installMethod: 'String' } installMethod에 유효한 값: * demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다. * 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다. {#appmenu-object-now-ts__ul_n3q_y3s_42c} |
[표 1. 속성]

{#appmenu-object-now-ts__table_vy2_525_jq}  

    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;',
       },
    })