대시보드 구성요소 이벤트

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

    • 이벤트 핸들러를 선택하여 대시보드 구성요소와 함께 제공되는 작업(이벤트)을 구성합니다.

    이벤트 탭에는 대시보드 구성 요소에서 사용하는 이벤트가 표시됩니다. 사용 가능한 이벤트를 보려면 + 이벤트 매핑 추가를 선택합니다. 목록에서 이벤트를 선택하여 하나 이상의 이벤트 핸들러를 추가합니다.

    이벤트 핸들러

    이벤트 핸들러는 데이터 자원과 함께 작동하여 사용자에게 표시할 데이터에 대시보드 작업을 연결합니다. 목록에서 이벤트를 선택하여 하나 이상의 이벤트 핸들러를 추가합니다.

    이벤트 설명

    이벤트 설명
    대시보드 개요 페이지로 이동 대시보드가 닫히고 대시보드 라이브러리로 리디렉션될 때 디스패치됩니다. 대시보드 목록 클라이언트 스크립트로 리디렉션에서 경로와 제목을 변경하여 이 동작을 사용자 지정할 수 있습니다. 클라이언트 스크립트를 열려면 페이지의 사이드바에서 <> 아이콘을 선택합니다.
    * @param {params} params
* @param {api} params.api
* @param {any} params.event
* @param {any} params.imports
* @param {ApiHelpers} params.helpers
*/
function handler({api}) {
    api.emit('SCREEN_STATUS_CHANGED', {status: 'closed'});
    api.emit('NAV_ITEM_SELECTED', {
        route: 'dashboard-library',
        title: 'Dashboard Library',
    });
}
    대시보드 위젯 클릭됨
    대시보드의 시각화를 클릭할 때 기본 드릴다운을 사용자 지정 동작으로 재정의하려면 이 이벤트 핸들러를 추가합니다. 대시보드 위젯 클릭됨 클라이언트 스크립트를 사용합니다. 사용자 지정 드릴다운을 추가하려면 다음을 수행합니다.
    1. defaultDrilldowns 속성을 false로 설정합니다.
    2. 대시보드 위젯 클릭됨 이벤트 핸들러를 추가합니다.
    3. 대시보드 위젯 클릭됨 클라이언트 스크립트를 엽니다. 클라이언트 스크립트를 열려면 페이지의 사이드바에서 <> 아이콘을 선택합니다.
    4. 코드 api.emit("NAV_ITEM_SELECTED", payload) 를 찾고 사용자 지정 리디렉션 논리에 맞게 페이로드 를 업데이트합니다.
    URL 매개변수 업데이트 요청됨

    대시보드 구성요소가 일반적으로 URL 매개변수를 업데이트하고 delegateUrlParams예일 때마다 디스패치됩니다. 이 이벤트는 클라이언트 스크립트가 사용자 지정 탐색 논리를 구현하는 데 사용할 수 있는 구조적 매개변수 데이터를 제공합니다.

    URL 매개변수:
    • sysId: 탐색 중인 대시보드의 sys_id입니다. 대시보드가 변경될 때 표시됩니다.
    • tabSysId: 선택한 탭의 sys_id입니다. 탭이 변경될 때 표시됩니다.
    • 편집: 대시보드가 편집 모드인지 여부입니다. 편집 모드가 변경될 때 표시됩니다.
    모든 매개변수에는 다음과 같은 객체 필드가 있습니다.
    • value(string | boolean): 매개변수 값입니다.
    • description(string): 매개변수에 대해 사용자가 읽을 수 있는 설명입니다
    sysId 매개변수에는 다음 객체 필드도 있습니다.
    • dashboardName(문자열): 대시보드의 제목입니다
    • isNewTab(부울): 사용자가 대시보드 선택기에서 Cmd/Ctrl+클릭 또는 가운데 클릭을 수행한 경우 예 로, 새 탭에서 열려는 의도를 나타냅니다. sysId 매개변수에 대해서만 전송되었습니다.
    예제:
    {
  "urlParams": {
    "sysId": {
      "value": "a1b2c3d4e5f6",
      "dashboardName": "Dashboard A",
      "description": "Dashboard sys_id",
      "isNewTab": false
    },
    "tabSysId": {
      "value": "f6e5d4c3b2a1",
      "description": "Tab sys_id"
    },
    "edit": {
      "value": true,
      "description": "Edit mode"
    }
  }
}

    자세한 내용은 대시보드 URL 매개변수 위임 문서를 참조하십시오.

    주:
    이 기능을 사용하려면 의 최신 플랫폼 분석 경험 애플리케이션이 필요합니다.ServiceNow® Store