レポート パラメータの作成とレポート パラメータ プロパティの設定

パラメータ名は必須であり、レポート内で一意である必要があります。パラメータのデータ型は、既定で String に設定されます。ドロップダウン リストから別のデータ型を選択することもできます。レポート パラメータがクエリ パラメータに基づいている場合は、レポート パラメータのデータ型がクエリ パラメータのデータ型と一致していることを確認してください。Reporting Services では、クエリ パラメータのデータ型が検出されないため、データ型を手動で調整する必要があります。

パラメータの名前は、共通言語仕様の文字および文字種規格に準拠する必要があります。詳細については、https://msdn.microsoft.com の「共通言語仕様」を参照してください。

パブリッシュされたレポートでは、通常、パラメータは、レポートの一番上にあるパラメータ エリアのテキスト ボックスとして表示されます。表示名の文字列は、パラメータ エリアのパラメータを識別するラベルを定義します。表示名には、"年" や "年を選択してください" など、パラメータの名前やユーザーへの指示を設定できます。表示名に何も指定せず、既定のパラメータ値を指定した場合は、既定値が使用され、レポートの実行時にパラメータの入力ボックスは表示されません。表示名に何も指定せず、しかも既定のパラメータ値を指定しなかった場合は、レポートを実行することはできません。ユーザーにパラメータ値の指定を要求しない場合は、[非表示] または [内部] を選択します。

パブリッシュされたレポートのパラメータの表示を制御するオプションを設定できます。[非表示] と [内部] の 2 つのオプションを設定することにより、異なるレベルでパラメータの表示を制御できます。パブリッシュされたレポートのパラメータ エリアでパラメータを非表示にした場合でも、レポートの URL やサブスクリプション定義ではそのパラメータの値を設定できます。パラメータを [内部] に設定した場合は、レポート定義以外ではパラメータが一切公開されなくなります。内部パラメータには既定値を設定する必要があります。[null 値を許可] チェック ボックスがオンになっている場合は、この既定値に NULL を指定できます。

[レポート パラメータ] ダイアログ ボックスで [複数値] オプションを選択することにより、複数の値を持つパラメータを定義できます。このチェック ボックスがオフになっている場合は、1 つの値を指定するパラメータになります。[複数値] チェック ボックスをオンにすると、パブリッシュされたレポートのパラメータ ドロップダウン リストの値にチェック ボックスが追加されます。これにより、ユーザーがチェック ボックスをオンにして必要な値を選択できるようになります。たとえば、Sales Reason Comparisons サンプル レポートでは、複数の製品を選択して、それらの製品の売上データを組み合わせて表示することができます。

使用できる値を指定する際には、静的な一覧を指定することも、クエリを使用して、使用できる値をデータ ソースから取得することもできます。複数の値を持つパラメータには、少なくとも 1 つの値を含める必要があります。NULL 値は許容されません。値が複数ある場合にのみ、[すべて選択] オプションが自動的に生成されて表示されます。

注意
Reporting Services で Analysis Services のデータ ソースを使用している場合は、[すべて選択] オプションを選択しないでください。[すべて選択] オプションを選択すると、MDX クエリの処理でパフォーマンスが低下する可能性があります。すべての値を選択する場合は、代わりにクエリ デザイナで MDX の All メンバ リストを選択します。

使用可能な値の一覧を作成する場合に <Blank> を有効値として許可するには、これを有効値の一覧に含める必要があります。

[NULL を許容] は、単一値パラメータで使用できるオプションです。複数の値を持つパラメータでは、この値を選択することはできません。[NULL を許容] を選択すると、パラメータに NULL 値を含めることができます。既定では、一部のクエリ言語で NULL 値が結果セットに返されることはありません。

レポート パラメータを定義する際には、レポートで使用できる値を定義する必要があります。これらの値は、使用できる値または有効な値と呼ばれます。使用できる値の一覧には、値とラベルを組み合わせたセットが格納されます。レポートが実行されると、ユーザーに対してラベルが表示されます。ユーザーが任意のラベルを選択すると、このラベルに対応する値がパラメータ値として使用されます。使用できる値は、静的一覧または式としてあらかじめ定義しておくことも、データセットから取得することもできます。

• 非クエリ型の一覧は、値とラベルの組の静的一覧です。この場合、一覧全体が、レポート パラメータの定義内に組み込まれます。各値とラベルは、静的な値を設定することも、式から生成することもできます。

• クエリ型の一覧では、レポートの実行時にレポート サーバーによってデータセットから値とラベルのセットが取得されます。クエリ型の使用できる値一覧を指定する場合は、データセット、値に使用するフィールド、およびラベルに使用するフィールドを選択します。

クエリ型の使用できる値一覧を指定する際には、レポート内のデータ領域からも使用される複雑なデータセットを使用するのではなく、パラメータ用の単純なデータセットを作成することをお勧めします。有効な値一覧とレポート内のデータ領域の両方に同じデータセットを使用した場合、有効な値一覧に予期しない結果が生成される可能性があります。

パラメータの既定値を定義することができます。レポートのすべてのパラメータに既定値がある場合は、ユーザーがレポートを開いたり、レポート デザイナでプレビューしたりすると、レポートが直ちに処理されます。少なくとも 1 つのパラメータで既定値が使用されていない場合は、ユーザーがすべてのパラメータ値を入力してレポートを実行しないと、レポートはデータを表示しません。

非クエリ型の値もクエリ型の値も既定値として使用できます。非クエリ型の既定値には、静的な値か式を使用します。クエリ型の既定値には、データセット内のフィールドを指す式を使用します。クエリが複数の行を返す場合は、返されたデータセットの最初の行の値が使用されます。

既定値を指定しないようにすることもできます。この場合は、表示名を指定する必要があります。

注意
複数の値を持つパラメータを使用している場合は、クエリが複数の行を返すと、すべての行が既定値として使用されます。