データ・アクションを使用したキャンバス、外部URLへの接続とPublisherレポートでの使用

「データ・アクション」リンクでは、コンテキスト値を外部URLへのパラメータとして、他のプロジェクトへのフィルタとして、または外部コンテナに埋め込まれたビジュアライゼーションとして渡すことができます。

リンクがプロジェクトにナビゲートすると、データ・コンテキストがキャンバス・スコープ・フィルタの形でフィルタ・バーに表示されます。リンクのデータ・コンテキストには、選択項目に関連付けられた属性またはリンクが開始されたセルが含まれる場合があります。

トピック:

ビジュアライゼーション・キャンバスの接続のためのデータ・アクションの作成

現在のプロジェクト内のキャンバスまたは他のプロジェクト内のキャンバスへとナビゲートするデータ・アクションを作成できます。

データ・アクションを使用してコンテキスト関連の情報(たとえば注文番号)を転送することもでき、この場合、リンクでは他のビジュアライゼーションまたはプロジェクト内の注文番号に関する詳細が表示されます。

プロジェクトを作成または開き、「ビジュアル化」キャンバスで作業していることを確認します。
プロジェクト・ツールバーで「メニュー」をクリックして、「データ・アクション」をクリックします。
「アクションの追加」をクリックして新しいナビゲーション・リンクの名前を入力します。
- ナビゲーション・リンクの名前には、文字と数字のみを使用できます。
- 複数のナビゲーション・リンクを追加できます。
「タイプ」フィールドをクリックし、「分析リンク」を選択します。
「アンカー先」フィールドで、このデータ・アクションに関連付ける列を現在のビジュアライゼーションから選択します。メジャー列または非表示の列を選択しないでください。「アンカー先」フィールドに値を指定しない場合、データ・アクションは、ビジュアライゼーション内のすべてのデータ要素に適用されます。
「プロジェクト」フィールドをクリックし、アンカーに使用するプロジェクトを選択します。
- このプロジェクトを使用 - アクティブなプロジェクトのキャンバスにリンクする場合に選択します。
  選択する列は、現在のビジュアライゼーション内にある必要があります。
- カタログから選択: 使用するプロジェクトを参照して選択するために選択します。
「キャンバス・リンク」フィールドをクリックし、使用するキャンバスを選択します。
「値を渡す」フィールドをクリックし、データ・アクションで渡す値を選択します。
たとえば、「アンカー先」フィールドで注文番号列を指定してから、「値を渡す」フィールドで「アンカー・データ」を選択して指定の列値を渡します。
- すべて - クリックしたセルの交差を動的に判断し、それらの値をターゲットに渡します。
- アンカー・データ - 「アンカー先」フィールドで指定された必須列がビュー・コンテキストで使用可能な場合に、実行時に「データ・アクション」が表示されるようにします。
- なし - ページ(URLまたはキャンバス)を開きますが、いずれのデータも渡しません。
- カスタム - カスタム・セットの列を渡すように指定できます。
「複数の選択をサポート」をクリックして、値を設定します。
- オン - データ・アクションは、1つまたは複数のデータ・ポイントが選択されている場合に呼び出すことができます。
- オフ - データ・アクションは、単一のデータ・ポイントが選択されている場合にのみ呼び出すことができます。
  この設定は、複数のデータ・ポイントを選択するとエラーが発生する可能性がある場合(たとえば、一部のサード・パーティのREST APIを使用する場合)に、特に役立ちます。
「OK」をクリックして保存します。

ビジュアライゼーション・キャンバスから外部URLに接続するためのデータ・アクションの作成

データ・アクションを使用してキャンバスから外部URLにナビゲートできるため、サプライヤIDなどの列を選択すると特定の外部Webサイトが表示されます。

プロジェクトを作成または開き、「ビジュアル化」キャンバスで作業していることを確認します。
「メニュー」をクリックして、「データ・アクション」を選択します。
「アクションの追加」をクリックして新しいナビゲーション・リンクの名前を入力します。

複数のナビゲーション・リンクを追加できます。
「タイプ」フィールドをクリックし、「URLのナビゲーション」を選択します。
「アンカー先」フィールドをクリックし、URLを適用する列を選択します。「アンカー先」フィールドに値を指定しない場合、データ・アクションは、ビジュアライゼーション内のすべてのデータ要素に適用されます。
URLアドレスを入力し、オプションで表記法およびパラメータを含めます。

たとえば、http://www.example.com?q=${keyValuesForColumn:"COLUMN"}は、www.oracle.com?q=${keyValuesForColumn:"Sales"."Products"."Brand"}のように表示されます。ここで選択した列名は、データ・アクションを起動した場合の値に置き換わります。
「複数の選択をサポート」をクリックして、値を設定します。
- オン - データ・アクションは、1つまたは複数のデータ・ポイントが選択されている場合に呼び出すことができます。
- オフ - データ・アクションは、単一のデータ・ポイントが選択されている場合にのみ呼び出すことができます。
  この設定は、複数のデータ・ポイントを選択するとエラーが発生する可能性がある場合(たとえば、一部のサード・パーティのREST APIを使用する場合)に、特に役立ちます。
「OK」をクリックして保存します。
「キャンバス」で、セルをクリックするか、[Ctrl]を押しながら複数のセルをクリックして選択します。
すでに作成したナビゲーション名を右クリックおよびメニューから選択します。
セルを選択すると、パラメータに渡す値が決定されます(URLトークン)。

ビジュアライゼーション・キャンバスからREST APIに接続するためのデータ・アクションの作成

列を選択したときに値をREST APIに送信して外部Webサイトからレスポンスを返すように、キャンバスでHTTP APIデータ・アクションを使用できます。

HTTP APIデータ・アクションを作成する前に、接続しようとしているドメインを安全なドメインとして構成する必要があります。安全なドメインの登録を参照してください。

プロジェクトを作成するか開き、「ビジュアル化」領域で作業していることを確認します。
「メニュー」をクリックして、「データ・アクション」タブを選択します。
「アクションの追加」をクリックして新しいHTTP APIデータ・アクションの名前を入力します。たとえば、HTTP API Exampleと入力します。

複数のHTTP APIデータ・アクションを追加できます。
「タイプ」フィールドをクリックし、「HTTP API」を選択します。
「アンカー先」フィールドをクリックし、HTTP APIデータ・アクションを適用する列を選択します。メジャー列または非表示の列を選択しないでください。「アンカー先」フィールドに値を指定しない場合、データ・アクションは、ビジュアライゼーション内のすべてのデータ要素に適用されます。
「HTTPメソッド」フィールドをクリックし、適切な値(GET、POST、PUT、DELETE)を選択してREST APIに送信します。
httpまたはhttpsで開始し、オブションで置換トークンを含むREST APIのURLを入力します。

URLの置換トークンはコンテキスト値をデータ・アクション(データ値、ユーザー名、プロジェクト・パス、キャンバス名など)に渡します。

たとえば、http://www.googleapis.com/books/v1/volumes?q=${valuesForColumn:"Category"}を使用し、列値(「カテゴリ」列など)をREST API (Google books APIなど)に渡すことができます。「カテゴリ」列内のセルから選択した値がREST APIに渡されます。
POSTメソッドを選択した場合、各パラメータを別々の行に入力するフィールドが表示されます。
"="で区切られた名前と値を持つ名前/値ペアとして各パラメータを入力します。呼び出しているAPIに応じて、同じURLトークン構文を名前/値ペアで使用できます。

次に例を示します。
- paramName1=paramValue1
- paramName2=${valuesForColumn:"Product"}
「複数の選択をサポート」をクリックして、値を設定します。
- オン - データ・アクションは、1つまたは複数のデータ・ポイントが選択されている場合に呼び出すことができます。
- オフ - データ・アクションは、単一のデータ・ポイントが選択されている場合にのみ呼び出すことができます。
  この設定は、複数のデータ・ポイントを選択するとエラーが発生する可能性がある場合(たとえば、一部のサード・パーティのREST APIを使用する場合)に、特に役立ちます。
「OK」をクリックして保存します。
ビジュアライゼーションのデータ・ポイントをクリックします。

たとえば、「カテゴリ」列から「ブック」を選択します。
右クリックしてHTTP APIの例を選択し、結果を表示します。

選択したデータ・ポイントで、URLトークンに渡す値が決定されます。

成功または失敗メッセージが表示され、選択した値を使用してREST APIが正常に起動されたことを確認します。

Oracle Business Intelligence Publisherレポートに接続するためのデータ・アクションの使用

データ・アクション・リンクは、コンテキスト値をOracle Business Intelligence PublisherレポートのURLパラメータとして渡すことができます。

リンクをクリックしてBI Publisherレポートを開いた場合、リンクには、ビジュアライゼーションで選択した列に関連付けられている属性が含まれる場合があります。

トピック:

Oracle Business Intelligence Publisherレポートに接続するためのデータ・アクションの作成について

Oracle Business Intelligence Publisherレポートにリンクするデータ・アクションを作成できます。

ビジュアライゼーションから選択した列値を渡してBI Publisherレポートに表示するようにデータ・アクションを構成します。

BI Publisherレポートはローカル・フォルダに格納する必要があります。
BI Publisherレポートがデータ・モデルとして分析を使用する場合、基になる分析のプロンプトでは、選択した値をBI Publisherレポートのプロンプトに渡せるように、「ユーザー入力」値が「選択リスト」に設定されている必要があります。
値リストとリスト・フィルタを渡して、BI Publisherレポートにプロンプトとして表示できます。ただし、数値フィルタ、日付フィルタまたは式フィルタは渡せません。

Oracle Business Intelligence Publisherレポートに接続するためのデータ・アクションの作成

分析データ・アクション・リンクを作成して、選択したデータ・ポイントをOracle AnalyticsプロジェクトからOracle Business Intelligence Publisherレポートに転送できます。

Oracle Analyticsプロジェクト、BI Publisherレポートおよび分析は異なるフォルダに入れることができます。

BI Publisherレポートで使用されているデータ・モデルを使用するOracle Analyticsプロジェクトを開きます。
プロジェクト・ツールバーで「メニュー」をクリックして、「データ・アクション」をクリックします。
「アクションの追加」をクリックして新しいナビゲーション・リンクの名前を入力します。
「タイプ」フィールドをクリックし、「分析リンク」を選択します。
「名前」フィールドに、データ・アクションの名前を入力します。
「ターゲット」フィールドをクリックし、「カタログから選択」を選択し、データ・アクションでデータを渡すBI Publisher レポートを参照して選択し、「OK」をクリックします。
「パラメータ・マッピング」が「デフォルト」に設定されていることを確認します。
「値を渡す」フィールドが「すべて」に設定されていることを確認します。
「複数の選択をサポート」をクリックして、値を設定します。
- オン - データ・アクションは、1つまたは複数のデータ・ポイントが選択されている場合に呼び出すことができます。
- オフ - データ・アクションは、単一のデータ・ポイントが選択されている場合にのみ呼び出すことができます。
  この設定は、複数のデータ・ポイントを選択するとエラーが発生する可能性がある場合(たとえば、一部のサード・パーティのREST APIを使用する場合)に、特に役立ちます。
「OK」をクリックします。
ビジュアライゼーションのデータ・ポイントを選択し、値がBI Publisherレポートに渡されることをテストするデータ・アクションを選択します。

データ・アクションにカスタム列名を作成してOracle Business Intelligence PublisherレポートURLに渡す方法

Oracle Business Intelligence PublisherレポートのURLにカスタム列名を渡すデータ・アクション・リンクを作成できます。

Oracle Analyticsプロジェクトを開きます。
プロジェクト・ツールバーで「メニュー」をクリックして、「データ・アクション」をクリックします。
「アクションの追加」をクリックして新しいナビゲーション・リンクの名前を入力します。
「タイプ」フィールドをクリックし、「分析リンク」を選択します。
「名前」フィールドに、データ・アクションの名前を入力します。
「ターゲット」フィールドをクリックし、「カタログから選択」を選択し、データ・アクションでデータを渡すBI Publisher レポートを参照して選択し、「OK」をクリックします。
「パラメータ・マッピング」をクリックし、「カスタム・マッピングの設定」を選択して、BI PublisherレポートにURLパラメータとして渡すカスタム列名を指定します。
「行の追加」をクリックし、カスタム名を使用してBI Publisherレポートに渡す列ごとに、「列の選択」をクリックします。
「パラメータの入力」をクリックし、置換する各列名のカスタム名を入力します。

カスタム名はURLでBI Publisherレポートに渡されます。
「値を渡す」フィールドが「すべて」に設定されていることを確認します。
「複数の選択をサポート」をクリックして、値を設定します。
- オン - データ・アクションは、1つまたは複数のデータ・ポイントが選択されている場合に呼び出すことができます。
- オフ - データ・アクションは、単一のデータ・ポイントが選択されている場合にのみ呼び出すことができます。
  この設定は、複数のデータ・ポイントを選択するとエラーが発生する可能性がある場合(たとえば、一部のサード・パーティのREST APIを使用する場合)に、特に役立ちます。
「OK」をクリックします。
ビジュアライゼーションのデータ・ポイントを選択し、カスタム列名がBI PublisherレポートのURLに表示されることを検証するデータ・アクションを選択します。

ビジュアライゼーション・キャンバスからのデータ・アクションの起動

キャンバスから他のキャンバスおよびURLにデータ・アクションを起動できます。

プロジェクトを作成するか、既存プロジェクトを開きます。「ビジュアル化」キャンバスで作業していることを確認します。
別のキャンバスまたはURLに繋がる「データ・アクション」リンクが含まれているキャンバスで、次のステップを実行します。
1. データ要素を右クリックするか、複数の要素を選択します([Ctrl]を押しながらクリック)。
2. コンテキスト・メニューから「データ・アクション」を選択します。
3. 「プロジェクト・プロパティ」ダイアログにすべて入力します。
現在のビュー・コンテキストに適用できる「データ・アクション」の名前がコンテキスト・メニューに表示されます。

データ・アクションをコンテキスト・メニューに表示するためには、「アンカー先」フィールドに定義されているすべての値がビュー・コンテキストで使用可能である必要があります。
値として渡されるデータ要素とターゲット・キャンバス上のデータ要素との照合について、次のルールが適用されます。
- データ要素がターゲット・プロジェクトのキャンバス内と一致し、そのデータ要素に対する既存のキャンバス・フィルタがターゲット・キャンバスにない場合は、新しいキャンバス・フィルタが追加されます。既存のキャンバス・フィルタがある場合は、ソース・プロジェクトのキャンバスの値で置換されます。
- 予期されていたデータセットは使用できないが別のデータセットを使用できる場合は、別のデータセット内の列名とデータ型を使用して照合され、それにフィルタが追加されます。
- 名前とデータ型による列の一致が複数ある場合は、ターゲット・プロジェクトまたはキャンバスのそれらすべての列にフィルタが追加されます。
「データ・アクション」は、ターゲット・セルまたはマップされたURLにナビゲートし、「データ・アクション」ダイアログに指定された値に基づいて、表示されたデータをフィルタします。
「値を渡す」フィールドに設定されている「値を渡す」コンテキストは、データ・アクションの呼出し元のビジュアライゼーションで使用されるデータ要素で構成されています。「値を渡す」コンテキストには、プロジェクト、キャンバスまたはビジュアライゼーション・レベルのフィルタ内のデータ要素は含まれません。