グローバルフィルターをダッシュボードページテンプレートに渡す

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：2分

    • グローバルフィルターがダッシュボードに送信され、ダッシュボード内の可視化のフィルターとして機能します。これらのフィルターは、ダッシュボードの既存のフィルターと結合されます。

    このタスクについて

    グローバルフィルターは、ターゲットダッシュボードの可視化に適用されるフィルターです。これらのフィルターは、関連するすべてのデータ可視化に適用されます。globalFilter に渡される値の形式は、{encodedQueries: 'encoded-queries-string', filters: 'PAR-Filter'} の文字列化された形式です。encodedQueries とフィルターの両方が内部で プラットフォームアナリティクス フィルターに変換され、ダッシュボードの既存のフィルターと結合されます。
    encodedQueries、フィルター、またはその両方を指定できます。次の例では、同等の encodedQueries と filters の値は両方とも、ステータスフィールド値 1 または 2 に基づいてインシデント [incident] テーブルのレコードを表示する可視化をフィルタリングします。
    JSON.stringify({
    encodedQueries: {incident: 'stateIN1,2'},
    parFilters: [{ order: 0, apply_to: ['incident.state'], values: ['1', '2'] }]
})

    UI ビルダーページにダッシュボードへのリンクを設定して、既にフィルタリングされているダッシュボードを開きます。

    始める前に

    必要なロール：admin

    手順

    1. グローバルフィルターを追加する UI ビルダー ページに移動します。
    2. 指定したsys_IDのダッシュボードを指すように、ページ上のハイパーリンクまたはボタン (またはその他のもの) の動作を構成します。
      この例では、sys_IDは 1238 です。

      showInfoMessage パラメーターが true の場合、フィルターが渡されると、リンクされたダッシュボードに構成された infoMessage が表示されます。

      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'
                },
            })
        }
    });