--- 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) 소요 시간: 13분 UI 매크로는 관리자가 사용자 인터페이스에 추가할 수 있는 개별 스크립트 구성요소입니다. 일반적으로 UI 매크로는 기존 필드 유형으로 제공되지 않는 입력 또는 정보를 제공하는 컨트롤입니다. 기본적으로 시스템은 다음과 같은 다양한 사용자 인터페이스 요소에 대한 UI 매크로를 제공합니다. * 모든 포매터 * 서비스 카탈로그 카트 * 필드 옆의 작업 아이콘 * 양식 및 목록의 작업 아이콘 * 콘텐츠 관리 시스템의 위젯 * 오케스트레이션 활동 디자이너 {#c_UIMacros__ul_d4b_dwq_rv} 관리자는 사용자 지정 컨트롤 또는 인터페이스를 제공하기 위해 고유한 UI 매크로를 만들 수 있습니다. UI 매크로를 만들려면 [Jelly 스크립트](http://commons.apache.org/proper/commons-jelly/)에 대한 지식이 필요합니다. 기존 UI 매크로에서 예제와 제안된 접근 방식을 검토합니다. JavaScript 기술로 사용자 지정 인터페이스를 구축하려는 사용자는 대안으로 Service Portal을 고려해야 합니다. 주: 사용 가능한 UI 매크로를 보려면 모든 \> 시스템 UI \> UI 매크로로 이동합니다. ## UI 매크로 기본 사항 {#ariaid-title2} UI 매크로는 사용 가능한 카탈로그 변수 유형을 사용하여 빌드할 수 없는 솔루션을 빌드하는 데 사용할 수 있습니다. ### 액세스 가능한 UI 매크로 {#ui-macro-basics__section_z1m_kty_4zb} UI 매크로 \[ui_macros\] 테이블에서 여러 UI 매크로를 사용할 수 있습니다. 이러한 UI 매크로의 이름은 `ui_` 로 시작하며, UI 페이지에서 사용할 표준 양식 필드 유형의 하위 집합 동작을 에뮬레이트합니다. 예를 들어 ui_date_time UI 매크로는 UI 페이지의 glide_date_time 필드처럼 작동하여 날짜/시간 선택기가 있는 입력 가능 입력 필드를 제공할 수 있습니다. UI 매크로는 \ Jelly 태그가 있는 UI 페이지에 포함될 수 있습니다. 다음 예제에는 UI 매크로에 두 가지 선택적 특성을 제공하는 ui_date_time UI 매크로가 포함되어 있습니다. \ Jelly 태그의 속성 값은 UI 매크로에 jvar 접두어 변수로 제공됩니다. UI 매크로는 XML에서 jvar 접두어가 붙은 변수를 사용할 수 있습니다.{#ui-macro-basics__table_o5n_1nx_qzb__entry__2} | 속성 | JVAR 프리픽스가 붙은 변수 | |-|-| | 이름 | jvar_name | | 값 | jvar_value | | 온체인지(onchange) | jvar_onchange | [표 1. jvar 접두사 변수로 사용되는 Jelly 태그 속성] {#ui-macro-basics__table_o5n_1nx_qzb} 주: 이러한 UI 매크로는 해당 양식 필드 유형의 모든 기능을 지원하기 위한 것은 아닙니다. 대부분의 경우 매크로는 특정 ServiceNow 응용 프로그램 사용 사례에만 사용됩니다. 접두사가 `ui_` UI 매크로에는 UI 페이지의 \ Jelly 태그에 제공할 수 있는(또는 제공해야 하는) 지원되는 특성을 지정하는 설명이 포함되어 있습니다. 사용 가능한 UI 매크로를 보려면 모든\> 시스템 UI \> UI 매크로로 이동합니다. / ### 사용자 지정 UI 매크로 {#ui-macro-basics__section_chz_xhx_qzb} ui_example UI 매크로는 세 가지 jvar 접두어 변수(jvar_name, jvar_test_attribute 및 jvar_laptop_type)를 사용합니다. 이러한 변수는 UI 페이지의 \ Jelly 태그에서 이름, test_attribute 및 laptop_type 속성으로 UI 매크로에 제공될 수 있습니다. ui_example UI 매크로 만들기 : 모든\> 시스템 UI \> UI 매크로로 이동하고 새로 만들기를 선택합니다. 매크로 ui_example 의 이름을 지정하고 XML 필드에 다음 스크립트를 추가합니다.
name jvar: ${jvar_name}
test_attribute jvar: ${jvar_test_attribute}
laptop_type jvar: ${jvar_laptop_type}
 UI 페이지에서 매크로 사용 : 모든\> 시스템 UI \> UI 페이지로 이동하여 새로 만들기를 선택합니다. 관리자 역할을 선택하라는 메시지가 표시됩니다. UI 페이지의 이름을 지정하고 HTML 필드에 다음 스크립트를 추가합니다.
Template include one:
Template include two:
 출력 확인 중 : UI 페이지에서 시도를 클릭하여 결과를 볼 수 있습니다. 주: 매크로를 만들었는데 UI 페이지에 예상대로 표시되지 않는 경우 캐시를 지우면 도움이 될 수 있습니다. 인스턴스의 캐시를 지우려면 브라우저에서 <server_url>/cache.do 를 입력합니다. **관련 참조** * [UI 페이지](https://servicenow-prod.fluidtopics.net/83kTT3Da0CyEsfVK58VDYg#r_UIPages "UI 페이지를 사용하여 폼, 대화 상자, 목록 및 기타 UI 구성요소를 만들고 표시할 수 있습니다.") * [Jelly 태그](https://servicenow-prod.fluidtopics.net/tpIBmZtETYpHcP5Kgmh0Cw "Jelly를 사용하여 XML을 HTML로 변환합니다.") * [\](https://servicenow-prod.fluidtopics.net/gWamckyceTlwkbggc3_~fw#r_GUIForm "이 태그는 UI 페이지의 양식을 정의합니다.") * [\](https://servicenow-prod.fluidtopics.net/gWamckyceTlwkbggc3_~fw#r_GUIInputField "이 태그는 사용자가 정보를 입력할 수 있는 페이지에 입력 필드를 만드는 UI 매크로에 대한 참조를 추가합니다. ui_input_field는 레이블, 이름, 값 및 크기를 UI 매크로에 전달합니다.") * [\](https://servicenow-prod.fluidtopics.net/gWamckyceTlwkbggc3_~fw#r_GUICheckbox "이 태그는 페이지에 사용자가 편집할 수 있는 확인 표시를 합니다. 이름과 값은 UI 매크로에 전달됩니다.") ## UI 매크로 호출 {#ariaid-title3} 관리자는 사용자 인터페이스와 관련된 특정 레코드 종류에서 UI 매크로를 호출할 수 있습니다. {#r_CallingUIMacros__table_j2v_pzq_rv__entry__2} | 기록 유형 | 예제 | |-|-| | 딕셔너리 속성 | 참조 필드에 대한 아이콘 표시: ref_contributions=ui_macro_name | | UI 페이지 | UI 페이지에 항목 표시: | | UI 매크로 | 다른 UI 매크로에서 UI 매크로 호출: | [표 2. 기록 유형별로 UI 매크로 호출] {#r_CallingUIMacros__table_j2v_pzq_rv} ## UI 매크로 양식 {#ariaid-title4} 각 UI 매크로 기록은 Jelly 코드로 작성된 이름과 XML 문서로 구성됩니다. {#r_UIMacroForm__table_sx5_bhr_rv__entry__2} | 필드 | 설명 | |-|-| | 이름 | 이 매크로에 대한 고유하고 설명적인 이름입니다. | | 활성 | 정의된 대로 요소를 렌더링하려면 확인란을 선택합니다. 코드를 삭제하지 않고 요소를 비활성화하려면 확인란의 선택을 취소합니다. 예를 들어, email_reply 매크로는 기본적으로 비활성 상태입니다. | | 설명 | 매크로의 목적과 매크로에 전달된 매개변수를 설명합니다. | | XML | 매크로를 정의하는 Jelly 스크립트입니다. | [표 3. UI 매크로 필드] {#r_UIMacroForm__table_sx5_bhr_rv} ## 사용자 지정 승인 UI 매크로 {#ariaid-title5} 이 섹션에서는 사용자 지정 승인 UI 매크로를 만드는 방법에 대해 설명합니다. 경고: 여기서 설명하는 사용자 지정은 특정 인스턴스에서 사용하도록 개발되었으며, Now Support에서 지원되지 않습니다. 이 메서드는 있는 그대로 제공되며 구현 전에 철저히 테스트되어야 합니다. 이 사용자 지정에 대한 모든 질문과 의견을 커뮤니티 [포럼](http://community.service-now.com/)에 게시합니다. 스크립트 이름: 사용자 지정 승인 UI 매크로 유형: UI 매크로 설명: 다음은 실행 계획의 내 승인 뷰에서 자세한 정보를 얻을 수 있는 옵션입니다. 이 작업은 새 UI 매크로를 만들어 수행할 수 있습니다. 시스템 UI로 이동하여 UI 매크로를 클릭합니다. 먼저 기존 `approval_summarizer_sc_task` 의 이름을 `approval_summarizer_sc_task_old` 와 같은 이름으로 바꾸고 비활성화해야 합니다. 그런 다음 동일한 이름(`approval_summarizer_sc_task`)을 사용하여 새 이름을 만들어야 합니다. 이름은 기본적으로 매크로가 수행하는 작업과 적용 대상을 알려주어야 합니다. 이 경우 기존 이름을 대체하므로 기존 이름을 다시 사용하기로 결정했습니다. 그림 1. 승인 매크로 그런 다음 이 문서의 맨 아래에 있는 xml 스크립트를 새 UI 매크로의 xml 코드 창에 복사해야 합니다. 이는 Service Catalog 실행 계획 내의 승인 작업을 통해 라인 항목 승인을 수행할 때 승인자에게 몇 가지 세부 정보를 제공하기에 좋은 방법입니다. ### 예전 방식 이전 방법으로 승인 작업을 사용할 때 내 승인에 표시되는 뷰입니다. 그림 2. 내 승인(이전 방식) 승인자에게 실제로 승인하는 내용을 알려주는 세부 정보는 많지 않습니다. 작업에 대한 짧은 설명은 볼 수 있지만 항목이 무엇인지에 대해서는 잘 볼 수 없습니다. ### 새로운 길 OOB(바로 사용 가능) UI 매크로 대신 아래의 xml 스크립트를 사용하는 경우 표시되는 뷰입니다. 그림 3. 내 승인 이 방법을 사용하면 요청 승인과 유사한 세부 정보를 볼 수 있습니다. 주문한 품목에 대한 링크, 간단한 설명(품목에서 변수를 확장하는 기능 포함), 가격, 수량 및 총 가격이 있습니다. 이렇게 하면 더 자세한 정보를 표시한다는 점에서 승인자에게 도움이 됩니다. 이제 실제로 승인하는 내용을 볼 수 있습니다. 스크립트:
${sc_task.request_item.request.opened_by.getDisplayValue()}
${sc_task.request_item.request.requested_for.getDisplayValue()}
${sc_req_labels.number.sys_meta.label} ${sc_req_labels.description.sys_meta.label} ${sc_req_labels.price.sys_meta.label} ${sc_req_labels.quantity.sys_meta.label} ${gs.getMessage('Total')}
${sc_task.request_item.number} ${sc_task.request_item.quantity}