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

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

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](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=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. UI 확장점 \[sys_ui_extension-point\] 테이블에서 사용자 지정 UI 매크로를 등록할 확장점을 선택합니다.  
   주:  
   이 목록에는 사용자가 만든 UI 확장점과 함수에 포함된 미리 정의된 UI 확장점(예고객 서비스 관리: 및 현장 서비스 관리)이 ServiceNow AI Platform 포함됩니다.

   미리 정의된 확장점을 포함하는 함수에 대한 자세한 내용은 의 관련 주제 링크를 [확장점을 사용하여 애플리케이션 기능 확장](https://servicenow-prod.fluidtopics.net/hlS~T2BSuFPBR6CRMdrvhw "확장점을 사용하면 원래 애플리케이션 코드를 변경하지 않고도 애플리케이션의 기능을 확장할 수 있습니다. 선택한 ServiceNow AI Platform 애플리케이션에서 사용할 수 있는 기존 확장점을 사용하거나 자체 인스턴스에서 사용자 지정 애플리케이션을 개발할 때 확장점을 추가할 수 있습니다.")참조하십시오.
3. UI 확장점 기록에서 구현 생성 관련 링크를 클릭하여 새 사용자 지정 UI 매크로를 만들고 선택한 UI 확장점에 대해 등록합니다.
4. UI 매크로 양식에서 사용자 지정 코드를 만듭니다.  
   UI 매크로 생성에 대한 자세한 내용은 다음 문서를 참조하십시오 [UI 매크로](https://servicenow-prod.fluidtopics.net/~i5pOxozTXC72g_L_SQMxw#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=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. 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=australia&pubname=australia-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/~i5pOxozTXC72g_L_SQMxw#c_UIMacros "UI 매크로는 관리자가 사용자 인터페이스에 추가할 수 있는 개별 스크립트 구성요소입니다.")
* [확장점을 사용하여 애플리케이션 기능 확장](https://servicenow-prod.fluidtopics.net/hlS~T2BSuFPBR6CRMdrvhw "확장점을 사용하면 원래 애플리케이션 코드를 변경하지 않고도 애플리케이션의 기능을 확장할 수 있습니다. 선택한 ServiceNow AI Platform 애플리케이션에서 사용할 수 있는 기존 확장점을 사용하거나 자체 인스턴스에서 사용자 지정 애플리케이션을 개발할 때 확장점을 추가할 수 있습니다.")