Oracle Analytics Cloud：セマンティックモデルで変数を設定してみる　～静的変数編～

はじめに
---
OACでは、セマンティックモデラーを利用してセマンティックモデルを作成します
作成したセマンティックモデルをOACにデプロイすると、ワークブック、分析からセマンティックモデルのサブジェクト領域を利用できるようになります。また、セマンティック・モデルでは、セマンティック・モデル・変数という式で利用できる静的変数、動的変数など、いくつかの種類の変数を設定することができます。
本記事では、セマンティック・モデルで、静的変数を設定してみます。静的変数は、セマンティック・モデル内での利用の他、分析、ダッシュボードなどから利用することができます。
![0.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/ed7a4e77-e7e0-02cc-a4ea-a802d60f20ec.jpeg)

記載時のOACバージョン：OAC 2024 March版

前提
---
セマンティック・モデルが作成済のOACインスタンスがある。


初期化ブロックおよび静的変数の作成
---
セマンティック・モデルを開きます
上部左のメニューアイコンをクリックし、セマンティック・モデルをクリック、作成済のセマンティック・モデルをクリックして開きます
![1.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/2509dc68-84d1-e560-cf2c-618f646fca74.jpeg)

セマンティック・モデル変数を作成します
左上部の"変数"タブをクリックします。
![2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/06bb025c-70d6-e451-fd6e-3b210a9c3ed4.jpeg)

上部右の"作成"ボタンをクリックし、"初期化ブロック"をクリックします。
![4.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/623056b6-a0c2-d06b-6694-4e77233e70f6.jpeg)

初期化ブロックの作成で、任意の名前を入力します。タイプの右▼をクリックし、タイプは"静的"をクリックします。
![5.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/2c9a5092-b8ff-3daa-35bf-3d23dde2d199.jpeg)

"OK"をクリックします。
![6.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/88228f38-4239-17aa-58b3-aebfdd224434.jpeg)

作成した初期化ブロックが右部に表示され、"変数"タブで＋アイコン"変数の追加"をクリックします
![7.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/c0a9072c-30ba-bd4f-b503-db88290b5bd1.jpeg)

変数の"名前"を入力します。本記事では"company_name"と入力します
"詳細ビュー"をクリックします
![8.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/08180c6e-31aa-24fb-385c-7a33ec170648.jpeg)

詳細が開いたら、値の右部"fx"ボタンをクリックします
![9.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/d29a7bb5-295a-d9b9-2a28-216a22b18121.jpeg)

式エディタで静的変数"company_name"にセットする値を入力します'OAC Corp'と入力します。テキストは' 'で括ります。入力後、検証をクリックし、エラーがないことを確認し、保存をクリックします。
![9-2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/ebf5ed14-0b82-4666-991e-df4a9c1ebf5c.jpeg)

セマンティック・モデルを保存し、
![10.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/d4f787f7-45b6-d382-f969-b92bac128496.jpeg)

整合性チェックを実行します。整合性チェックアイコンをクリックします
![11.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/1a9c4b56-ecbe-6c54-a536-1b2e52197681.jpeg)

上部右部のアクションメニュー"・・・（縦）"をクリックし、"デプロイ"をクリックします。
![12.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/a44a2a95-31c2-c4c0-b641-bc3ab659126e.jpeg)

"デプロイ"をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/a0e7862f-9711-f0b8-eb7d-8b85729caea5.png)

セマンティック・モデル変数の静的変数が設定されました。

セマンティック・モデル変数の静的変数の利用
---
分析で、テキストやナレーティブで静的変数を利用する
@{biServer.variables.<変数名>}で参照します。本記事では@{biServer.variables.company_name}
![13.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/fdb3fab5-36d9-583c-dea3-c7991bffff14.jpeg)

分析で、式列で静的変数を利用する
VALUEOF("<変数名>")で参照します
![14.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/b3d758d0-052c-1da9-ab07-6de7a3d47bcb.jpeg)

静的変数がセットされた分析の実行
静的テキストと、表ビューの式列で静的変数を参照しています
![15.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/f8d6a218-73cc-291a-eb5b-a357c6cee3bd.jpeg)



まとめ
---
セマンティック・モデルでは、セマンティック・モデル・変数という式で利用できる静的変数、動的変数など、いくつかの種類の変数を設定することができます。
本記事では、セマンティック・モデルで、静的変数を設定してみました。分析で設定した静的変数を参照する他、セマンティック・モデルの論理レイヤーの式列でも変数を参照できます。

以上