| Oracle Business Activity Monitoring Active Studioユーザーズ・ガイド 10g（10.1.3.1.0） B31880-01 |
|
 戻る |
 次へ |
この章では、プロンプトとパラメータの使用について説明します。
この章のトピックは、次のとおりです。
パラメータは、置換される値を示す変数に類似しています。 プロンプトは、ユーザーがパラメータ値を指定できるように、レポートが開く前に表示されるダイアログ・ボックスです。ユーザーがレポートを表示したときに表示されるプロンプトを作成できます。そのユーザーは、プロンプトのダイアログ・ボックスで値を指定する必要があります。この値は、レポート内のデータ表示を制限したり、カスタマイズするために使用されます。また、値を含むパラメータを作成することもできます。レポートが実行されても、ユーザーにはパラメータは表示されません。
レポートでのプロンプトおよびパラメータの適用は、フィルタでこれらを使用して行う必要があります。プロンプトおよびパラメータの作成は、「Report Properties」ダイアログ・ボックスからか、またはフィルタの作成時に行うことができます。 「Report Properties」ダイアログ・ボックスの「Prompts and Parameters」ページには、レポート全体のプロンプトおよびパラメータの両方を管理、編集および削除する方法がまとめて提供されています。
プロンプトまたはパラメータを含むレポートには、アラートを作成できません。レポートにプロンプトまたはパラメータを追加すると、レポートにアラートを保持できなくなります。アラートは無効になり、起動できなくなります。
パラメータの作成は、「Change Report Properties」ダイアログ・ボックスか、または値を指定するときにフィルタで行うことができます。「Change Report Properties」ダイアログ・ボックスでパラメータを作成しても、フィルタで使用されるまでは、レポートではアクティブになりません。パラメータは、ユーザーに対して値を指定するように求めません。レポート設計者が、パラメータの値を指定します。
新しいパラメータを作成するには、次の手順を実行します。
編集中のレポートで、「Change Report Properties」をクリックします。
「Report Properties」ダイアログ・ボックスが表示されます。
「New」をクリックします。
「Prompt and Parameter Creation and Edit」ダイアログ・ボックスが表示されます。
パラメータの名前を入力します。
「Parameter Type」リストから、値のデータ型を選択します。
パラメータの説明を入力します。これは、パラメータの編集時にのみ表示されます。
「Use one of the values below (parameter)」をクリックします。
パラメータで使用する値を選択するか、新しい値を空のフィールドに入力します。
「OK」をクリックします。
パラメータが作成されます。
カスタム・パラメータは、アクション・ボタン用の特別なパラメータで、Oracle Business Activity Monitoringインストールのすべてのレポートで使用できます。 カスタム・パラメータを作成するには、Custom Parametersデータ・オブジェクトをArchitect Webアプリケーションで編集する必要があります。
カスタム・パラメータを作成するには、次の手順を実行します。
Architect Webアプリケーションを開き、リストから「Data Objects」を選択します。
Data Objects/System/Custom ParametersフォルダにあるCustom Parametersデータ・オブジェクトを選択します。
「Contents」をクリックします。
「Edit Contents」をクリックします。
「Add」をクリックします。
カスタム・パラメータの名前を入力します。 この名前が、アクション・ボタン用に使用可能なプロンプトとパラメータのリストに表示されることになります。
カスタム・パラメータの値を入力します。
カスタム・パラメータの簡単な説明を入力します。
「Save」をクリックします。
ユーザーがテキスト・フィールドの値を入力するか、またはリストから1つ以上の値を選択する必要があるプロンプトを作成できます。
プロンプトの作成は、「Change Report Properties」ダイアログ・ボックスか、または値を指定するときにフィルタで行うことができます。「Change Report Properties」ダイアログ・ボックスでプロンプトを作成しても、フィルタで使用されるまでは、レポートではアクティブになりません。
新しいプロンプトを作成するには、次の手順を実行します。
「Change Report Properties」をクリックします。
「Report Properties」ダイアログ・ボックスが表示されます。
「New」をクリックします。
「Prompt and Parameter Creation and Edit」ダイアログ・ボックスが表示されます。
プロンプトの名前を入力します。
「Parameter Type」リストから、値のデータ型を選択します。
プロンプトの説明を入力します。これは、ユーザーに対するプロンプト・メッセージには表示されません。
「Prompt the user to specify a value」を選択します。
「Next」をクリックします。
ダイアログ・ボックスの「User Input Type」ページが表示されます。
ユーザー入力のタイプを選択します。
Type in: ユーザーが値を入力する必要があるフィールドを作成します。
Choose from a list of field values: ユーザーが選択する必要がある選択肢のリストを作成します。
プロンプト・メッセージに表示するテキストを、「Prompt message text」フィールドに入力します。 1つ前の手順で「Choose from a list of field values」を選択した場合は、このテキストがビューのリストの隣に表示されます。
「Next」をクリックします。
入力の定義を構成します。
前の画面でユーザー入力のタイプとして「Type in」を選択した場合は、次の手順を実行します。
デフォルト値として表示できる値を「ALL」または「NULL」から選択します。
「User can leave value blank」を選択して、このオプションを許可します。
「Type in」プロンプトを使用している場合、ユーザーは次のように入力して、すべて、NULLまたは空白の値を指定できます。
_ALL_: すべての値を戻します。
_NULL_: NULL値を戻します。
_BLANK_: 空白値を戻します。
「Next」をクリックします。
前の画面でユーザー入力のタイプとして「Choose from a list of field values」を選択した場合は、次の手順を実行します。
値を得るデータ・オブジェクトを選択します。
「Change」をクリックして、データ・オブジェクトを選択します。 そのデータ・オブジェクトのフィールドによって、「Field」リストの値が移入されます。
「Field」リストからフィールドを選択します。 そのフィールド内の値が「Value」リストに移入されます。
リストから除外する値がある場合は、「Choose values」を選択します。 次に、プロンプトに表示する値を選択します。
値を選択し「Default Value」クリックして、レポートが開くときの開始値を指定します。 デフォルト値の隣には、青色の矢印が表示されます。
「ALL」、「NULL」または「BLANK」を選択して、これらの値のいずれかをリストに追加します。
「User can leave value unselected」または「User can select multiple values」を選択して、これらのオプションを有効にします。
「Next」をクリックします。
ダイアログ・ボックスの「Summary」ページが表示されます。
選択内容を確認して「Preview」をクリックし、作成したプロンプトを表示します。
作成した「Prompts」ダイアログ・ボックスが表示されます。
「OK」をクリックして、「Prompts」ダイアログ・ボックスを閉じます。
「OK」をクリックして、「Prompt and Parameter Creation and Edit」ダイアログ・ボックスを閉じます。
プロンプトが「Prompts and Parameters」リストに表示されます。 デフォルト値が選択されていないかぎり、このレポートが表示される前に、プロンプトのダイアログ・ボックスが表示され、ユーザーの入力を待機します。
この項のトピックは、次のとおりです。
プロンプトおよびパラメータでの作業は、「Report Properties」ダイアログ・ボックスから行うことができます。このダイアログ・ボックスから作成および編集されたプロンプトおよびパラメータは、レポートのすべてのビューに属します。これらをアクティブにするには、ビュー・レベルでフィルタに適用する必要があります。「Report Properties」ダイアログ・ボックスからプロンプトおよびパラメータを管理すると、複数の領域のビューに適用される変更を1回で行うことができます。
プロンプトおよびパラメータを作成するには、次の手順を実行します。
作成中または編集中のレポートで、「Change Report Properties」をクリックします。
「Report Properties」ダイアログ・ボックスが表示されます。「Prompts and Parameters」タブが選択されます。
「New」をクリックします。
「Prompt and Parameter」ダイアログ・ボックスが表示されます。
プロンプトの作成については、「プロンプトの作成」を参照してください。
パラメータの作成については、「パラメータの作成」を参照してください。
プロンプトおよびパラメータが作成されると、これらは「Report Properties」ダイアログ・ボックスに名前で表示されます。データ型およびデフォルト値は、プロンプト名またはパラメータ名の横に表示されます。リスト内のプロンプトの配置を調整することで、表示されるプロンプトの順序を変更できます。パラメータの場合は、エンド・ユーザーによって表示されないため、「Arrange」ボタンおよび「Preview」ボタンは無効になっています。
プロンプトの順序を調整するには、次の手順を実行します。
「Report Properties」ダイアログ・ボックスでプロンプトを選択します。
調整するための矢印をクリックして、リスト内でプロンプトを上または下に移動します。
プロンプトをプレビューするには、次の手順を実行します。
「Report Properties」ダイアログ・ボックスでプロンプトを選択します。
「Preview」をクリックします。
プロンプト・ダイアログ・ボックスが表示されます。
プロンプトまたはパラメータを編集するには、次の手順を実行します。
編集するプロンプトまたはパラメータを選択します。
「Edit」をクリックします。
指定されたフィールドを含む「Prompt and Parameter Creation and Edit」ダイアログ・ボックスが表示されます。
必要に応じて変更を行い、「OK」をクリックします。
このプロンプト値またはパラメータ値を使用する、レポート内のすべてのフィルタが更新されます。
プロンプトまたはパラメータを削除するには、次の手順を実行します。
削除するプロンプトまたはパラメータを選択します。
「Delete」をクリックします。
プロンプトまたはパラメータが削除されます。 このプロンプトまたはパラメータを使用しているフィルタがレポートにあれば、そのフィルタもビューから削除されます。
プロンプトをカスケードすると、他のプロンプトの入力に依存するプロンプトを作成できます。
プロンプトをカスケードするには、次の手順を実行します。
プロンプトを選択し、「Cascade」をクリックします。
プロンプトに関する説明を表示する必要がある場合は、プロンプト・メッセージ・テキストを入力します。
チェック・ボックスを選択して、カスケードするプロンプトを選択します。
矢印ボタンを使用して、プロンプトの依存順序を調整します。
カスケードの順序が適切に設定されていることを確認してください（最初のプロンプトはその次のプロンプトのスーパーセットで、次のプロンプトはその前のプロンプトのサブセットである必要があります）。 プロンプトの順序が正しくない場合、プロンプトは意図するとおりには機能しません。
「OK」をクリックします。 プロンプトの関係が、「Prompts and Parameters」タブに表示されます。
「OK」をクリックして「Report Properties」ダイアログ・ボックスを閉じます。
レポートを表示するURLに、プロンプトおよびパラメータの値を指定できます。これは、ポータル・サイトのWebページ、電子メール内のリンクなど、個別のブラウザで使用できます。レポートを表示して「Copy Shortcut」をクリックすると、レポートのURLをコピーできます。その後で、プロンプトおよびパラメータの値を追加、削除または変更できます。
構文の内容は、次のとおりです。
http://<host>:<http_port>/oraclebam/<buildnumber>/ActiveViewer/default.aspx?State=Start&Event=Initialize&NoWindow=True&ReportDef=<reportnumber>&Buttons=False
レポートをコールし、Active Viewerにそのレポートを表示するためのURLです。これは「Copy Shortcut」をクリックするときに表示されるダイアログ・ボックスからコピーします。
&ReportParameters=(PromptorParameterName=(PromptorParameterValue);)
1つのプロンプトまたはパラメータの値を定義するために必要なセクションです。プロンプトまたはパラメータに他の値を指定するとこで、これをカスタマイズできます。
複数のプロンプトまたはパラメータの値は、セミコロンで区切って任意の組合せとして定義できます。レポートに含まれるプロンプトがURLに定義されている値を保持していない場合、そのプロンプトはユーザーに表示され入力を求めます。
次の例は、プロンプトとパラメータを含むレポートに使用される構文を示しています。
http://host/oraclebam/3091/ActiveViewer/default.aspx?State=Start&Event=Initialize& NoWindow=True&ReportDef=1364&Buttons=False&ReportParameters=(BrandPrompt=(Fuji); StateParam=(California);)
プロンプトまたはパラメータを、すべて、NULLまたは空白に設定するには、値を表す次の構文を使用する必要があります。
_ALL_: すべての値を戻します。
_NULL_: NULL値を戻します。
_BLANK_: 空白値を戻します。
この項のトピックは、次のとおりです。
あるビューで選択操作を行い、別のビューを変更することをドライブと呼びます。 ドライブ処理では、あるビューでの選択内容を使用して、別のビューのプロンプトまたはパラメータをドライブできます。 たとえば、リスト・ビューの列を使用して棒グラフ・ビューをドライブし、リスト内のデータのサブセットをグラフで表示できます。
ビューをドライブするには、プロンプトまたはパラメータがフィルタで使用されている必要があります。 また、ドライブを正しく動作させるには、ドリルを無効にしておく必要があります。 ドリルは、ドライブより優先されます。
他のビューをドライブするビュー（ドライバ）に、プロンプトやパラメータを含める必要はありませんが、なんらかの設定は必要です。
ドライブ機能は、すべてのリスト・ビューおよびクロス集計ビューで使用可能です。
ドライブを構成するには、次の手順を実行します。
パラメータまたはプロンプトを作成し、ターゲット・グラフのフィルタで使用します。
ドライバ・ビューを編集します。
ビュー・エディタで「Properties」ボタンをクリックします。 ビュー・エディタを表示するには、編集するビューをダブルクリックするか、または「View Tasks/Options」リスト内の「Edit view」をクリックします。
「Driving」タブを選択します。
手順1で作成したプロンプトまたはパラメータを、データの任意の列に対して選択します。そのデータが、プロンプトまたはパラメータをフィルタで使用するビューをドライブするために使用されます。
ドライブを複数の値に対して有効にするには、「Turn Multi-select On」チェック・ボックスを選択します。
Multi-selectによって、1つの列の中の複数の値を選択できます。 Multi-selectは、ドライブされるビューに、複数の値に対応したプロンプトが構成されている場合にのみ正しく動作します。
「Apply」または「OK」をクリックします。
次に、リスト・ビューからグラフをドライブする例を示します。 この例では、Call Centerデータ・オブジェクトを使用しています。
手順1: ストリーミング・リスト・ビューおよび3D棒グラフ・ビューがあるレポートの作成
Active Studioで、「Home」、「My Reports」または「Shared Reports」タブを選択します。
「Create a New Report」をクリックします。
ビュー領域が2つあるタイル表示テンプレートを選択します。
上位のビュー領域で、ストリーミング・リスト・ビューを選択します。
ビュー・エディタが開きます。
ビュー・エディタで、Samplesフォルダを開いて、Call Centerデータ・オブジェクトを選択します。
「Next」をクリックします。
「Data Fields」選択画面で、すべてのフィールドを選択し、「Next」をクリックします。
「Finish」をクリックします。
下のビュー領域で、3D棒グラフ・ビューを選択します。
ビュー・エディタが開きます。
ビュー・エディタで、Samplesフォルダを開いて、Call Centerデータ・オブジェクトを選択します。
「Next」をクリックします。
「Group By」リスト内の「Description」を選択します。
「Chart Values」リスト内の「Quantity」を選択します。
「Summary Function」リスト内の「Sum」が選択されていることを確認します。
「Next」をクリックし、「Finish」をクリックします。
手順2: 3D棒グラフ・ビューでのプロンプト付きフィルタの作成
レポートで、3D棒グラフ・ビューを選択し、「View Tasks/Options」リスト内の「Edit view」をクリックします。
ビュー・エディタが開きます。
「Filter」タブを選択します。
「add new entry」をクリックします。
「field」リストからSalespersonを選択します。
「Comparison」リストから「is equal to」を選択します。
「Value」を選択します。
「Options」をクリックし、「*New Parameter/Prompt」を選択します。
「Prompt and Parameter Creation and Edit」ダイアログ・ボックスが開きます。
「Name」フィールドにSalespersonと入力し、「Next」をクリックします。
「Prompt message text」ボックスにSelect a salespersonと入力し、「Next」をクリックします。
「Field」リストからSalespersonを選択します。
「ALL」チェック・ボックスを選択します。
「Values」リスト内の「ALL」を選択し、「Default Value」をクリックします。
リスト内の「ALL」値の横に矢印が表示されます。
「User can select multiple values」を選択し、「Next」をクリックします。
「OK」をクリックします。
「Prompt and Parameter Creation and Edit」ダイアログ・ボックスが閉じて、「Value」フィールドにプロンプト式が表示されます。
「Filter」タブで「add entry」をクリックします。
ビュー・エディタで「OK」をクリックします。
「Prompts」ダイアログ・ボックスが開きます。
「OK」をクリックします。
データ・オブジェクト内のすべての営業担当者が販売した各製品の数量明細が3D棒グラフに表示されます。
手順3: ストリーミング・リスト・ビューでのドライブ機能の構成
レポートで、ストリーミング・リスト・ビューを選択し、「View Tasks/Options」リスト内の「Edit view」をクリックします。
ビュー・エディタが開きます。
ビュー・エディタで「Properties」アイコンをクリックします。
「Driving」タブを選択します。
「Map Fields to Prompts/Parameters」リストで、Salespersonの横のリストから「Salesperson」を選択します。
「OK」をクリックします。
ビュー・エディタが閉じます。
手順4: レポートの保存とドライブ機能のテスト
「Actions」リスト内の「Save Report」をクリックします。
「Save a Report」ダイアログ・ボックスが開きます。
レポートの名前と場所を選択し、「OK」をクリックします。
「Actions」リスト内の「View」をクリックします。
プロンプト・ダイアログ・ボックスが開きます。
「OK」をクリックします。
レポートのロード時に、ストリーミング・リスト・ビューの「Salesperson」列から「Sue」を選択します。
どの営業担当者を選択したかわかるように、選択した行のテキストの色が変わります。 棒グラフ・ビューの棒が変化して、Sueが販売した各製品の数量明細が表示されます。
手順5: Multi-selectの構成
Multi-selectを利用すると、リスト内の複数行を選択して、グラフをドライブできます。 Multi-selectは、ユーザーが複数の値を選択することを許可するようにプロンプトが構成してある場合（「手順2: 3D棒グラフ・ビューでのプロンプト付きフィルタの作成」を参照）にのみ正しく機能します。
ストリーミング・リスト・ビューを編集します。
ビュー・エディタで「Driving」タブを選択します。
「Turn Multi-select On」を選択し、「OK」をクリックします。
レポートを保存して表示します。
レポートのロード時に、ストリーミング・リスト・ビューの「Salesperson」列から「Sue」を選択します。
どの営業担当者を選択したかわかるように、選択した行のテキストの色が変わります。
ストリーミング・リスト・ビューの「Salesperson」列から「Mary」を選択します。
Sueの行のテキストに色が付いていますが、Maryの行のテキストにも色が付けられます。 3D棒グラフに、SueとMaryの2人が販売した各製品の数量明細が表示されます。
ストリーミング・リスト・ビューの「Salesperson」列から「Mary」を再度選択します。 テキストの色が反転し、3D棒グラフにはSueの売上のみが表示されます。
