맵 이벤트 정의

의 UI 빌더 이벤트 매핑은 이벤트 페이로드 또는 상황별 값을 해당 이벤트에 대해 작용하는 객체 또는 핸들러에 매핑할 수 있는 프로세스입니다. 네 가지 이벤트 유형은 구성요소, 페이지, 데이터 자원 및 선언적 작업입니다.

이벤트 매핑은 UI 빌더 내의 중요한 프로세스입니다. 구성요소로 페이지를 빌드하는 경우, 사용자에 대한 작업을 수행하려면 이러한 구성요소가 필요합니다. 예를 들어 페이지에 버튼 구성요소를 추가하는 경우 버튼 클릭 이벤트는 이벤트 핸들러에 매핑되어야 합니다. 이벤트 핸들러는 사용자가 버튼 클릭 작업을 선택하면 해당 작업을 수행합니다. 예를 들면 양식과 같은 데이터 자원을 추가하고 양식이 성공적으로 로드되면 이벤트 핸들러가 사용자에게 알리도록 하는 경우를 들 수 있습니다.

이벤트 유형

사용 가능한 이벤트 유형은 구성요소를 기반으로 합니다. 예를 들어 선언적 작업 이벤트는 작업 표시줄 및 목록 구성요소와 같은 특정 구성요소에 사용할 수 있습니다.

페이지에서 수행하려는 작업에 따라 이벤트 유형을 선택합니다. 예를 들어 웹 페이지를 로드하는 버튼과 같은 작업을 구성요소에 바인딩하려면 구성요소 이벤트를 사용합니다. 페이지에 경보 알림을 추가하는 등 전체 페이지에 이벤트를 적용하려면 페이지 이벤트를 사용합니다. 다음 표에서는 사용할 수 있는 UI 빌더 각 이벤트 유형을 설명하고 이벤트를 사용하는 방법에 대한 몇 가지 예시를 제공합니다.

표 1. 이벤트 유형 및 설명

이벤트 유형	설명
구성요소 이벤트	구성요소에 대해 설정하는 작업입니다. 이벤트 핸들러를 설정하여 해당 구성요소 작업을 구성합니다. 예를 들어 이벤트 핸들러를 추가하여 웹 페이지로 이동하는 것과 같은 버튼에 대한 작업을 적용합니다. 이벤트를 구성요소에 바인딩하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 이벤트를 구성요소에 바인딩.
페이지 이벤트	전체 페이지에 대한 작업을 수행하는 페이지 이벤트입니다. 다음 페이지 이벤트를 구성할 수 있습니다. 페이지 이벤트 매핑입니다. 이러한 이벤트 매핑은 [sys_ux_macroponent] 테이블에서 찾을 수 있는 페이지 정의 기록에 저장됩니다. 이러한 이벤트 매핑에 대한 소스 이벤트는 페이지 준비 및 페이지 속성입니다. 페이지에 대해 정의됩니다. 이러한 이벤트 매핑에 사용할 수 있는 핸들러는 다음과 같습니다. 사용자 세션 이벤트 페이지 수준 이벤트 UXR 앱 셸 데이터 소스 페이지에 정의된 클라이언트 스크립트 로컬 및 상속된 데이터 자원에서의 운영 변형 이벤트 매핑입니다. 이러한 이벤트 매핑은 변형 기록에 저장되며 [sys_ux_screen] 테이블에서 찾을 수 있습니다. 이러한 이벤트 매핑에 대한 소스 이벤트는 페이지에 대해 정의된 디스패치된 이벤트입니다. 이러한 이벤트 매핑에 사용할 수 있는 핸들러는 캔버스 수준 이벤트, UXR 앱 셸 데이터 소스 및 상속된 데이터 자원의 작업입니다. 변형 이벤트 매핑은 페이지의 구성요소에서 디스패치된 이벤트를 사용자 세션 이벤트 핸들러까지 릴레이할 수 있도록 릴레이로 사용됩니다. 매핑은 구성요소의 디스패치된 이벤트를 사용자 세션 핸들러에 매핑했을 때 페이지를 저장하면 자동으로 생성됩니다. 예를 들어, 버튼 클릭 이벤트를 캔버스 수준의 대상 링크 이벤트에 매핑하면 페이지가 저장될 때 이벤트가 디스패치된 릴레이 이벤트와 변형 이벤트 매핑을 생성합니다. 디스패치된 이벤트입니다. 이러한 이벤트는 [sys_ux_event] 테이블에 저장됩니다. 페이지 정의 기록에는 [sys_ux_event] 기록에 대한 참조가 포함되어 있습니다. 이러한 이벤트는 변형 이벤트 매핑의 소스 이벤트 역할을 합니다. +추가를 선택하여 페이지에 대해 새 디스패치된 이벤트를 생성할 수 있습니다. 새 sys_ux_event의 이벤트 이름과 페이로드 필드를 자동으로 채우도록 이벤트 레이블을 구성합니다. 이러한 이벤트는 릴레이 이벤트 매핑을 만드는 데 사용됩니다. 대상 상위 이벤트 핸들러를 선택하여 선택한 이벤트 이후에 페이로드 필드를 모델링할 수 있습니다. 디스패치된 이벤트에 대한 페이로드 필드를 수동으로 생성할 수도 있습니다. 처리된 이벤트입니다. 이러한 이벤트는 [sys_ux_event] 테이블에 저장됩니다. 페이지 정의 기록에는 [sys_ux_event] 기록에 대한 참조가 포함되어 있습니다. 이러한 이벤트는 페이지 이벤트 매핑의 소스 이벤트 역할을 합니다. +추가를 선택하여 페이지에 대해 새 디스패치된 이벤트를 생성할 수 있습니다. 처리된 이벤트는 상위 이벤트 핸들러를 모델링하지 않습니다. 처리된 이벤트의 페이로드 필드는 수동으로 생성됩니다. 기존 핸들러의 페이로드 필드를 템플릿으로 사용하려면 템플릿을 선택하고 필요에 따라 필드를 편집합니다. 이벤트를 페이지에 바인딩하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 이벤트를 페이지에 바인딩.
데이터 자원 이벤트	데이터를 가져오는 시기에 대한 알림을 제공하기 위해 데이터 자원에 매핑되는 이벤트입니다. 데이터 가져오기가 시작되었습니다. 데이터 자원 이벤트가 트리거되면 이벤트 핸들러가 데이터 가져오기 프로세스를 실행합니다. 데이터 임포트에 성공했습니다. 데이터 자원 이벤트가 트리거되면 이벤트 핸들러는 데이터 가져오기가 성공적으로 완료되면 사용자에게 알리는 프로세스를 실행합니다. 데이터 임포트에 실패했습니다. 데이터 자원 이벤트가 트리거되면 이벤트 핸들러는 데이터 가져오기가 실패한 경우 사용자에게 알리는 프로세스를 실행합니다. 이벤트를 데이터 자원에 바인딩하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 이벤트를 데이터 자원에 바인딩.
선언적 작업 이벤트	내에서 UI 빌더 데이터 요소를 바인딩하여 선언적 작업에 이벤트 작업을 추가합니다. 선언적 작업 할당 테이블에서 선언적 작업 이벤트 매핑을 구성합니다 ServiceNow AI Platform® . 예를 보려면 다음으로 이동하십시오. 탐색기 필터링 > sys_declarative_action_assignment.list 그런 다음 기존 선언적 작업을 검색하여 엽니다. UI 빌더에서 이벤트를 선언적 작업에 바인딩합니다. 선언적 작업 이벤트를 사용하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 이벤트를 선언적 작업에 바인딩.