レポートのパラメータ設定の構成
パラメータはデータ・モデルで定義されます。レポート・エディタを使用すると、特定のデータ・モデルを使用する各レポートに専用のパラメータ設定を構成できます。
- レポート・エディタ・ページで「パラメータ」をクリックします。次の図に示すように、「パラメータ」ダイアログが表示されます。
- 次の表示オプションを選択して、個別レポートのパラメータ設定をカスタマイズします。
パラメータの場所 - このプロパティは、パラメータ・リージョンをレポート・ビューアに表示するかどうかを制御します。オプションは次のとおりです。
- 水平リージョン - レポート・ビューアの最上部に、横方向にパラメータを表示します。
- 垂直リージョン - レポート・ビューアの左端に沿って、縦方向にパラメータを表示します。
- フル・ページ - パラメータをレポート・ビューアの単独のページに表示します。ユーザーがパラメータ値を入力すると、このページは消えます。パラメータ値を変更するには、レポート・ビューアの「パラメータ」ボタンをクリックして、「パラメータ」ページをもう一度表示します。
- ダイアログ - ダイアログ・ボックスを呼び出して、パラメータを表示します。ユーザーがパラメータ値を入力すると、このダイアログは閉じられます。パラメータ値を変更するには、レポート・ビューアの「パラメータ」ボタンをクリックして、ダイアログをもう一度表示します。
パラメータ・ラベルの場所 - このプロパティは、パラメータ・ラベルの表示場所を制御します。オプションは次のとおりです。
- ラベルを横に配置 - 入力ボックスの左側にパラメータ・ラベルを配置します。
- ラベルを上に配置 - 入力ボックスの上にパラメータ・ラベルを配置します。
「適用」ボタンの表示 - このプロパティは、レポート・ビューアでの「適用」ボタンの表示を制御します。
Trueに設定されている場合は、レポート・ビューアでパラメータ・オプションのあるレポートに「適用」ボタンが表示されます。パラメータ値を変更した場合にユーザーは「適用」をクリックし、変更後の値でレポートをレンダリングする必要があります。
「False」に設定すると、レポート・ビューアに「適用」ボタンは表示されません。そのかわり、ユーザーが新しいパラメータ値を入力する際に、新しい値が選択または入力されると、ユーザーが特に操作をしなくても、Publisherによってレポートが自動的にレンダリングされます。
このプロパティは、サーバー・レベルでも設定されます。常にこのサーバー設定を使用する場合は、「デフォルト」オプションを選択します。
「適用」ボタンを削除するかどうかを決定するときには、基礎となるデータソースにすばやくデータを戻す能力があるかどうかを考慮してください。静的リストや非常に高速なデータソースに基づく値リストでは、「適用」ボタンをオフにすることが理想的です。値リストの基礎となるデータソースの問合せに時間がかかる場合、またはレポートをレンダリングする前に、多数のパラメータ値の設定と調整が行われる場合には、「適用」ボタンを保持することをお薦めします。
表示 - このプロパティは、パラメータをユーザーに表示するかどうかを制御します。データ・モデルに渡されるパラメータ値をユーザーが表示したり、変更しないようにする場合は、「表示」プロパティを無効にします。
他のパラメータが依存するパラメータを非表示にしないでください。非表示パラメータの値が変更された場合、その非表示パラメータに依存するすべてのパラメータが更新されません。このように更新されないと、「無効なパラメータが要求されました」などのメッセージが表示されてレポート生成に失敗する場合があります。
タイプ - このプロパティは、メニュー・タイプのパラメータでのみカスタマイズできます。メニュー・タイプのパラメータでは、次の表示オプションを使用できます。
- チェック・ボックス - パラメータで複数選択が許可されている(「複数」 = 「True」)場合、このオプションを使用できます。チェック・ボックス・タイプでは、レポートのパラメータ・リージョンにメニュー・オプションがすべて表示されます。次の図に示すとおり、ユーザーは複数選択を行うことができます。
- ラジオ・ボタン - パラメータで単一選択のみ許可されている(「複数」 = 「False」)場合、このオプションを使用できます。ラジオ・ボタン・タイプでは、レポートのパラメータ・リージョンにメニュー・オプションがすべて表示されます。次の図に示すとおり、ユーザーは項目を1つのみ選択できます。
- 「チェックボックス」および「ラジオ・ボタン」オプションは、値リストが小さい場合のメニューに最適です。これらのオプションは、「パラメータの場所」が「垂直リージョン」である場合にも問題なく表示されます。
複数 - このプロパティは表示専用で、メニュー・パラメータについて複数の値を選択できるかどうかを示します。
表示ラベル - 各パラメータの表示ラベルを編集するには、このプロパティを使用します。デフォルト値はデータ・モデルに定義されています。
デフォルト値 - 特定のレポート専用として使用されるパラメータのデフォルト値を構成するには、このプロパティを使用します。データ・モデルで定義されたデフォルト値を渡すには、「デフォルト」を選択します。
行配置 - パラメータを表示する行数、および各パラメータの配置先となる行を構成するには、このプロパティを使用します。たとえば、レポートで6個のパラメータが使用されている場合、行1を先頭に、パラメータを行1-6に1個ずつ割り当てることも、行1、2、3にパラメータを2個ずつ割り当てることもできます。デフォルトでは、すべてのパラメータが行1に割当てられます。- 「パラメータの場所」プロパティが「垂直リージョン」に設定されている場合は、1行につき1パラメータのみ表示されます。行を垂直方向に並べるには、「行配置」プロパティを使用します。
