# クロスフィルタ

{% hint style="warning" %}
この機能はベータ版です。仕様については予告なく変更となる場合がございます。
{% endhint %}

クロスフィルタ機能を利用することで、特定のチャートで凡例・軸を絞り込んだ場合の表示対象を複数のチャートに同期することができます。

絞り込みはフロントエンド上で読み込まれたデータを対象に行われるため、フィルタの変更で追加のジョブの実行は発生しません。

## 動作

* 設定を行ったチャートを対象に凡例・軸の選択状況が同期されます
  * チャート上の凡例を選択した場合：選択した内容の凡例のデータのみが表示されます
  * チャートの表示内容にマウスオーバーした場合：マウスオーバーしている凡例のハイライトが同期されます
  * 軸を範囲選択した場合：選択した範囲のデータのみが表示されます

## 設定方法

* グリッドページ上のチャートにマウスオーバーした際に表示される右上のメニューからクロスフィルタを選択します
* `キー`を設定します
  * 同じ値で同期を行いたいチャートに対して、同一の`キー`を設定します
  * 選択したチャートに応じて「軸」「凡例」それぞれに`キー`を設定できます
    * テーブルチャートの場合は対象としたいカラム毎に`キー`を設定します

## 仕様

* 対象のチャート
  * XYチャート
  * XYZチャート
  * 円形チャート
  * ファンネルチャート
  * テーブルチャート
    * その他のチャートでの選択状況はテーブルチャートに反映されますが、テーブルチャート側での絞り込み内容はその他のチャートに反映されません
* 絞り込まれるデータの範囲
  * フロントエンド上に読み込まれたデータを対象に絞り込みを行います
  * SQLの再実行は行われないため、XYチャートの軸単位で表示するデータの期間を絞り込んだ場合の絞り込みを円グラフの集計に反映させるといったことはできません
* 凡例の絞り込み
  * 選択された凡例名の値の「文字列 or 数値」を元に絞り込みを行います
* 軸の絞り込み
  * 選択された軸の下限・上限の「文字列 or 数値」を元に範囲で絞り込みを行います

## 注意事項

* 凡例→軸の連携
  * 軸単位でのデータの表示対象は範囲での指定となります
  * そのため凡例側で複数の凡例を選択した場合、選択した凡例のみでなく、選択した凡例の範囲に含まれる対象が表示されます
* 軸→軸の連携
  * 軸が文字列で設定されている場合、範囲指定が表示順の影響を受けるため、表示順が異なっていると正しく連動されません


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.codatum.jp/data-exploration/notebook/grid-page/cross-filter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
