OACビジュアライゼーションの可視性パラメータとは？

# はじめに
OAC（**Oracle Analytics Cloud**）November 2024 Updateから、ビジュアライゼーションのプロパティに「可視性パラメータ」が追加されています。
簡単に言うと、そのビジュアライゼーションを表示または非表示にするための条件をパラメータから受け取る機能です。

具体的な設定方法を紹介します。

# サンプルワークブックの作成
ダッシュボード・フィルタをパラメータに関連付け、そのパラメータをビジュアライゼーションの「可視性パラメータ」に指定してみます。

まずは、Sample Order Linesデータセットを使用して新規にワークブックを作成します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/dd853fab-be7f-db59-b926-5ba7dbfd648d.png)

「Order Priority」と「Profit」でドーナツ・チャートを作成しましたが、何でもOKです。

## パラメータの作成
「パラメータ」に移動し「メニュー」から「パラメータの作成」をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/a62c00d8-d550-6e88-e02f-edcf047d1155.png)

次のように入力して、「OK」をクリックします。

|プロパティ|値|
|:-|:-|
|名前|Order Priority|
|データ型|テキスト|
|複数選択を許可|ON（許可）|
|使用可能な値|列（Order Priority）|

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/5c2f72d1-f359-189c-edee-989daebb5ed6.png)

ワークブックに、Order Priorityパラメータが作成されました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/d78c4335-46cd-5efb-9741-400808782782.png)

「ビジュアライゼーション」タブから、ダッシュボード・フィルタをキャンバスにドラッグ＆ドロップします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/985dbfff-8f7f-ca35-d3a0-e3141927a006.png)

ドラッグ＆ドロップしたダッシュボード・フィルタに先ほど作成したOrder Priorityパラメータをドラッグ＆ドロップします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/ae9b2cdf-b8ce-c1d9-de32-7c1a1ff401ab.png)

こんな感じになりました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/49491685-1501-ccc5-c25d-64701c3c0c75.png)

## ビジュアライゼーションのプロパティを設定
ドーナツ・チャートの「フィルタ」に「Order Priority」列をドラッグ＆ドロップします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/b6507d49-c117-3651-f478-8372b64acc5d.png)

「Order Priority」パラメータをバインドします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/14041b4e-9f4f-68fd-41e3-00b2f2419421.png)

ドーナツ・チャートのプロパティを確認します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/cb3a3d83-f121-0d5b-c65a-3aac31744059.png)

デフォルトでは「なし」になっている可視性パラメータを変更します。
「Order Priority」パラメータを選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/d6b254ef-7502-dca8-3e8a-66c5341ba2f3.png)

設定アイコンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/6bf9ba27-b805-c617-c63b-ae4a9170055c.png)

条件をサブセットにして、「High」「Low」を選択しました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/8b3149ed-afb7-540a-7212-0e27fe6aec2e.png)

ここまでの設定をまとめると、
- ドーナツ・チャートに「Order Priority」列をフィルタ項目として追加しました
- フィルタを「Order Priority」パラメータにバインドしました（フィルタとパラメータの値が連動します）
- ドーナツ・チャートの可視性パラメータとして「Order Priority」パラメータを指定しました
- 条件は「サブセット」で、値は「High」または「Low」です

# プレビューモードでテスト

:::note
可視性パラメータによるビジュアライゼーションの表示および非表示は、プレビューモードで動作します。
:::

ワークブックをプレビューにします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/68395297-3e89-e4c6-a6c2-dd1f0be44688.png)

このようなキャンバスが表示されました。
**Order Priorityパラメータに何も選択しない場合**
ドーナツ・チャートは非表示です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/e959b523-f43d-a5b5-1b0e-eec7e817b628.png)

**Order Priorityを「High」にした場合**
指定した値がパラメータにセットされたので、ドーナツ・チャートが表示されました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/307fb807-328c-ee48-fc69-7cee887b5432.png)

**Order Priorityを「High」「Low」にした場合**
指定した値がパラメータにセットされたので、ドーナツ・チャートが表示されました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/82b4100b-1754-a6a2-450c-551237e60443.png)

**Order Priorityを「High」「Low」「Medium」にした場合**
指定した値がパラメータにセットされていますが、指定していない値（Medium）も同時に選択されたのでドーナツ・チャートは非表示になりました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/4e4bcd05-51bc-906f-ab08-3bc6f3a6e955.png)

## 可視性の条件
可視性の条件は次のようになっています。

||指定した値|指定していない値|
|:-|:-|:-|
|**すべて**|いずれかが含まれる|含まれていてもよい|
|**サブセット**|いずれかが含まれる|含まれてはいけない|
|**完全一致**|すべて含まれる|含まれてはいけない|
|**スーパーセット**|すべて含まれる|含まれていてもよい|

上記のドーナツ・チャートでは「サブセット」を選択したので、選択した値（上記例では「High」または「Low」）のいずれかが含まれていれば、そのビジュアライゼーションは表示されます。
ただし、選択した値以外の値が含まれていてはいけなかったのです。