変数は、分析、ダッシュボード、KPIおよびエージェントで参照できます。変数の参照方法は、実行するタスクによって異なります。
フィルタ定義で変数を参照する場合など、ダイアログにフィールドが表示されるタスクの場合、(完全な構文ではなく)変数のタイプと名前のみ指定する必要があります。
タイトル・ビューでの変数の参照などの他のタスクの場合、変数の構文を指定する必要があります。次の表に示すとおり、使用する構文は変数のタイプによって異なります。
注意:
構文で、アット・マーク(@)の後ろに中カッコ({)がない場合は、アット・マークとして処理されます。変数のタイプ | 構文 | 例 |
---|---|---|
セッション |
@{biServer.variables['NQ_SESSION.variablename']} variablename は、セッション変数の名前です(DISPLAYNAMEなど)。 使用できるシステム・セッション変数のリストについては、Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドのシステム・セッション変数についてを参照してください。 |
@{biServer.variables['NQ_SESSION.USER']} |
リポジトリ |
@{biServer.variables.variablename} または @{biServer.variables['variablename']} variablenameは、リポジトリ変数の名前です(prime_beginなど)。 |
@{biServer.variables.prime_begin} または @{biServer.variables['prime_begin']} |
プレゼンテーションまたはリクエスト |
@{variables.variablename}[format]{defaultvalue} または @{scope.variables['variablename']} 説明:
注意: 複数の値を設定できるプレゼンテーション変数が指定されたダッシュボード・プロンプトを使用する際には、列タイプによって構文が異なります。複数の値がカンマ区切りの値に書式設定されるため、書式設定句は、カンマで結合される前に各値に適用されます。 |
@{variables.MyFavoriteRegion}{EASTERN REGION} または @{MyFavoriteRegion} または @{dashboard.variables['MyFavoriteRegion']} または (@{myNumVar}[#,##0]{1000}) または (@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{) または (@{myTextVar}{A, B, C}) |
グローバル |
@{global.variables.variablename} variablenameはグローバル変数の名前です(例: gv_region)。グローバル変数を参照する場合は、例に示すように、完全修飾名を使用する必要があります。 注意: グローバル変数の命名規則は、JavaScriptのEMCAスクリプト言語仕様に準拠している必要があります。名前は200文字以内にする必要があります。埋込みスペース、予約語および特殊文字は使用できません。JavaScripting言語要件に精通していない場合は、サード・パーティのリファレンスを参照してください。 |
@{global.variables.gv_date_n_time} |
変数は式で参照することもできます。式で変数を参照するためのガイドラインは、次の表に記載されています。
変数のタイプ | ガイドライン | 例 |
---|---|---|
セッション |
|
"Market"."Region"=VALUEOF(NQ_SESSION."SalesRegion") |
リポジトリ |
|
CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END |
プレゼンテーション |
注意: @マークの後ろに{がない場合は、@マークとして処理されます。 複数の値を設定できるプレゼンテーション変数を使用する際には、列タイプによって構文が異なります。 有効なSQL文を生成するには、各列タイプのSQLで次の構文を使用します。
|
"Market"."Region"=@{MyFavoriteRegion}{EASTERN REGION} または "Products"."P4 Brand"=(@{myTextVar}['@']{BizTech}) または "Products"."PO Product Number"=(@{myNumVar}{1000}) または "Sales Person"."E7 Hire Date"=(@{myDateTimeVar}{timestamp '2013-05-16 00:00:01'}) または "Time"."Total Fiscal Time"=(@{myDateVar}{date '2013-05-16'}) または "Time"."Time Right Now"=(@{myTimeVar}{time '00:00:01'}) SQL使用時の複数の値(指定されたデータ型内)について:
または
または
|
変数を参照できる特定の領域については、変数を参照できる場所を参照してください。