---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UI 확장점 생성 및 추가

# UI 확장점 생성 및 추가 {#ariaid-title1}

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

애플리케이션을 개발할 때 UI 확장점을 생성하여 HTML 확장과 같은 서버측 UI 매크로 또는 기본 애플리케이션 코드의 UI 페이지에 추가합니다.

UI 확장점을 사용하여 데이터 또는 개체를 등록된 사용자 지정 UI 매크로로 보낼 수 있고 반환된 결과가 처리되는 특정 위치를 지정합니다.

## UI 확장점 생성 {#ariaid-title2}

애플리케이션 코드의 UI 매크로(예: HTML 확장)에 배치할 수 있는 UI 확장점을 만듭니다. UI 확장점을 배치하면 데이터 또는 개체를 사용자 지정으로 보낼 수 있고 데이터가 반환되는 애플리케이션 코드의 특정 위치를 지정합니다.

### 시작하기 전에

필요한 역할: admin 또는 애플리케이션의 개발자 또는 관리자를 위한 특정 역할  
주:  
애플리케이션별 관리자 역할 및 위임된 개발에 대한 자세한 내용은 [애플리케이션 관리 앱의 액세스 제어 규칙](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=australia&pubname=australia-application-development&ft:locale=en-US) 및 [위임된 개발 및 배포](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=australia&pubname=australia-application-development&ft:locale=en-US)를 참조하세요.

### 이 태스크 정보

정의 확장점의 내용과 구조입니다. 이 정의는 커스터마이제이션을 구조화하는 방법, 커스터마이제이션이 애플리케이션 코드와 상호 작용하는 방법 및 확장점에서 커스터마이제이션으로 반환되는 데이터가 처리되는 방식을 설명해야 합니다.

올바른 정의를 만들면 확장의 기능에 대한 구조를 제공할 수 있습니다.

### 프로시저

1. 다음으로 이동 모두시스템 확장점UI 확장점.
2. 새로 만들기를 클릭합니다.
3. 양식에서 필드를 채웁니다.  
   {#create-ui-ext-pt__table_tqn_cfv_s1b__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 이름 | 확장점의 고유한 이름입니다. 이름은 특수 문자를 포함하여 최대 100자의 영숫자일 수 있습니다. |
   | API 이름 | 적용되는 애플리케이션 범위가 선불로 추가되는 확장점 API의 이름입니다. 시스템에서 할당한 이름이므로 변경할 수 없습니다. |
   | 애플리케이션 | 확장점이 할당되는 애플리케이션 범위입니다. 이는 시스템에서 할당한 항목이므로 변경할 수 없습니다. 범위 지정을 사용하여 제공되는 보호에 대한 자세한 내용은 문서를 참조하십시오 [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=australia&pubname=australia-application-development&ft:locale=en-US). |
   | 이 범위로 제한 | 확장점을 애플리케이션 범위로만 제한하는 옵션입니다. |
   | AJAX/REST에 대해 접근 허용 | AJAX 또는 REST를 통한 UI 확장점에 대한 액세스를 활성화하거나 비활성화하는 옵션입니다. 이러한 개발 아키텍처 및 기술에 대한 자세한 내용은 및 [REST API](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")문서를 참조하십시오[아약스](https://servicenow-prod.fluidtopics.net/Ym9FWn5mZHCqzevz6QFtjw#p_AJAX "AJAX(비동기 JavaScript 및 XML)는 비동기 웹 응용 프로그램을 만드는 데 사용되는 상호 관련된 클라이언트 쪽 개발 기술의 그룹입니다."). |
   | 설명 | 사용자 지정 스크립트에 대한 요구 사항이 UI 매크로, 스크립트를 구성하는 방식, 애플리케이션 코드와 함께 작동하는 방식 등 |
   | 예제 | 사용자 지정 UI 매크로를 만드는 방법의 예 이 확장점과 상호 작용하는 것은 애플리케이션 코드와 함께 작동하도록 구조화되어야 합니다. |
   [표 1. UI 확장점 양식]

   {#create-ui-ext-pt__table_tqn_cfv_s1b}
4. 제출을 클릭합니다.
{#create-ui-ext-pt__steps_mfs_mgn_pdb}

## 기본 애플리케이션 코드에 UI 확장점 추가 {#ariaid-title3}

기본 애플리케이션 코드의 UI 매크로 또는 HTML 확장에 UI 확장점을 추가합니다. 확장점을 추가하려면 등록된 사용자 지정 아티팩트가 실행되는 위치를 식별하는 API 호출을 배치합니다.

### 시작하기 전에

필요한 역할: admin 또는 애플리케이션의 개발자 또는 관리자를 위한 특정 역할

애플리케이션 코드의 UI 매크로 또는 UI 페이지에 추가하려면 먼저 UI 확장점을 만들어야 합니다.  
주:  
애플리케이션별 관리자 역할 및 위임된 개발에 대한 자세한 내용은 [애플리케이션 관리 앱의 액세스 제어 규칙](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=australia&pubname=australia-application-development&ft:locale=en-US) 및 [위임된 개발 및 배포](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=australia&pubname=australia-application-development&ft:locale=en-US)를 참조하세요.

### 프로시저

1. 애플리케이션 코드에서 스크립팅된 확장점을 추가하거나 새 확장점을 만들려는 기존 UI 매크로에 액세스합니다.  
   Jelly 태그를 사용하여 UI 매크로를 만드는 방법에 대한 자세한 내용은 해당 문서를 참조하십시오 [UI 매크로](https://servicenow-prod.fluidtopics.net/~i5pOxozTXC72g_L_SQMxw#c_UIMacros "UI 매크로는 관리자가 사용자 인터페이스에 추가할 수 있는 개별 스크립트 구성요소입니다.")[Jelly 태그](https://servicenow-prod.fluidtopics.net/_AkNHYcMZ~92uvNLG~t77A "Jelly를 사용하여 XML을 HTML로 변환합니다.").
2. UI 매크로에서 사용자 지정 UI 매크로 출력을 수집하고 처리할 위치에 코드 줄이 있는 Jelly 태그를 추가합니다.  
   일반적으로 이 코드 줄에는 다음이 포함됩니다.
   * UI 확장점의 이름을 식별하는 `call_extension` 명령입니다(예: `extension="global. KMArticle.ViewHeader")`를 사용합니다.
   * UI 매크로가 렌더링될 때 전달되는 인수입니다. 예를 들어 문서의 지식베이스 경우 `지식기록="${knowledgeRecord}"` 가 현재 지식 기록에 전달됩니다.{#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb}
   {#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb}
   * (선택 사항) 이 확장점의 구현이 여러 개 있는 경우 `limit` 명령을 사용하여 x개의 구현이 반환되도록 지정합니다(예: `limit="1"`). 이 그림은 이러한 명령을 포함하는 UI 매크로를 보여줍니다.

   {#add-ui-ext-pt-base-ui-macro__ul_gxz_4zv_bgb}

{#add-ui-ext-pt-base-ui-macro__steps_mfs_mgn_pdb}