Oracle Analytics Cloud Classic：アクションリンクで別のダッシュボードページに遷移させる。異なるサブジェクト領域間へのパラメータ渡し編

はじめに
---
Oracle Analytics Cloud Classic：Dashboard、Answersでは、アクションリンク機能を利用して、あるダッシュボードページから別のダッシュボードページへ画面遷移できます。
画面遷移の際に、遷移先が異なるサブジェクト領域で作成されたダッシュボードページのときに遷移元の値を引き継いで渡す方法についてやってみます。
例えば、遷移元のダッシュボードページにサブジェクト領域"月次実績"から作成された分析があり、その実績値たとえば2017年10月の実績をクリックして、サブジェクト領域"売上明細"からなる遷移先のダッシュボードページに"2017"、"10"の値を渡します。

【遷移元】サブジェクト領域"月次実績"からなる分析から、2017年10月の実績値をクリックして、アクションリンクで遷移する
![g1.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/8b2d0b8e-4689-bfb4-ec12-f1ded1dd7c2e.jpeg)

【遷移先】"2017"、"10"の値が遷移先のダッシュボードページに引き継がれる。遷移先のダッシュボードページには別のサブジェクト領域"売上明細"からなる分析が配置されている
![g2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/72349068-ae45-bb2a-89bd-e1cf90e48ebb.jpeg)

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

前提
---
* 異なる２つのサブジェクト領域"月次実績"、"売上明細"が作成されている
* 遷移元のダッシュボードページにはサブジェクト領域"月次実績"から作成されたレポートが配置されている
【遷移元の画面イメージ】
![g3.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/93cb3a0f-70e9-bdd9-8b67-aee6f7e10087.jpeg)
【遷移元の分析定義　"月次実績"を利用】
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/5010e3a4-e3a6-e59b-02ac-6eaf1ec66fea.png)


* 遷移先のダッシュボードページにはサブジェクト領域"売上明細"から作成されたレポートと、サブジェクト領域"売上明細"から作成されたダッシュボードプロンプトが配置されている
【遷移先の画面イメージ】
![g6.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/531fb7c6-6560-39cc-6999-08da01da8f57.jpeg)
【遷移先の分析定義　"売上明細"を利用】
![g5.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/16303211-1504-15ad-411e-c5a264fdffbb.jpeg)
【遷移先のダッシュボードプロンプト定義　"売上明細"を利用】
![g7.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/065abfc3-4bc9-4dfc-7a5e-24dfc37efe26.jpeg)

流れ
---
1.遷移先でプロンプトリンク機能を使ってURLを記録する
2.遷移元の分析で"Webページへのナビゲート"を使ってアクションリンクを作成する
3."Webページへのナビゲート"のパラメータ設定で、列値を使って、遷移先のダッシュボードプロンプトに渡す値をセットする

遷移先のURLを記録
---
遷移先でプロンプトリンク機能を使ってURLを記録する
プロンプトリンクを実行する前に、遷移先のダッシュボードページ"詳細"を開き、ダッシュボードプロンプトに値をセットして実行します
![g8.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/4e061513-04ae-6fe1-25f5-d4a5207e6240.jpeg)

右上の歯車アイコン(ダッシュボードメニュー)をクリックし、メニューから"プロンプト・リンクの作成"をクリックします
![g9.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/9b09e858-8283-2ec0-42a9-9b4ca0546a39.jpeg)

「・・・ブラウザのアドレス・バーに表示されます」とメッセージが出ますので、
![g10.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/2d2120cb-e841-803b-f368-3e9a48b5198d.jpeg)

ブラウザのアドレス・バーに表示されているURLを記録します。URLをコピーしてメモ帳等に貼り付けておきます。
![g11.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/4fd645fc-b1db-50d1-ca81-b10e12ff782f.jpeg)

URLは以下のようなGoURL機能にのっとった形です。GoURL機能はOACのダッシュボードページや分析をURLリクエストして直接実行する機能です。
<div>https://oacインスタンス名/ui/analytics/saw.dll?Dashboard&PortalPath=%2Fshared%2Fsales1%2F_portal%2F%E8%B2%A9%E5%A3%B2%E7%AE%A1%E7%90%86&Page=%E8%A9%B3%E7%B4%B0&Action=Navigate&col1=%22TIMES%22.%22CALENDAR_MONTH_NUMBER%22&val1=%225%22&psa1=%22%E5%A3%B2%E4%B8%8A%E6%98%8E%E7%B4%B0%22&col2=%22TIMES%22.%22CALENDAR_YEAR%22&val2=%222018%22&psa2=%22%E5%A3%B2%E4%B8%8A%E6%98%8E%E7%B4%B0%22</div>

goURL機能の詳細は[こちら](https://docs.oracle.com/cd/E92951_01/biee/BIEIT/apiwebintegrate.htm#CACCHBHC)

遷移元の分析でアクションリンクを作成する
---
遷移元の分析で"Webページへのナビゲート"を使ってアクションリンクを作成します
遷移元の分析の編集画面を開きます。"基準"タブで、アクションリンクを設定する列の歯車アイコンをクリックし、メニューから"列のプロパティ"をクリックします
![g12.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/e6e8e51a-2ec7-8151-cb0f-0db07a2de4ac.jpeg)

列のプロパティで、"相互作用"タブをクリックします。値のプライマリ相互作用で"アクション・リンク"をクリックします
![g13.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/5e7c92bc-831a-c5b8-b71b-e2521e7c49e1.jpeg)

＋アイコン（アクション・リンクの追加）をクリックします
![g14.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/4decd724-1897-bb4d-28bb-b2e708ee7718.jpeg)

＋付の人アイコン（新規アクションの追加）をクリックし、メニューから"Webページにナビゲート"をクリックします
![g15.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/b88f5fc4-4eb4-92d7-132f-2ddd9efd7298.jpeg)

URLに、プロンプトリンクで記録したURLを貼り付けます。"パラメータの定義"をクリックします
![g16.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/54da1eb9-6147-7409-2a7f-6712ab5bb396.jpeg)

渡すパラメータを設定する
---
"Webページへのナビゲート"のパラメータ設定で、列値を使って、遷移先のダッシュボードプロンプトに渡す値をセットします

スクロールダウンすると、ダッシュボードプロンプトに渡すパラメータで列プロンプトの名前が"col1"、渡す値が"vol1"で表示されています。渡す値で遷移元の値を設定します。値の左▼アイコンをクリックし、"列値"に変更します
![g17.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/63137dad-eaf5-0680-c0d2-d683d7575dd2.jpeg)

列値の右▼アイコンをクリック
![g18.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/cb5864db-83f5-047c-7e7e-3b231ccd4208.jpeg)

col1に対応する値になります。遷移元の列を選択します
![g19.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/7c754709-86d8-20aa-549c-086a409686fb.jpeg)

同様に、渡すパラメータをセットします。列値をセットして、
![g20.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/a83d8dca-96cb-112e-5226-ebb23865f7f1.jpeg)

col2に対応する値で、遷移元の列を選択します
![g21.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/10b174a1-5019-3a73-fa28-6a69288ff846.jpeg)

各パラメータの"非表示"のチェックボックスをチェックします。"固定"も自動でチェックされます。OKをクリックします。非表示をチェックしない場合は遷移時に渡すパラメータ値が表示されます。
![g22.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/dce86195-d207-83f9-1754-4bfa286d076b.jpeg)

リンク・テキストを入力します。OKをクリックします
![g23.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/bec81832-88a4-acb4-8b66-a22f11bb3421.jpeg)

OKをクリックし、分析を保存します。
![g24.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/193cc298-b66c-601d-e82a-8ba0f271c4ac.jpeg)

動作確認
---
遷移元のアクションリンクを設定した分析が配置されたダッシュボードページを開きます。月次実績の任意の値をクリックします。表示されたアクションリンク"詳細へ"をクリックします
![g25.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/80a22093-2f24-db9e-3d59-c2acd82ea478.jpeg)

遷移元で指定した値が遷移先のダッシュボードページに渡されて、販売実績の詳細が表示されます。2017年10月の明細が表示されます。
![g26.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516153/6d74d43e-8f5a-3ecf-1b6b-557e510330a6.jpeg)


まとめ
---
画面遷移の際に、遷移先が異なるサブジェクト領域で作成されたダッシュボードページのときに遷移元の値を引き継いで渡す方法です。プロンプト・リンク機能で出力されるURLは、遷移元が例えばOAC以外からでも実行できるため、例えば、OACのダッシュボードページを他のWebシステムから呼び出す際に利用できるため、幅が広がります。

以上