投稿日時: 2013年3月12日 03:32:15
セッション変数 #
セッション変数は、各ユーザーのログイン時に初期化されます。ユーザーがセッションを開始すると、BI Server はセッション変数の新しいインスタンスを作成して初期化します。
セッション変数のインスタンスは、BI Server 上のアクティブなセッションの数だけ存在します。セッション変数の各インスタンスは、異なる値に初期化できます。
セッション変数には2種類あります：
- システム - BI Server と BI Presentation Services が特定の目的で使用するセッション変数。
システムセッション変数には、他の種類の変数（静的または動的なリポジトリ変数や非システムセッション変数など）に使用できない予約名があります。
- システム以外 - 管理者が作成し、名前を付けるシステム変数。例えば、管理者は、ユーザの販売地域の名前を初期化する SalesRegion 非システム変数を作成するかもしれません。
管理者は、Oracle BI Administration Tool を使用してシステム以外のセッション変数を作成します。
リポジトリ変数 #
リポジトリ変数は、どの時点でも単一の値を持つ変数です。
リポジトリ変数には2種類あります：
- 静的 - リポジトリ変数の値は、管理者が変更を決定するまで変更されません。
- ダイナミック - クエリから返されたデータによって値が更新されるリポジトリ変数。
管理者は、Oracle BI Administration Tool を使用してリポジトリ変数を作成します。
プレゼンテーション変数 #
プレゼンテーション変数は、次のいずれかのタイプのダッシュボードプロンプトを作成するプロセ スの一部として作成できる変数です：
- カラムプロンプト - カラムプロンプトの一部として作成されたプレゼンテーション変数はカラムに関連付けられ、その変数が取り得る値はカラムの値から得られます。
カラムプロンプトの一部としてプレゼンテーション変数を作成するには、"New Prompt dialog" (または "Edit Prompt" ダイアログ) で プレゼンテーション変数 での 変数の設定 フィールドに変数名を入力します。 変数名 フィールド。
- 変数プロンプト - 変数プロンプトの一部として作成されたプレゼンテーション変数は、どの列にも関連付けられません。
変数プロンプトの一部としてプレゼンテーション変数を作成するには、"新規プロンプトダイアログ"（または "プロンプトの編集 "ダイアログ）で プレゼンテーション変数 での プロンプト フィールドに変数名を入力し 変数名 フィールド。
プレゼンテーション変数の値は、その変数が作成された列または変数プロンプトによって設定されます。つまり、ユーザが列または変数プロンプトで値を選択するたびに、プレゼンテーション変数の値はユーザが選択した値に設定されます。
リクエスト変数 #
リクエスト変数はセッション変数の値を上書きすることができますが、カラムプロンプトから開始されたデータベースリクエストの間だけです。リクエスト変数はカラムプロンプトを作成する過程で作成することができます。
カラムプロンプトの一部として作成されるリクエスト変数はカラムに関連付けられ、カラムの値から値を取ることができます。
カラムプロンプトの一部としてリクエスト変数を作成するには、"New Prompt dialog" (または Edit Prompt ダイアログ) で リクエスト変数 で 変数の設定 フィールドにオーバーライドするセッション変数の名前を入力します。 変数名 フィールド。
リクエスト変数の値は、作成されたカラムプロンプトによって設定されます。つまり、ユーザーがカラムプロンプトで値を選択するたびに、リクエスト変数の値はユーザーが選択した値に設定されます。ただし、この値はユーザーが 行く ボタンをクリックして、分析結果がダッシュボードに戻るまでプロンプトを表示します。
変数の参照先は？ #
変数は以下の領域で参照することができます（ただし、各領域ですべての種類の変数を参照できるわけではありません）：
- タイトルの見方
- 物語的な見解。
- 静的テキストビュー。
- フィルター
- 列の数式。
- 条件付き書式の条件
- 分析における表と列の見出し。
- データベースへの直接リクエスト
- ダッシュボードのプロンプトとインラインのプロンプト。
- PDF出力用のヘッダーとフッター。
- ダッシュボード内のリンクまたは画像オブジェクト。
- ダッシュボードのテキストオブジェクト
- グラフデータの条件付き書式を指定するグラフ。
- ゲージのしきい値。
- ゲージの限界。
- 代理店です。
- パラメータを指定するアクション。
- パラメータを指定する条件。
- 選考ステップ
- 閾値を定義するためのKPI。
- KPI ウォッチリストに含まれる KPI。
- ダイアログの URL フィールド。
変数を参照する構文
変数は、分析、ダッシュボード、KPI、エージェントで使用できます。どのように変数を参照するかは、実行するタスクによって異なります。
ダイアログにフィールドが表示されるタスクでは、変数の型と名前だけを指定する必要があります（完全な構文ではありません）。
タイトル・ビューで変数を参照するなどの他のタスクでは、変数の構文を指定します。表 1 に示すように、使用する構文は変数のタイプによって異なります。
注：
構文では、"at "記号（@）の後に中括弧（{）が続かない場合、"at "記号として扱われます。
表 1 変数を参照するための構文
| 変数の種類 | 構文 | 例 |
| セッション | @{biServer.variables['NQ_SESSION. バリアブルネーム ']}ここで バリアブルネーム はセッション変数の名前です。 | @{biServer.variables['NQ_SESSION.USER']}. |
| リポジトリ | biServer.variables。 バリアブルネーム または @{biServer.variables[' バリアブルネーム ']}ここで バリアブルネーム はリポジトリの変数名で、たとえば prime_begin です。 | biServer.variables.prime_begin}または@{biServer.variables['prime_begin']}です。 |
| プレゼンテーションまたはリクエスト | 変数。 バリアブルネーム }[ フォーマット ]{ デフォルト値 または @{ 範囲 .variables[' バリアブルネーム ']}となります： バリアブルネーム はプレゼンテーション変数またはリクエスト変数の名前です。(オプション) フォーマット は変数のデータ型に依存するフォーマットマスクで、例えば #,##0,MM/DD/YYh:mm:ss。(フォーマットはデフォルト値には適用されないことに注意してください。) (オプション) デフォルト値 によって参照される変数が、その変数で使用される値を示す定数または変数参照です。 バリアブルネーム は入力されません。 範囲 は、変数の修飾子を識別します。変数が複数のレベル (分析、ダッシュボード・ページ、ダッシュボード) で使用され、特定の値にアクセスしたい場合は、スコープを指定する必要があります (スコープを指定しない場合は、分析、ダッシュボード・ページ、ダッシュボードの順に優先されます)。(スコープを指定しない場合は、分析、ダッシュボード・ページ、ダッシュボードの順に優先されます)。 | @{variables.MyFavoriteRegion}{EASTERN REGION}または@{dashboard.variables['MyFavoriteRegion']}。 |
式の中で変数を参照することもできます。式の中で変数を参照するためのガイドラインは、表 2 に記載されています。
表 2 式中の変数の参照に関するガイドライン
| 変数の種類 | ガイドライン | 例 |
| セッション | VALUEOF 関数の引数としてセッション変数を含めます。変数名は二重引用符で囲みます。セッション変数の前に NQ_SESSION とピリオドを置きます。NQ_SESSION 部分とセッション変数名の両方を括弧で囲みます。 | "市場". "地域"=VALUEOF(NQ_SESSION. "販売地域") |
| リポジトリ | VALUEOF 関数の引数にリポジトリ変数を含めます。変数名を二重引用符で囲みます。静的リポジトリ変数を名前で参照します。動的リポジトリ変数を完全修飾名で参照します。動的リポジトリ変数を使用する場合、初期化ブロックとリポジトリ変数の名前は二重引用符（"）で囲み、ピリオドで区切り、括弧で囲む必要があります。例えば、Region Security という名前の初期化ブロックに含まれる REGION という名前の動的リポジトリ変数の値を使用するには、次の構文を使用します：VALUEOF("Region Security". "REGION") | CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour"< VALUEOF("prime_end") THEN 'プライムタイム' WHEN ... ELSE ...END |
| プレゼンテーション | variablename}{defaultvalue}という構文を使います。variablenameはプレゼンテーション変数名で、defaultvalue（オプション）はvariablenameで参照される変数に値が入らない場合に使われる定数または変数参照です。変数を文字列にタイプキャスト（つまり変換）するには、構文全体をシングルクォートで囲みます。 注：@記号の後に{が付かない場合は、@記号として扱われます。 | "Market". "Region"={MyFavoriteRegion}{EASTERN REGION}。 |
