---
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 매크로 등록

# UI 확장점에 대한 사용자 지정 UI 매크로 등록 {#ariaid-title1}

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

응용 프로그램 코드에서 선택한 UI 확장점에 대한 사용자 지정 UI 매크로를 등록합니다.

사용자 지정 UI 매크로를 등록하면 사용자 지정 UI 매크로의 구현에 UI 확장점 정의를 연결하는 확장 인스턴스 기록을 만듭니다.

## 사용자 지정 UI 매크로 등록 {#ariaid-title2}

선택한 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 확장점.
2. UI 확장점 \[sys_ui_extension-point\] 테이블에서 사용자 지정 UI 매크로를 등록할 확장점을 선택합니다.  
   주:  
   이 목록에는 사용자가 만든 UI 확장점과 함수에 포함된 Now Platform 미리 정의된 UI 확장점(예: 고객 서비스 관리 및 현장 서비스 관리)이 포함되어 있습니다.

   사전 정의된 확장점을 포함하는 함수에 대한 자세한 내용은 의 [확장점을 사용하여 애플리케이션 기능 확장](https://servicenow-prod.fluidtopics.net/c9r7bgDA5esLQyPPeA_aQA "확장점을 사용하면 원래 애플리케이션 코드를 변경하지 않고도 애플리케이션의 기능을 확장할 수 있습니다. 선택한 Now Platform 애플리케이션에서 사용할 수 있는 기존 확장점을 사용하거나 자체 인스턴스에서 사용자 지정 애플리케이션을 개발할 때 확장점을 추가할 수 있습니다.")관련 주제 링크를 참조하십시오.
3. UI 확장점 기록에서 구현 생성 관련 링크를 클릭하여 새 사용자 지정 UI 매크로를 만들고 선택한 UI 확장점에 대해 등록합니다.
4. UI 매크로 양식에서 사용자 지정 코드를 만듭니다.  
   UI 매크로 만들기에 대한 자세한 내용은 을 참조하십시오 [UI 매크로](https://servicenow-prod.fluidtopics.net/4gEqiJQ1uBj56PMiKi6LBQ#c_UIMacros "UI 매크로는 관리자가 사용자 인터페이스에 추가할 수 있는 개별 스크립트 구성요소입니다.").
5. 업데이트를 클릭합니다.
{#register-custom-ui-macros-ui-ext-pt__steps_tkt_jtq_qfb}

### 결과

사용자 지정 UI 매크로가 생성되고 UI 확장점에 대해 등록됩니다.

## UI 확장 인스턴스 검토 {#ariaid-title3}

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. UI 확장점 \[sys_ui_extension_point\] 테이블에서 광범위한 인스턴스를 보려는 UI 확장점을 선택합니다.
3. UI 확장점 기록의 구현 관련 목록에서 UI 확장 인스턴스를 선택합니다.  
   시스템에 UI 확장 인스턴스 기록이 표시됩니다.{#review-ui-extension-instances__table_r32_ytq_qfb__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 포인트 | UI 확장점의 고유한 이름입니다. 이름에는 특수 문자를 포함하여 최대 100자의 영숫자만 사용할 수 있습니다. |
   | 클래스 | UI 확장점이 구현되는 애플리케이션 코드의 UI 매크로입니다. |
   | 애플리케이션 | 확장점이 할당되는 애플리케이션 범위입니다. 이는 시스템에서 할당하며 변경할 수 없습니다. 범위 지정을 사용하여 제공되는 보호에 대한 자세한 내용은 을 참조하십시오 [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). |
   | 활성 | 현재 인스턴스의 활성 확장점입니다. 확장점을 비활성화하려면 확인란의 선택을 취소합니다. |
   [표 1. UI 확장 인스턴스 기록]

   {#review-ui-extension-instances__table_r32_ytq_qfb}
4. 제출을 클릭합니다.
{#review-ui-extension-instances__steps_q32_ytq_qfb}
**관련 개념**   

* [UI 매크로](https://servicenow-prod.fluidtopics.net/4gEqiJQ1uBj56PMiKi6LBQ#c_UIMacros "UI 매크로는 관리자가 사용자 인터페이스에 추가할 수 있는 개별 스크립트 구성요소입니다.")
* [확장점을 사용하여 애플리케이션 기능 확장](https://servicenow-prod.fluidtopics.net/c9r7bgDA5esLQyPPeA_aQA "확장점을 사용하면 원래 애플리케이션 코드를 변경하지 않고도 애플리케이션의 기능을 확장할 수 있습니다. 선택한 Now Platform 애플리케이션에서 사용할 수 있는 기존 확장점을 사용하거나 자체 인스턴스에서 사용자 지정 애플리케이션을 개발할 때 확장점을 추가할 수 있습니다.")