カスタムの インタラクティブ フィルター

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：2分

    • 管理者は、スクリプトによるインタラクティブ フィルター ウィジェットを作成して、ダッシュボード レポートに高度なフィルター オプションを提供することができます。

    カスタムインタラクティブフィルターを使用すると、フィルターインターフェイスとフィルタリングロジックを制御できます。特定のニーズに合ったフィルターを作成します。カスタムインタラクティブフィルターには、1 回のクリックで複数の一般的なフィルター操作を実行するフィルターが含まれます。

    カスタムフィルターは、DashboardMessageHandler JavaScript クラスを使用してレポートフィルターを定義および公開する、スクリプト化されたシステム UI ウィジェットです。

    必要なロール：hp_publisher_admin および report_admin。hp_publisher_adminロールは、コア UI でインタラクティブフィルターを管理する場合にのみ存在します。デフォルトでは、 プラットフォームアナリティクス エクスペリエンスに移行されるコア UI フィルターを管理するためのanalytics_filter_adminロールが含まれています。

    注:
    カスタムインタラクティブフィルター用に公開された API は制限されており、標準のインタラクティブフィルターと同等の機能を提供しません。カスタムインタラクティブフィルターを実装する前に、 カスタムインタラクティブフィルターの制限を確認してください。

    テーブル API のアクセス制御リストにより、ダッシュボードのフィルタリング時に表示されるレコードが制限される場合があります。この問題を軽減するには、テーブル API アクセス制御リストにユーザーまたはロールを追加します。詳細については、「アクセス制御リストルール」を参照してください。

    フィルターを公開するコードは、 SNC.canvas.interactiveFilters.setDefaultValue() メソッドを呼び出す必要があり、 dashboardMessageHandler.publishFilter() メソッドを呼び出してフィルターを公開する必要があります。

    Jelly を使用して、利用可能なボタンなどのウィジェットの外観を定義します。

    同じダッシュボードに複数のカスタムインタラクティブフィルターを追加できます。フィルターには、フィルターオブジェクトに一意の ID があり、 DashboardMessageHandlerに一意の ID が必要です。