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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間: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 と ダッシュボードメッセージハンドラーの一意の ID が必要です。