이벤트를 다른 페이지에 연결
이벤트 작업이 다른 페이지를 열 수 있도록 대상 UI 빌더 이벤트 핸들러에 대한 링크를 추가합니다. 원하는 페이지로 가는 앱 경로를 따르도록 이벤트 핸들러를 구성할 수도 있습니다.
시작하기 전에
필요한 역할: ui_builder_admin
이 태스크 정보
다른 페이지를 열도록 이벤트 작업을 구성하려면 열려는 페이지, 해당 페이지에 필요한 매개변수 및 선택적 매개변수, 필수 매개변수를 대상 페이지에 전달하기 위해 이벤트 핸들러에 설정할 페이로드 값을 알아야 합니다.
프로시저
-
+ 이벤트 핸들러 추가를 선택합니다.
-
상속된 이벤트 핸들러 섹션에서 대상에 대한 링크를 선택합니다.
-
대상 선택을 클릭합니다.
-
각 필수 매개변수 필드와 해당 매개변수 필드를 적절한
@payload.*값으로 완료합니다.구성요소 개발자가 이벤트에 기본 페이로드 값을 포함한 경우 자동 완성을 통해 하나를 선택할 수 있습니다. 다음 예와 같이 페이로드 값이 매개변수 이름과 일치하지 않을 수 있습니다.주:앱 경로를 지정하는 대신 외부 URL에 연결하는 옵션이 있습니다.기본값이 제공되지 않거나 일부 필드에 대해 올바른 값을 확인할 수 없는 경우 다음의 구성요소에 대한 구성 및 API 설명서를 참조하십시오.ServiceNow® Developer 사이트 그래도 필요한
@payload.*값을 찾을 수 없는 경우 에 문의하십시오 고객 서비스 및 지원.팁:기본 에이전트 작업 공간 페이지 템플릿에서 페이지를 만들어 링크 구성요소를 만드는 경우 구성요소에는 대상에 연결 릴레이 이벤트 핸들러가 포함됩니다. 이러한 이벤트 핸들러는 작동하지 않습니다. 그러나 매개변수에 적용 가능한@payload.*값이 포함되어 있습니다.
분석 Q&A 구성요소에 대한 이벤트 핸들러 구성
새 페이지를 가져와 넥스트 경험 분석 Q&A 구성요소가 포함된 페이지를 추가하려고 한다고 가정해 보겠습니다. 먼저 기본 에이전트 작업 공간 환경에서 제공되는 분석 센터 페이지 템플릿에서 페이지를 만듭니다. 다음으로 분석 Q&A에서 세 가지 이벤트 중 첫 번째 이벤트에 대한 대상 페이지를 만든 다음 해당 이벤트에 대한 이벤트 핸들러를 구성합니다.
다음으로 이동하여 에 테스트 경험 UX 애플리케이션이 표시됩니다. 기본 에이전트 작업 공간과 동일한 에이전트 작업 공간 앱 셸 UI를 사용하므로 기본 에이전트 작업 공간의 페이지 템플릿을 사용할 수 있습니다.
그런 다음 테스트 작업 공간 관리자 패널을 선택하고 UX 앱 경로나 페이지가 없는 UX 앱 구성 기록을 찾은 다음 열기를 클릭합니다.
예시에서 볼 수 있듯이 UI 빌더에서는 Base Agent Workspace의 분석 센터 페이지 템플릿을 기반으로 하는 분석 센터라는 페이지를 생성했습니다. 다음으로 페이지 템플릿의 내용만 복사하는 옵션을 선택합니다.
분석 Q&A 1 구성요소를 선택하고 이벤트 탭을 엽니다. 여기에서 보고서 시각화 클릭 이벤트에 대한대상에 연결 릴레이 이벤트 핸들러를 열 수 있습니다. 분석 Q&A의 질문에서 보고서를 반환하면 보고서의 값을 클릭하여 이 이벤트를 트리거할 수 있습니다. 값을 클릭하면 이 값에 기여하는 기록 목록도 표시됩니다. 경로 필드에서 대상은 단순 목록 페이지 템플릿을 기반으로 하는 페이지일 것으로 예상됩니다. 또한 @payload.* 값이 해당하는 페이지의 매개변수와 제목 필드를@payload.listTitle로 채울 수 있음을 확인할 수 있습니다.
| 매개변수 | @payload.* 값 |
|---|---|
| 테이블(필수) | @payload.table |
| listTitle | @payload.listTitle |
| 쿼리 | @payload.query |
| disableInlineEditing | 없음 |
다음으로 다음으로 을 클릭하고 단순 목록 템플릿을 기반으로 하는 페이지를 생성합니다. 페이지의 이름을 기록 목록으로 지정한다고 가정해 보겠습니다. 그런 다음 분석 센터 페이지를 만들 때와 유사한 프로세스를 따릅니다. 이번에는 프로세스의 마지막 단계에서 table 을 필수 매개변수로 추가하고 listTitle, query 및 disableInlineEditing 을 선택적 매개변수로 추가합니다.
이 페이지에는 목록 구성요소가 이미 포함되어 있으므로 이 구성요소의 구성 탭을 열면 매개변수가 이미 @context.props.* 값에 전달된 것을 볼 수 있습니다.
이제 분석 센터 페이지로 돌아갑니다. 보고서 시각화 클릭 이벤트에서 새 이벤트 핸들러를 추가합니다. 다음으로, 생성한 기록 목록 페이지를 선택하고 대상에 연결 릴레이 이벤트 핸들러에서 가져온 정보에 따라 테이블, listTitle 및 쿼리 필드에 @payload.* 값을 추가합니다. 예측 입력은 이러한 필드를 채우는 데 도움이 됩니다.
확인을 클릭하고 @payload.listTitle을 제목으로 추가하면 이벤트 처리기가 완료됩니다. 이제 이 이벤트에 대한대상에 연결 릴레이 이벤트 핸들러를 삭제할 수 있습니다.
다음 예는 분석 센터 페이지를 보여줍니다. 이 페이지에서 우선순위별 인시던트에 대한 쿼리를 입력하고 결과를 보고서로 가져올 수 있습니다. 또한 열을 클릭하면 보고서 시각화 클릭 이벤트가 트리거됩니다. 이벤트 핸들러를 사용하면 보고서에서 인시던트의 간단한 목록을 볼 수 있습니다.