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