Oracle Analytics Cloud：ワークブックでパラメータを使用してみる

# はじめに
Oracle Analytics Cloud（**OAC**）では、ワークブックにパラメータを作成し、再利用可能な値を保存および管理することができます。パラメータは、フィルタコントロール、可視化のプロパティ、SQL論理式、式フィルタ、計算、データアクションとワークブックナビゲーションで使用できます。
この記事ではパラメータの使い方を紹介しますが、その際に「Sample Order Lines」データセットを使用します。
Sample Order Linesデータセットを持っていない人は、こちらの記事を参考にしてサンプルをインポートしてください。
- [Oracle Analytics Cloud：セルフサービス分析のチュートリアル](https://qiita.com/tyo38/items/b17af98dd1dc55936175)

# 1. パラメータの作成
まずワークブックを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/384f6371-1d0a-f62a-34fd-064beaf98cae.png)
「Sample Order Lines」データセットを選択して、「ワークブックに追加」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/e96c33a0-bcba-7e40-5ca6-3558cc109215.png)
「パラメータ」ペインに移動し「＋」をクリックしてパラメータを追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/4ed9b80d-fde5-a10b-c37c-9fe90d649dae.png)
次の様に入力し、「OK」をクリックします。
| パラメータ | 値 |
|:-|:-|
|名前|Cost Increase %|
|データ型|整数|
|複数値の許可|オフ|
|使用可能な値|範囲|
|最小値|0|
|最大値|100|
|初期値|値|
||0|

# 2. 計算の作成
データペインに戻り、「＋」をクリックして「計算の追加」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/245d3d6b-9ccb-fc20-60a8-e3e39aa780b0.png)
次の様に計算式を定義して「保存」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/4ea24c5d-fdbc-1b3a-7fcb-d27c8b3ee37c.png)
|パラメータ|値|
|:-|:-|
|名前|Projected Cost Increase|
|式|Shipping Cost + (Shipping Cost * \@parameter("Cost Increase %")('0') / 100) |

# 3. ビジュアライゼーションに計算を追加する
Ctrlキーを押しながら「Shipping Cost」「Ship Mode」そして今作成した「Projected Cost Increase」を同時に選択し、右クリックします。
「ビジュアライゼーションの選択」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/c836911f-a4e6-2927-5e80-27fea4ec4551.png)
左上の「棒」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/85677beb-bb54-8e55-999b-bdd19871d2dc.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/5dc0b58e-fac9-326f-df41-e2048fa5c7ab.png)

# 4. パラメータをフィルタとして使用する
パラメータペインを表示し、「Cost Increase %」パラメータをビジュアライゼーションの「フィルタ」にドラッグ＆ドロップします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/34d44e55-aece-fc6b-fbb0-e89a47eb9f9f.png)
パラメータの値は「0」にしておきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/ce7ea623-8301-61a7-dbbc-ed7d5dac3f5b.png)
ビジュアライゼーションのタイトルのすぐ下に表示されるフィルタをクリックして、パラメータの値を自由に変更できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/1c9cba54-21d3-6f7f-6189-30acaf55ff06.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/984ba55b-f94a-358f-71da-a97710e3c209.png)

# 5. パラメータをタイトルに使用する
ビジュアライゼーションのプロパティを表示します。
タイトルの「自動」をクリックして、「カスタム」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/e791e144-a1f7-3d3d-0d04-37427d39d28d.png)
カスタムのタイトルとして、次の様に入力します。
```
Project Shipping Cost based on @parameter("Cost Increase %")% cost increase
```
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/6f55f89f-be9b-62ea-7441-ea88cc471875.png)

# おわりに
ここで紹介したパラメータの利用方法は、ドキュメントにも記載されていますので、そちらもあわせて参考にしてください。
- Oracle Analytics Cloudでのデータのビジュアル化およびレポートの作成
[パラメータの使用例](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acubi/parameter-use-cases.html)