データ・アクションのカテゴリ
データ・アクション・カテゴリには、URLにナビゲート、HTTP API、キャンバスにナビゲート、およびイベントの各アクションがあります:
- URLに移動: 指定したURLを新しいブラウザ・タブで開きます。
- HTTP API:
GET/POST/PUT/DELETE/TRACEコマンドを使用してHTTP APIをターゲット指定し、新しいタブは作成しません。 かわりにHTTPステータス・コードが調べられ、一時的な成功または失敗のメッセージが表示されます。 - キャンバスにナビゲート: ユーザーは、同じビジュアライゼーションまたは異なるビジュアライゼーション内のターゲット・キャンバスからターゲット・キャンバスに移動できます。 ソース・キャンバスで有効なフィルタはすべて、外部フィルタとしてターゲット・キャンバスに渡されます。 ターゲット・キャンバスが開くと、ビジュアライゼーションへの外部フィルタの適用が試行されます。 外部フィルタが適用されるメカニズムについては、ここでは説明しません。
- イベント・アクション: Oracle Analyticsイベント・ルーターを使用してイベントを公開します。 JavaScriptコード(サード・パーティの拡張機能など)は、これらのイベントをサブスクライブし、それに応じてカスタム・レスポンスを処理できます。 これは、拡張機能開発者がデータ・アクションの応答方法を選択できるため、最大限の柔軟性を提供します。 たとえば、ユーザー・インタフェースを表示するか、データを複数のサービスに一度に渡すかを選択できます。
「URLに移動」とHTTP APIの両方のデータ・アクション・カテゴリ・タイプでは、トークン構文を使用してビジュアライゼーションからURLおよびPOSTパラメータにデータまたはメタデータを挿入できます。
URLトークン置換
HTTPデータ・アクションは、URLのトークンをデータ・アクションに渡されたコンテキストの値で置換できます。 たとえば、修飾データ参照値、フィルタ値、ユーザー名、ワークブック・パスおよびキャンバス名などです。
| トークン | ノート | 置換文字列 | 例 | 結果 |
|---|---|---|---|---|
${valuesForColumn:COLUMN} |
該当なし | 修飾データ参照からの列の表示値。 | ${valuesForColumn: "Sales"."Products"."Brand"} |
BizTech,FunPod |
${valuesForColumn:COLUMN, separator:"/"}
|
複数の値で置き換えることができるトークンでは、オプションのセパレータ・オプションがサポートされます。 separatorはデフォルトでカンマ(,)ですが、任意の文字列に設定できます。 この文字列内でバックスラッシュ(\).)を使用すると、二重引用符をエスケープできます。
|
修飾データ参照からの列の表示値。 | ${valuesForColumn: "Sales"."Products"."Brand"} |
BizTech,FunPod |
${valuesForColumn:COLUMN, separationStyle:individual}
|
デフォルトのseparationStyleはdelimitedですが、ユーザーが値ごとに個別のURLパラメータを生成する必要がある場合は、individualに設定できます。
|
修飾データ参照からの列の表示値。 | &myParam=${valuesForColumn: "Sales"."Products"."Brand"} |
&myParam=BizTech&myParam=FunPod |
${keyValuesForColumn:COLUMN}
|
該当なし | 修飾データ参照からの列キー値。 | ${keyValuesForColumn:COLUMN} |
10001,10002 |
${env:ENV_VAR}
|
サポートされる環境変数: sProjectPath、sProjectName、sCanvasName、sUserID、およびsUserNameを含む。
|
環境変数。 | ${env:'sUserID'} |
myUserName |