이벤트를 다른 페이지에 연결

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 이벤트 작업이 다른 페이지를 열 수 있도록 대상 UI 빌더 이벤트 핸들러에 대한 링크를 추가합니다. 원하는 페이지로 가는 앱 경로를 따르도록 이벤트 핸들러를 구성할 수도 있습니다.

    시작하기 전에

    사용자가 클릭할 때 다른 페이지를 열도록 의도된 구성요소가 포함된 작업 공간 페이지가 있어야 합니다. 대시보드 개요는 이러한 구성요소의 예입니다. 대상에 대한 링크와 같은 구성요소는 대상 이벤트 핸들에 대한 링크를 지원하지 않습니다. 구성요소 링크 속성은 대상 이벤트 핸들러에 대한 링크보다 우선합니다.

    필요한 역할: ui_builder_admin

    이 태스크 정보

    다른 페이지를 열도록 이벤트 작업을 구성하려면 열려는 페이지, 해당 페이지에 필요한 매개변수 및 선택적 매개변수, 필수 매개변수를 대상 페이지에 전달하기 위해 이벤트 핸들러에 설정할 페이로드 값을 알아야 합니다.

    팁:
    기본 에이전트 작업 공간 환경에서 연결하려는 구성요소와 연결하려는 대상 페이지의 예를 모두 찾을 수 있습니다. 이 기능은 넥스트 경험 다음에 제공됩니다.기본 시스템 페이지 템플릿에서 페이지를 만드는 경우에는 템플릿의 내용만 복사해야 합니다. 참조하지 마십시오. 페이지 템플릿 복사와 참조의 차이점에 대한 자세한 내용은 다음 문서를 참조하십시오 템플릿에서 페이지 생성.

    프로시저

    1. 에서 경험을 UI 빌더엽니다.
    2. 옵션: 대상 페이지가 환경에 없는 경우 생성합니다.
      페이지 생성에 대한 자세한 내용은 다음 문서를 참조하십시오 UI 빌더에서 페이지 생성. 페이지를 대상으로 사용할 수 있도록 페이지에 대한 필수 및 선택적 매개변수를 설정해야 합니다. 페이지의 특정 구성요소가 대상인 경우 해당 구성요소를 포함해야 합니다. 또한 @context.props.<parameter-name> 값으로 페이지 매개변수를 사용하도록 구성요소의 속성을 구성해야 합니다.

      페이지 템플릿에서 페이지를 만드는 것을 고려할 수 있습니다. 기본 에이전트 작업 공간 환경에는 다른 구성요소의 대상으로 이미 구성된 여러 페이지 템플릿이 있습니다. 템플릿에서 대상 페이지를 만드는 경우 구성요소가 이미 올바른 속성으로 구성되어 있습니다. 필요한 상태 매개변수 또는 클라이언트 스크립트도 복사됩니다. 페이지 매개변수를 추가해야 합니다. 페이지 템플릿이 포함된 경험의 에이전트 앱 구성 [sys_ux_app_config] 기록에 있는 UX 앱 경로 관련 목록에서 이러한 매개변수를 복사할 수 있습니다.

      생성 중인 페이지가 환경에서 대상으로 안정적으로 작동하도록 하려면 경험에 페이지 템플릿 경험과 동일한 앱 셸 UI가 있어야 합니다.

    3. 대상 페이지에 연결하려는 페이지로 전환합니다.
    4. 관련 구성요소를 탐색하여 선택합니다.
    5. 이벤트 탭을 선택합니다.
    6. + 이벤트 매핑 추가를 선택합니다.
    7. 사용할 이벤트를 선택합니다.
    8. + 이벤트 핸들러 추가를 선택합니다.
    9. 상속된 이벤트 핸들러 섹션에서 대상에 대한 링크를 선택합니다.
      대상 상속 이벤트 핸들러에 대한 링크를 가리키는 화살표.
    10. 대상 선택을 클릭합니다.
      대상 선택 버튼을 가리키는 화살표.
    11. 페이지를 확장하고 연결하려는 경험에서 페이지를 선택합니다.
      경로가 연결되는 대상 페이지의 각 매개변수에 대한 필드가 나타납니다. 필수 매개변수는 별표(*)로 표시됩니다.
    12. 각 필수 매개변수 필드와 해당 매개변수 필드를 적절한 @payload.* 값으로 완료합니다.
      구성요소 개발자가 이벤트에 기본 페이로드 값을 포함한 경우 자동 완성을 통해 하나를 선택할 수 있습니다. 다음 예와 같이 페이로드 값이 매개변수 이름과 일치하지 않을 수 있습니다.

      자동 완성을 사용하여 UUID 매개변수 필드의 @payload.indicator_sysId 속성을 선택합니다.

      주:
      앱 경로를 지정하는 대신 외부 URL에 연결하는 옵션이 있습니다.

      기본값이 제공되지 않거나 일부 필드에 대해 올바른 값을 확인할 수 없는 경우 다음의 구성요소에 대한 구성 및 API 설명서를 참조하십시오.ServiceNow® Developer 사이트 그래도 필요한 @payload.* 값을 찾을 수 없는 경우 에 문의하십시오 고객 서비스 및 지원.

      팁:
      기본 에이전트 작업 공간 페이지 템플릿에서 페이지를 만들어 링크 구성요소를 만드는 경우 구성요소에는 대상에 연결 릴레이 이벤트 핸들러가 포함됩니다. 이러한 이벤트 핸들러는 작동하지 않습니다. 그러나 매개변수에 적용 가능한 @payload.* 값이 포함되어 있습니다.

    분석 Q&A 구성요소에 대한 이벤트 핸들러 구성

    새 페이지를 가져와 넥스트 경험 분석 Q&A 구성요소가 포함된 페이지를 추가하려고 한다고 가정해 보겠습니다. 먼저 기본 에이전트 작업 공간 환경에서 제공되는 분석 센터 페이지 템플릿에서 페이지를 만듭니다. 다음으로 분석 Q&A에서 세 가지 이벤트 중 첫 번째 이벤트에 대한 대상 페이지를 만든 다음 해당 이벤트에 대한 이벤트 핸들러를 구성합니다.

    다음으로 이동하여 Now Experience 프레임워크 > 경험에 테스트 경험 UX 애플리케이션이 표시됩니다. 기본 에이전트 작업 공간과 동일한 에이전트 작업 공간 앱 셸 UI를 사용하므로 기본 에이전트 작업 공간의 페이지 템플릿을 사용할 수 있습니다.

    UX 애플리케이션 목록입니다.

    그런 다음 테스트 작업 공간 관리자 패널을 선택하고 UX 앱 경로나 페이지가 없는 UX 앱 구성 기록을 찾은 다음 열기를 클릭합니다.

    분석 Q&A 1 구성요소를 선택하고 이벤트 탭을 엽니다. 여기에서 보고서 시각화 클릭 이벤트에 대한대상에 연결 릴레이 이벤트 핸들러를 열 수 있습니다. 분석 Q&A의 질문에서 보고서를 반환하면 보고서의 값을 클릭하여 이 이벤트를 트리거할 수 있습니다. 값을 클릭하면 이 값에 기여하는 기록 목록도 표시됩니다. 경로 필드에서 대상은 단순 목록 페이지 템플릿을 기반으로 하는 페이지일 것으로 예상됩니다. 또한 @payload.* 값이 해당하는 페이지의 매개변수와 제목 필드를@payload.listTitle로 채울 수 있음을 확인할 수 있습니다.

    표 1. 제안된 단순 목록 대상 페이지의 매개변수 및 해당 페이로드
    매개변수 @payload.* 값
    테이블(필수) @payload.table
    listTitle @payload.listTitle
    쿼리 @payload.query
    disableInlineEditing 없음

    대상 릴레이 이벤트 핸들러입니다.

    다음으로 다음으로 메뉴 > 페이지 만들기 을 클릭하고 단순 목록 템플릿을 기반으로 하는 페이지를 생성합니다. 페이지의 이름을 기록 목록으로 지정한다고 가정해 보겠습니다. 그런 다음 분석 센터 페이지를 만들 때와 유사한 프로세스를 따릅니다. 이번에는 프로세스의 마지막 단계에서 table 을 필수 매개변수로 추가하고 listTitle, query 및 disableInlineEditing 을 선택적 매개변수로 추가합니다.

    페이지 만들기 마법사의 마지막 페이지입니다.

    이 페이지에는 목록 구성요소가 이미 포함되어 있으므로 이 구성요소의 구성 탭을 열면 매개변수가 이미 @context.props.* 값에 전달된 것을 볼 수 있습니다.

    목록 구성요소의 구성 탭입니다.

    이제 분석 센터 페이지로 돌아갑니다. 보고서 시각화 클릭 이벤트에서 새 이벤트 핸들러를 추가합니다. 다음으로, 생성한 기록 목록 페이지를 선택하고 대상에 연결 릴레이 이벤트 핸들러에서 가져온 정보에 따라 테이블, listTitle 및 쿼리 필드에 @payload.* 값을 추가합니다. 예측 입력은 이러한 필드를 채우는 데 도움이 됩니다.

    대상 이벤트 핸들러에 대한 링크에 대한 탐색 구성.

    확인을 클릭하고 @payload.listTitle을 제목으로 추가하면 이벤트 처리기가 완료됩니다. 이제 이 이벤트에 대한대상에 연결 릴레이 이벤트 핸들러를 삭제할 수 있습니다.