Pass global filters to the dashboard page template

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

    • Global filters are sent to the dashboard to serve as filters for the visualizations within the dashboard. These filters are merged with existing filters in the dashboard.

    이 태스크 정보

    Global filters are filters that apply to visualizations on the target dashboard. These filters apply to all relevant data visualizations. The format of the value passed to globalFilter is the stringified form of {encodedQueries: 'encoded-queries-string', filters: 'PAR-Filter'}. Both encodedQueries and filters are transformed into Platform Analytics filters internally and merged with the existing filters on the dashboard.
    Either encodedQueries, filters, or both can be specified. In the following example, equivalent encodedQueries and filters values both filter visualizations that show records from the Incident [incident] table based on a State field value of 1 or 2:
    JSON.stringify({
    encodedQueries: {incident: 'stateIN1,2'},
    parFilters: [{ order: 0, apply_to: ['incident.state'], values: ['1', '2'] }]
})

    Configure links to dashboards on UI Builder pages to open dashboards that are already filtered.

    시작하기 전에

    Role required: admin

    프로시저

    1. Navigate to the UI Builder page that you want to add a global filter to.
    2. Configure the behavior of the hyperlink or button (or something else) on the page to point to the dashboard with the specified sys_ID.
      In this example, the sys_ID is 1238.

      The showInfoMessage parameter, if true, shows the configured infoMessage on the linked dashboard when filters are passed.

      api.emit('NAV_ITEM_SELECTED', {
        route: 'dashboards',
        params: {
            sysId: '1238',
            unifiedFilters: JSON.stringify({
                showInfoMessage: true, // default false
                infoMessage: 'custom info message', // if not passed and if showInfoMessage is true then the default message is displayed
                encodedQueries: {
                    incident: 'priority=1'
                },
            })
        }
    });