맵 이벤트 정의

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기4분
  • 의 이벤트 매핑 UI 빌더 은 이벤트의 페이로드 또는 상황별 값을 해당 이벤트에 대해 작동하는 객체 또는 핸들러에 매핑할 수 있도록 하는 프로세스입니다. 네 가지 이벤트 유형은 구성요소, 페이지, 데이터 자원 및 선언적 작업입니다.

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

    이벤트 유형

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

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

    표 1. 이벤트 유형 및 설명
    이벤트 유형 설명
    구성요소 이벤트 구성요소에 대해 설정한 작업입니다. 이벤트 핸들러를 설정하여 해당 구성요소 작업을 구성합니다. 예를 들어 이벤트 핸들러를 추가하여 웹 페이지로 이동하는 등 버튼에 대한 작업을 적용할 수 있습니다. 이벤트를 구성 요소에 바인딩하는 방법에 대한 자세한 내용은 을 참조하십시오 구성요소에 이벤트 바인딩.
    페이지 이벤트 전체 페이지에 대한 작업을 수행하는 페이지 이벤트입니다. 다음 페이지 이벤트를 구성할 수 있습니다.
    • 페이지 이벤트 매핑입니다.
      • 이러한 이벤트 매핑은 페이지 정의 기록에 저장되며, 이 기록은 [sys_ux_macroponent] 테이블에서 찾을 수 있습니다.
      • 이러한 이벤트 매핑에 대한 소스 이벤트는 페이지 준비 및 페이지 속성입니다. 페이지에 대해 정의됩니다.
      • 이러한 이벤트 매핑에 사용할 수 있는 핸들러는 다음과 같습니다.
        • 사용자 세션 이벤트
        • 페이지 수준 이벤트
        • UXR 앱 셸 데이터 소스
        • 페이지에 정의된 클라이언트 스크립트
        • 로컬 및 상속된 데이터 자원의 운영
    • 변형 이벤트 매핑.
      • 이러한 이벤트 매핑은 [sys_ux_screen] 테이블에서 찾을 수 있는 변형 기록에 저장됩니다.
      • 이러한 이벤트 매핑에 대한 소스 이벤트는 페이지에 대해 정의된 디스패치된 이벤트입니다.
      • 이러한 이벤트 매핑에 사용할 수 있는 핸들러는 캔버스 수준 이벤트, UXR 앱 셸 데이터 소스 및 상속된 데이터 자원의 작업입니다.
      • 변형 이벤트 매핑은 페이지의 구성 요소에서 디스패치된 이벤트를 사용자 세션 이벤트 핸들러까지 릴레이할 수 있도록 릴레이로 사용됩니다.
      • 구성요소의 디스패치된 이벤트를 사용자 세션 핸들러에 매핑한 경우 페이지 저장 시 매핑이 자동으로 생성됩니다. 예를 들어, Button clicked 이벤트를 캔버스 수준의 Link to destination 이벤트에 매핑하면 이벤트가 디스패치된 릴레이 이벤트와 페이지가 저장될 때 변형 이벤트 매핑을 생성합니다.
    • 디스패치된 이벤트입니다.
      • 이러한 이벤트는 [sys_ux_event] 테이블에 저장됩니다. 페이지 정의 레코드에는 [sys_ux_event] 레코드에 대한 참조가 포함되어 있습니다.

      • 이러한 이벤트는 변형 이벤트 매핑의 소스 이벤트 역할을 합니다.

      • +추가를 선택하여 페이지에 대해 디스패치된 새 이벤트를 만들 수 있습니다. 이벤트 레이블을 구성하여 새 sys_ux_event의 이벤트 이름과 페이로드 필드를 자동으로 채웁니다.

      • 이러한 이벤트는 릴레이 이벤트 매핑을 생성하는 데 사용됩니다. 대상 상위 이벤트 핸들러를 선택하여 선택한 이벤트 후에 페이로드 필드를 모델링할 수 있습니다. 디스패치된 이벤트에 대한 페이로드 필드를 수동으로 생성할 수도 있습니다.

    • 처리된 이벤트.
      • 이러한 이벤트는 [sys_ux_event] 테이블에 저장됩니다. 페이지 정의 레코드에는 [sys_ux_event] 레코드에 대한 참조가 포함되어 있습니다.

      • 이러한 이벤트는 페이지 이벤트 매핑의 소스 이벤트 역할을 합니다.

      • +추가를 선택하여 페이지에 대해 디스패치된 새 이벤트를 만들 수 있습니다. 처리된 이벤트는 부모 이벤트 처리기 이후에 모델링되지 않습니다. 처리된 이벤트에 대한 페이로드 필드는 수동으로 생성됩니다. 기존 핸들러의 페이로드 필드를 템플릿으로 사용하려면 템플릿을 선택하고 필요에 따라 필드를 편집합니다.

    페이지, 변형, 디스패치됨 및 처리된 이벤트가 옵션을 추가하는 페이지 수준 이벤트 창입니다.

    이벤트를 페이지에 바인딩하는 방법에 대한 자세한 내용은 을 참조하십시오 페이지에 이벤트 바인딩.
    데이터 자원 이벤트 데이터를 가져오는 시기에 대한 알림을 제공하기 위해 데이터 자원에 매핑되는 이벤트입니다.
    • 데이터 가져오기가 시작되었습니다. 데이터 자원 이벤트가 트리거되면 이벤트 핸들러가 데이터 가져오기 프로세스를 실행합니다.
    • 데이터 임포트 성공. 데이터 자원 이벤트가 트리거되면 이벤트 핸들러는 데이터 가져오기가 성공적으로 완료되면 사용자에게 알리는 프로세스를 실행합니다.
    • 데이터 가져오기에 실패했습니다. 데이터 자원 이벤트가 트리거되면 이벤트 핸들러는 데이터 가져오기에 실패한 경우 사용자에게 알리는 프로세스를 실행합니다.

    데이터 자원에 대한 이벤트 옵션입니다.

    이벤트를 데이터 자원에 바인딩하는 방법에 대한 자세한 내용은 을 참조하십시오 데이터 자원에 이벤트 바인딩.
    선언적 작업 이벤트

    선언적 작업에 이벤트 작업을 추가하기 위해 내부 UI 빌더 의 데이터 요소를 바인딩합니다.

    선언적 작업 할당 테이블에서 선언적 작업 이벤트 매핑을 Now Platform® 구성합니다. 예를 들어, 탐색기 필터링 > sys_declarative_action_assignment.목록 그런 다음 기존 선언적 작업을 검색하여 엽니다.

    에서 UI 빌더이벤트를 선언적 작업에 바인딩합니다. 선언적 작업 이벤트를 사용하는 방법에 대한 자세한 내용은 을 참조하십시오 이벤트를 선언적 작업에 바인딩.