Oracle Analytics Cloud：パラメータを使用したインタラクティブなビジュアライゼーション

# はじめに
Oracle Analytics Cloud（**OAC**）のワークブックでパラメータが利用可能になりました。
パラメータは一種の変数として扱うことができ、これを使用して、より対話的なビジュアライゼーションを作成できます。
パラメータは、ビジュアライゼーションの他、フィルタや計算でも使用できます。
これ以降のステップで使用するデータセットは、こちらの記事を参考に入手してください。
- [Oracle Analytics Cloud：ワークブックでパラメータを使用してみる](https://qiita.com/tyo38/items/421f3265b19d8d3a576f)
- [Oracle Analytics Cloud：セルフサービス分析のチュートリアル](https://qiita.com/tyo38/items/b17af98dd1dc55936175)

# 1. 新規ワークブックの作成
OACにログインし、「作成」から「ワークブック」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/628f6e4b-c314-f45b-1caa-42f9ea4dd0c8.png)
「Sample Order Lines」データセットを選択し「ワークブックに追加」します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/a81abad7-1f05-0e26-a8f8-ed35e9c20ab5.png)
Sample Order Linesデータセットがない場合は、こちらの記事の冒頭の手順で入手できます。
- [Oracle Analytics Cloud：セルフサービス分析のチュートリアル](https://qiita.com/tyo38/items/b17af98dd1dc55936175)

# 2. 新規ビジュアライゼーションの作成
「Product Container」「Customer Segment」「Sales」の3つの項目を使用して、積上げ棒ビジュアライゼーションを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/7f44c422-85a3-95d4-26db-2b18472cb0f1.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/98c7bb8d-8d50-e6e0-223a-c6899cc99d64.png)

# 3. パラメータの作成
パラメータを3つ作成します。

## 3.1 分析軸のためのパラメータ
「パラメータ」ペインで「＋」をクリックして、新規パラメータを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/f19cc99d-1e57-ee76-8140-0d9e04a507d5.png)
|パラメータ|値|
|:-|:-|
|名前|分析軸|
|データ型|テキスト|
|複数値の許可|オフ|
|別名|オン|
|使用可能な値|値|
|　Order Priority|受注優先度|
|　Product Category|製品カテゴリ|
|　Product Container|コンテナタイプ|
|初期値|値|
||受注優先度|

## 3.2 X軸のためのパラメータ
同様に「X軸」という名前のパラメータを追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/7de5af6e-f896-97c2-457a-0440ba28d310.png)
|パラメータ|値|
|:-|:-|
|名前|X軸|
|データ型|テキスト|
|複数値の許可|オフ|
|別名|オン|
|使用可能な値|値|
|　Customer Segment|顧客セグメント|
|　Ship Mode|配送方法|
|　Ship Date (年)|年|
|初期値|値|
||配送方法|

## 3.3 Y軸のためのパラメータ
最後に「Y軸」という名前のパラメータを追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/bf33bf62-dc10-63b7-b4a7-a9d53422a092.png)
|パラメータ|値|
|:-|:-|
|名前|X軸|
|データ型|テキスト|
|複数値の許可|オフ|
|別名|オン|
|使用可能な値|値|
|　Profit|利益|
|　Sales|売上金額|
|　Discount|値引き|
|　Quantity Ordered|受注数量|
|初期値|値|
||売上金額|

# 4. 計算の追加
「データ」に戻り、「＋」をクリックして計算を追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/1bf8804b-0c04-a0c2-360f-501e4c41eba5.png)

## 4.1 分析軸の計算を追加
名前を「分析軸」とし、次の式を入力し「保存」をクリックします。
```
case @parameter(分析軸)('Order Priority') when 'Order Priority' then Order Priority when 'Product Container' then Product Container when 'Product Category' then Product Category end
```
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/8b96ed0c-1730-3322-748d-d09e64bd0ab0.png)

## 4.2 X軸の計算を追加
再度「＋」をクリックして計算を追加します。
名前を「X軸」とし、次の式を入力し「保存」をクリックします。
```
case @parameter(X軸)('Customer Segment') when 'Customer Segment' then Customer Segment when 'Ship Mode' then Ship Mode when 'Ship Date (年)' then cast(Year(Ship Date) as char(4)) end
```
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/d481420e-e6cc-a0b5-694f-a0f69f75e547.png)

## 4.3 Y軸の計算を追加
「＋」をクリックして計算を追加します。
名前を「Y軸」とし、次の式を入力し「保存」をクリックします。
```
case @parameter(Y軸)('Sales') when 'Sales' then Sales when 'Profit' then Profit when 'Discount' then Discount when 'Quantity Ordered' then Quantity Ordered end
```
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/81693b20-54ac-fe87-4430-512b1c138251.png)

# 5. パラメータをビジュアライゼーションで使う
作成した計算を積上げ棒ビジュアライゼーションで使用します。
「マイ計算」を展開し、「分析軸」を色に、「X軸」をカテゴリ(X軸)に、「Y軸」を値(Y軸)にドラッグ＆ドロップします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/95a3be09-ba07-ae30-e9d3-1ab4f19202cf.png)
ビジュアライゼーション ペインから「ダッシュボード・フィルタ」をキャンバスにドラッグ＆ドロップします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/c38d8f0a-3bc7-9d2d-4957-13f7c43dcb98.png)
パラメータ ペインに移動し、ダッシュボード・フィルタの「フィルタ・コントロール」に作成した3つのパラメータをドラッグ＆ドロップします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/8781cff5-77fe-193e-3a21-442dc41c2e4c.png)

# 6. 完成したビジュアライゼーション
ダッシュボードフィルタで選んだ値に従って、ビジュアライゼーションが動的に変化します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/3fd69f40-b326-9de7-64ad-3cfbd0522218.png)