> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# エンベッドされたビューエクスペリエンスのフィルターオプション

## はじめに

エンベッドされたビューエクスペリエンスでは、いくつかのフィルターオプションを使用することができます。以下のグループに分類されます。

* セキュリティー保護されたフィルター
  * Personalized Data Permission（PDP）
  * サーバー側のプログラムによるフィルター
* クライアント側のフィルター
  * JS APIフィルター + pフィルターのURLパラメーター
* インターフェースフィルター
  * ページフィルター
  * カード間のインタラクションフィルター

これらのフィルタータイプはすべて以下の順序で階層化されています。

## セキュリティー保護されたフィルター

1. **Personalized Data Permissions（PDP）**

   ドキュメント： [SSOとPDP](https://developer.domo.com/docs/embed/sso-and-pdp-for-embed)

   定義：従来のSSO統合は、各閲覧ユーザーの個別アカウントのCookieに依存していました。

   使用事例：閲覧ユーザーが表示することも編集することもできない、Domoインターフェースで定義された行レベルのセキュリティーの強制。

   <Warning>
     **重要** ：ブラウザーによるサードパーティのCookieのブロックが拡大されてきています。ベストプラクティスは、将来に備えて、プログラムによるフィルターを使用することです。
   </Warning>

<Note>
  **注記** ：この従来の方法をどうしてもパーソナライゼーションに使用する必要がある場合は、エンベッド閲覧ユーザーがiframeを逆にトレースしてインスタンスにたどり着いたり、エンベッドされたコンテンツ以外のカードやページが表示されたりしないように保護してください。これを行うには、外部の使用事例向けに専用のインスタンスを作成し、機能スイッチのWhite Label V1テンプレートを適用し、メインの内部インスタンスの代わりにそこからエンベッドします。
</Note>

2. **サーバー側のプログラムによるフィルター**

   ドキュメント： [プログラムによるフィルター](https://developer.domo.com/docs/embed/programmatic-filtering)

   定義：すべての閲覧ユーザーに対する単一のサービスアカウントを介したCookieレス認証との新しいSSO統合。

   使用事例：閲覧ユーザーが表示することも編集することもできない、サーバー側コードで定義された行レベルのセキュリティーの強制。

   <Warning>
     **重要：** これにより、単一のサービスアカウントがすべての閲覧ユーザーのプロキシとして機能するため、契約はユーザー/閲覧ユーザーの料金体系からインプレッション/閲覧の料金体系に移行します。
   </Warning>

<Note>
  **注記：** 閲覧ユーザーはサービスアカウントのクライアントIDと秘密にアクセスできないため、このアプローチでは専用の外部インスタンスは必要ありません。そのため、iframeをトレースしてDomoインスタンスにアクセスすることはできません。
</Note>

## クライアント側のフィルター

3. **JS APIフィルター**

   ドキュメント： [JSサンプルコードリポジトリ-JS APIフィルター](https://github.com/domoinc/domo-node-embed-filters/blob/master/public/jsapi.js)

   定義： このクライアント側アプローチは、閲覧ユーザーが表示して編集できることを目的としているため、上記のサーバー側アプローチとは対照的です。このフィルターは、イベントポートとリスナーを介してエンベッドAPIから適用されます。iframeを強制的に更新することなく、エンベッドされたコンテンツの複数の項目に変更が適用されます。双方向のコンテキストの受け渡しもサポートしています（iframe間またはページ間ドリル、リンク、インタラクション用に、エンベッドされたコンテンツ上のクリックイベントをホームページに渡すことも可能）。

   使用事例：ホストページから外部フィルターコントロール（iframeの外にあるドロップダウンメニューなど）を適用する新しいアプローチ。

   <Warning>
     **重要：** pフィルターとJS APIは、プログラムによるフィルターの安全な代替方法にはなりません。閲覧ユーザーがURLを見たりコンテンツを調べることで、クライアント側のパラメーターを表示および変更できるためです。これらは調査のためのフィルターにのみ使用してください。
   </Warning>

4. **pフィルターURLパラメーター**

   ドキュメンテーション： pフィルターを使用して、URLクエリパラメーターからエンベッドされたダッシュボードにフィルターを適用する

   定義：JS APIフィルターのようなクライアント側コードではなく、URLパラメーターでのよりシンプルな設定。ただし、pフィルターではiframeを強制的に更新してフィルターロジックを適用するため、速度が若干遅くなります。これらは、クライアント側のJS APIやサーバー側のプログラムによるフィルターと同じフィルターパターン（列、オペランド、値）を使用します。

   使用事例：外部フィルターコントロールを適用するための従来の古いアプローチ。

   <Warning>
     **重要：** pフィルターとJS APIは、プログラムによるフィルターの安全な代替方法にはなりません。閲覧ユーザーがURLを見たりコンテンツを調べることで、クライアント側のパラメーターを表示および変更できるためです。これらは調査のためのフィルターにのみ使用してください。
   </Warning>

   ## インターフェースフィルター

5. **ページフィルター**

   ドキュメンテーション： [フィルタービューを使用してページレベルのフィルターを適用する](/s/article/360042923914)

   定義：Domoインスタンス全体で利用可能なものと同様の、エンベッドされたカードとダッシュボードの上部のフィルターバー。

   使用事例：閲覧ユーザーが詳しく調べる可能性のあるスライスを作成者がすべて把握しているわけでない場合の、ユーザーによるアドホックなフィルター作成。

   <Warning>
     **重要：** ページフィルターはダッシュボードエンベッドで利用できますが、保存されたフィルタービューはまだベータ版であるため、2021年後半までダッシュボードエンベッドではサポートの対象外です。
   </Warning>

<Note>
  **注記：** 上記のレイヤーシーケンスで強調されているように、これらの優先度の低いフィルターは、PDPまたはプログラムによるフィルターによって利用可能になった行のサブセット内でのみ結果を返すことができます。
</Note>

6. **カード間のインタラクションフィルター**

   ドキュメンテーション： [カード間フィルターを適用する](/s/article/360042923914)

   定義：Domoインスタンス全体で利用できるカード間インタラクションに類似するスライサーカード。

   使用事例：これらは閲覧ユーザーにとって最もシンプルなフィルターインタラクションです。コンテンツ作成者が、ユーザーが必要とするフィルターをすでに把握している場合に最適です。

   <Note>
     **注記：** 上記のレイヤーシーケンスで強調されているように、これらの優先度の低いフィルターは、PDPまたはプログラムによるフィルターによって利用可能になった行のサブセット内でのみ結果を返すことができます。
   </Note>

日本語