新規パラメータの追加

名前およびその他のプロパティを割り当てて新規パラメータを作成します。

パラメータ名を決定する際は、使用するデータベースの識別子に許容された最大文字数を超過してはいけません。識別子の長さの制限については、使用するデータベースのドキュメントを参照してください。

サポートされているタイプは、次のとおりです。

• テキスト - ユーザーはパラメータとして渡すテキスト・エントリを入力できます。テキスト・パラメータの作成を参照してください。

• メニュー - ユーザーに値リストを提示します。メニュー・パラメータの作成を参照してください。

• 日付 - 日付パラメータを渡します。「データ型」も日付にする必要があります。日付パラメータの定義を参照してください。

デフォルトのパラメータ値は、Oracle BI Publisherレイアウト・エディタを使用してレポートのレイアウトを設計する際に、レポート出力をプレビューするためにも使用されます。

BI Publisherでは、テキスト入力またはメニュー(値リスト)のタイプをサポートしていますが、両方はサポートしていません。ユーザーがテキスト値を入力することも、値リストのメニューから選択することもできるような複合パラメータは定義できません。

行配置は、レポート・レベルで構成できます。レポート定義では、パラメータに対して追加の表示オプションをサポートしています。詳細は、Oracle Business Intelligence Publisherレポート・デザイナーズ・ガイドのレポートのパラメータ設定を構成する方法を参照してください。

1. 「データ・モデル」のコンポーネント・ペインで、「パラメータ」をクリックし、「新規パラメータの作成」をクリックします。
   
   

   
   図GUID-92F8D4A0-EAA9-432F-836D-1F3F18678137-default.gifの説明

   
   
2. パラメータの「名前」を入力します。
   名前はデータ・セット内のこのパラメータへの参照と同じにする必要があります。
3. リストから「データ型」を選択します。「日付」データ型は、日付の「パラメータ・タイプ」のみをサポートします。
4. パラメータの「デフォルト値」を入力します。長時間実行される問合せを防止するために、これをお薦めします。
5. 「パラメータ・タイプ」を選択します。
6. 「行配置」設定で、パラメータを表示する行の数と、各パラメータを配置する行を構成します。

   たとえば、レポートで6個のパラメータが使用されている場合、行1を先頭に、パラメータを行1-6に1個ずつ割り当てることも、行1、2、3にパラメータを2個ずつ割り当てることもできます。デフォルトでは、すべてのパラメータが行1に割当てられます。

テキスト・パラメータの作成

「テキスト」タイプのパラメータは、テキスト・ボックスを提示して、パラメータとしてデータソースに渡すテキスト・エントリを入力するようにユーザーに求めます。

次の図に、テキスト・パラメータの定義を示します。

図GUID-999C80A1-A920-4743-84EA-5D05A7A4CB4A-default.gifの説明

1. 「パラメータ・タイプ」リストから「テキスト」を選択します。
2. 「表示ラベル」に入力します(例: Department)。
3. 「テキスト・フィールド・サイズ」に整数を入力します(例: 25)。
4. 必要に応じて、次の「オプション」を有効にします。

   • テキスト・フィールドにカンマ区切りの値を含む - ユーザーはこのパラメータに対してカンマ区切りの複数の値を入力できます。データソース内のパラメータは、複数の値をサポートするように定義されている必要があります。

   • 変更時に他のパラメータをリフレッシュ - このパラメータの値に依存する値を持つ他のパラメータをリフレッシュするために、ページの部分的なリフレッシュを実行します。

次の図に、レポート利用者に表示されるDepartmentパラメータを示します。

図GUID-5BA89213-5CD4-4565-9CD1-A237924D44B9-default.gifの説明

メニュー・パラメータの作成

メニュー・タイプのパラメータは、ユーザーに値リストを提示します。

最初に、値リストを定義しておく必要があります。値リストの追加を参照してください。メニュー・タイプのパラメータは、文字列および整数のデータ型のみをサポートします。

メニュー・パラメータの定義は、次の図に示されているような様々なオプションを含みます。

図GUID-786490EA-7F93-43DB-9D68-26BBAA15E108-default.gifの説明

1. 「パラメータ・タイプ」リストから「メニュー」を選択します。下側のペインに適切なフィールドが表示されます。
2. データ型で、「文字列」または「整数」を選択します。
3. 「表示ラベル」を入力します。表示ラベルは、レポートを表示したときにユーザーに表示されるラベルです。たとえば、Departmentなど。
4. 「リストに表示する値の数」を入力します。このフィールドのエントリよりもリスト内の値の数が多い場合、次の図に示されているようにユーザーは「検索」をクリックして、表示されていない値を探す必要があります。このフィールドのデフォルトは、100に設定されています。
   
   図GUID-E9EC1EF6-CF50-49A4-AD4C-60574F332E82-default.gifの説明
5. このパラメータに定義した「値リスト」を選択します。
6. 必要に応じて、次の「オプション」を有効にします。

   • 複数選択 - ユーザーはリストから複数のエントリを選択できます。データソースは、このパラメータに対して複数の値をサポートできる必要があります。複数の選択をサポートするメニュー・パラメータの表示は別のものになります。次の2つの図を参照してください。

   • 全選択可能 - リストに「すべて」オプションを挿入します。

     値リストから「すべて」を選択すると、パラメータにNULL値を渡すか、リストのすべての値を渡すかを選択できます。「NULL値が渡されました」または「すべての値が渡されました」を選択します。

     注意:

     「*」を使用するとNULLを渡すことになるため、データソースでNULLを処理する必要があります。NULLを処理するメソッドは、次のような標準のOracle NVLコマンドです。

     ここでcustomer_id = nvl(:cstid, customer_id)

     cstidは値リストから渡された値です。ユーザーが「すべて」を選択すると、値リストからNULL値が渡されます。

   • 変更時に他のパラメータをリフレッシュ - このパラメータの値に依存する値を持つ他のパラメータをリフレッシュするために、ページの部分的なリフレッシュを実行します。

次の図は、複数選択が無効にされている場合に、レポート利用者に表示されるDepartmentメニュー・タイプのパラメータを示しています。

図GUID-B79461C1-7235-4831-AC13-2D8BC9275D7F-default.gifの説明

次の図は、複数選択が有効にされている場合に、レポート利用者に表示されるDepartmentメニュー・タイプのパラメータを示しています。

図GUID-372B328D-CAB4-4699-8C67-A3D3B95F4028-default.gifの説明

メニュー・パラメータの表示のカスタマイズ

レポート内でのメニュー・パラメータの表示は、レポート定義でさらにカスタマイズできます。

メニュー・タイプのパラメータは、追加の表示オプションをチェック・ボックスまたはラジオ・ボタンの静的リストとしてサポートしています。詳細は、Oracle Business Intelligence Publisherレポート・デザイナーズ・ガイドのレポートのパラメータ設定を構成する方法を参照してください。

日付パラメータの定義

日付タイプのパラメータは、データソースに渡すパラメータとして日付を入力するようにユーザーに求める日付ピッカーを提示します。

図に、日付パラメータの定義を示します。

図GUID-B32966B0-7EE6-4E25-8F00-72579CDFFD87-default.gifの説明

1. 「パラメータ・タイプ」リストから「日付」を選択します。下側のペインに、選択に応じた適切なフィールドが表示されます。
2. 「表示ラベル」を入力します。表示ラベルは、レポートを表示したときにユーザーに表示されるラベルです。たとえば、Hire Dateなど。
3. 「テキスト・フィールド・サイズ」に整数を入力します。このフィールドでは、日付エントリ用のテキスト・ボックスにユーザーが入力できる文字数を決定します。例: 10。
4. 「日付書式文字列」を入力します。この書式は、Javaの日付書式にする必要があります(例: MM-dd-yyyy)。
5. 必要に応じて、「開始日」と「終了日」を入力します。ここに入力した各日付によって、日付ピッカーでユーザーに提示する日付の範囲を定義します。たとえば、「開始日」に01-01-1990を入力すると、ユーザーは1990年1月1日より前の日付を日付ピッカーで選択できなくなります。「終了日」を空白のままにすると、将来の日付がすべて有効になります。

図に、レポート利用者に表示されるHire Dateパラメータを示します。

図GUID-12054EC5-D470-4453-8328-3C74C4808A69-default.gifの説明