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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UI 확장점 만들기 및 추가

# UI 확장점 만들기 및 추가 {#ariaid-title1}

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

응용 프로그램을 개발할 때 UI 확장점을 만들어 HTML 확장점과 같은 서버측 UI 매크로나 기본 응용 프로그램 코드의 UI 페이지에 추가합니다.

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

## UI 확장점 만들기 {#ariaid-title2}

애플리케이션 코드의 HTML 확장명과 같은 UI 매크로에 배치할 수 있는 UI 확장점을 만듭니다. UI 확장점을 배치하면 데이터 또는 개체를 사용자 지정으로 보낼 수 있고 데이터가 반환되는 응용 프로그램 코드의 특정 위치를 지정할 수 있습니다.

### 시작하기 전에

필요한 역할: admin 또는 애플리케이션 개발자 또는 관리자를 위한 특정 역할  
주:  
응용 프로그램별 관리자 역할 및 위임된 개발에 대한 자세한 내용은 [응용 프로그램 관리 앱의 액세스 제어 규칙](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) 및 [위임된 개발 및 배포](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-application-development&ft:locale=en-US). |
   | 이 범위로 제한 | 확장점을 애플리케이션 범위로만 제한하는 옵션입니다. |
   | AJAX/REST에 대해 접근 허용 | AJAX 또는 REST를 통해 UI 확장점에 대한 액세스를 활성화하거나 비활성화하는 옵션입니다. 이러한 개발 아키텍처 및 기술에 대한 자세한 내용은 및 [REST APIs](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.")을 참조하십시오[AJAX](https://servicenow-prod.fluidtopics.net/n4KOEBxPJiV65G3QHc1_pw#p_AJAX "AJAX(비동기 JavaScript 및 XML)는 비동기 웹 응용 프로그램을 만드는 데 사용되는 상호 관련된 클라이언트 쪽 개발 기술 그룹입니다."). |
   | 설명 | 지정 스크립트에 대한 요구 사항 UI 매크로, 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 매크로 또는 UI 페이지에 추가할 수 있습니다.  
주:  
응용 프로그램별 관리자 역할 및 위임된 개발에 대한 자세한 내용은 [응용 프로그램 관리 앱의 액세스 제어 규칙](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) 및 [위임된 개발 및 배포](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US)를 참조하세요.

### 프로시저

1. 애플리케이션 코드에서 스크립팅된 확장점을 추가하거나 새로 만들려는 기존 UI 매크로에 액세스합니다.  
   jelly 태그를 사용하여 UI 매크로를 만드는 방법에 대한 자세한 내용은 해당 문서를 [Jelly 태그](https://servicenow-prod.fluidtopics.net/tpIBmZtETYpHcP5Kgmh0Cw "Jelly를 사용하여 XML을 HTML로 변환합니다.")참조하십시오[UI 매크로](https://servicenow-prod.fluidtopics.net/4gEqiJQ1uBj56PMiKi6LBQ#c_UIMacros "UI 매크로는 관리자가 사용자 인터페이스에 추가할 수 있는 개별 스크립트 구성요소입니다.").
2. UI 매크로에서 사용자 지정 UI 매크로 출력을 수집하고 처리할 것으로 예상되는 위치에 코드 라인이 있는 jelly 태그를 추가합니다.  
   일반적으로 이 코드 줄에는 다음이 포함됩니다.
   * UI 확장점의 이름을 식별하는 `call_extension` 명령입니다(예: `extension="global. KMArticle.ViewHeader"`)를 사용하여 사용자 지정 UI 매크로를 등록할 수 있습니다.
   * UI 매크로가 렌더링될 때 UI 매크로에 전달되는 인수입니다. 예를 들어 문서의 경우 지식베이스`knowledgerecord="${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}