外部コンテナに埋め込まれたビジュアライゼーションのデータ・アクションの作成

ビジュアライゼーションを外部コンテナ(HTMLページ、コンシューマのアプリケーション・ページなど)に埋め込み、データ・アクションをビジュアライゼーションに含めることができます。埋込みデータ・アクションを使用して、外部コンテナに埋め込まれたビジュアライゼーションと相互作用できます。外部コンテナでは、ビジュアライゼーションで選択されたデータ要素値のセットを取得することもできます。埋込みデータ・アクションは、必要な数だけ追加できます。

「イベントの公開」はこのようなデータ・アクション・タイプの1つで、ビジュアライゼーションに定義できます。「イベントの公開」データ・アクションがビジュアライゼーションで起動すると、外部アプリケーションがビジュアライゼーションのコンテキストを受け取ることができます。この場合、「コンテキスト」という語は、ビジュアライゼーションの選択された場所におけるデータ要素値のセットを意味します。

ホーム・ページでワークブックを選択し、「アクション・メニュー」をクリックして「開く」を選択します。
ワークブック・メニューで、「データ・アクション」を選択します。
「アクションの追加」をクリックし、「名前」フィールドに新規データ・アクションの名前を入力します。

たとえば、「DV Embedded Content DA1」と入力します。データ・アクションの名前には、文字と数字を使用できます。
「タイプ」をクリックし、「イベントの公開」を選択します。
「アンカー先」フィールドで「データの追加」または「データの選択」をクリックし、データ・アクションの適用時に値を渡すデータ要素を1つ以上選択します。メジャー列または非表示の列を選択しないでください。
「イベント名」を入力します。イベント名は外部コンテナで指定され、コンテキスト・イベントの公開時に渡されます。ここで、「コンテキスト」という語は、ビジュアライゼーションの選択された場所におけるデータ要素値のセットを意味します。複数のワークブック間、または1つのワークブック内の複数のデータ要素間でデータ・アクションが使用される場合は、トラッキングしやすいように一意のイベント名を指定してください。

たとえば、アクション名としてDV Embedded Content DA1と入力した場合、「イベント名」フィールドにEvent from DA1と入力すると、イベントが由来するデータ・アクションを示すことができます。
「値を渡す」フィールドをクリックして、データ・アクションがコンシューマに渡す値を選択します。
- 「すべて」を使用して、クリックしたセルの交差を動的に判断し(たとえば製品と年)、それらの値をターゲットに渡します。
- 「アンカー・データ」を使用して、実行時にデータ・アクションが表示されるようにします。ただし、「アンカー先」フィールドで指定した必須列がビュー・コンテキストで使用可能な場合にのみ表示されます。
- 「なし」を使用して、ページ(URLまたはキャンバス)を開きますが、いずれのデータも渡しません。たとえば、コンテキストを渡さずにwww.oracle.comにナビゲートできます。
- 「カスタム」を指定して、カスタム・セットの列を渡すように指定できます。
たとえば、「アンカー先」フィールドで注文番号を指定してから、「値を渡す」フィールドで「アンカー・データ」を選択して注文番号値を渡します。
「複数の選択をサポート」をクリックして値を設定します。
- 「オン」 - データ・アクションは、1つまたは複数のデータ・ポイントが選択されたときに呼び出すことができます。
- 「オフ」 - データ・アクションは、1つのデータ・ポイントが選択されたときにのみ呼び出すことができます。
  この設定は、複数のデータ・ポイントを選択するとエラーになる可能性がある場合に特に有用です(たとえば、一部のサードパーティのREST APIの場合)。
「OK」をクリックして保存します。

ワークブックを保存した後に、ワークブックを外部コンテナに埋め込むことができます。外部コンテナに埋込みビジュアライゼーションが表示されます。ビジュアライゼーションを右クリックして適用可能なデータ・アクションが含まれる場合は、データ・アクションがビジュアライゼーションのドロップダウン・メニューに表示されます。埋込みデータ・アクションをクリックすると、ビジュアライゼーションのコンテキスト情報が判別され、その情報がナビゲーション・アクション・サービスに渡されて処理されます。ナビゲーション・サービスでは、コンテキスト・ペイロード情報を使用してイベントを発生させます。このイベントをサブスクライブしてイベント・コールバックでペイロードを受け取り、ペイロードを他の領域で使用できます。
外部コンテナで埋込みコンテンツを含むデータ・アクションを実行するには、次のステップを実行します。
1. ワークブックのパスの位置を追加または変更します。
2. ビジュアライゼーションの公開イベントをサブスクライブします。
3. イベント・リスナーおよびイベント・コールバックを定義します。