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