レポート ビルダーのページ分割されたレポート パラメーター

この記事では、ページ分割されたレポート パラメーターの一般的な使用方法、設定できるプロパティ、その他について説明します。 レポート パラメーターを使用すると、レポート データの制御、他のレポートとの関連付け、およびレポートの表示方法の変更が可能になります。 レポート パラメーターは、Report Builder と Report Designer で作成するページ分割されたレポートで使用できます。 また、SQL Server Mobile Report Publisher で作成するモバイル レポートでレポート パラメーターを使用することもできます。 詳細については、「ページ割り付けレポートのレポート パラメーターのコンセプト (Report Builder)」を参照してください。

レポートにパラメーターを追加する方法の詳細については、「チュートリアル: レポートへのパラメーターの追加 (Report Builder)」を参照してください。

パラメーターの一般的な用途

パラメーターの一般的な用途には以下が含まれます:

• カスタマイズ可能なインターフェイスで調整できるフィルターを使用してデータを制御します。 詳細については、「ページ分割およびモバイル レポート データの制御」を参照してください。
• メイン レポートをドリルスルー レポートに接続し、それぞれが特定の質問を解決します。 詳細については、「関連レポートを接続する」を参照してください。
• レンダリングを調整して、レポートのプレゼンテーションを変更します。 詳細については、「レポートのプレゼンテーションの変更」を参照してください。

改ページ調整されたレポート データおよびモバイル レポート データの制御

Report Builder と Report Designer には、データの種類に基づいてデータをフィルター処理するためのオプションが用意されています。

• 変数が含まれるデータセット クエリを記述して、データ ソース側で改ページ調整されたレポート データをフィルター処理する。

• 共有データセットのデータをフィルター処理する。 ページ割り付けレポートに共有データセットを追加する場合、クエリを変更することはできません。 レポート パラメーターを作成して、そのパラメーターへの参照を含むデータセット フィルターをレポートに追加することができます。

• SQL Server モバイル レポート内で共有データセットのデータをフィルター処理する。 詳細については、「 SQL Server Mobile Report Publisher を使用してモバイル レポートを作成する」をご覧ください。

• ユーザーが値を指定して改ページ調整されたレポートのデータをカスタマイズできるようにする (2 つのパラメーターを用意して売上データの開始日と終了日を指定できるようにするなど)。

関連レポートを接続する

パラメーターを使用してメイン レポートをドリルスルー レポート、サブレポート、およびリンク レポートに関連付けます。 一連のレポートをデザインするときは、特定の情報を得るために各レポートをデザインできます。 各レポートでは、関連する情報について、さまざまな表示形式や詳細レベルで情報を示すことができます。 相互に関連する一連のレポートを提供するには、対象となる各レポート上のデータのうち、関連性を持つデータに対して、パラメーターを作成します。 詳細については、「ページ割り付けレポートのドリルスルー レポート (Report Builder)」、「ページ割り付けレポートのサブレポート (Report Builder)」、および「リンク レポートを作成する」を参照してください。

複数のユーザー向けにパラメーター セットをカスタマイズする。 たとえば、売上レポートに基づく 2 つのリンク レポートをレポート サーバーに作成して、 1 つのリンク レポートでは、営業担当者に対して事前定義済みのパラメーター値が使用されます。 2 番目のリンク レポートでは、営業マネージャーに対して事前定義済みのパラメーター値が使用されます。 どちらのレポートも同じレポート定義を使用します。

レポートのプレゼンテーションの変更

レポート ビルダーには、プレゼンテーションを変更するために使用できるツールが用意されています。

• レポートのレンダリングをカスタマイズするには、URL 要求を使用してレポート サーバーにコマンドを送信します。 詳細については、「URL アクセス (SSRS)」および「URL 内でレポート パラメーターを渡す」を参照してください。

• レポートの外観をカスタマイズできるように、ユーザーに値を指定するオプションを指定できます。 (ブール型のパラメーターを用意して、テーブルの入れ子になった行グループを展開するか折りたたむかを指定できるようにするなど)。

• 式にパラメーターを含めることで、ユーザーがレポート データと外観をカスタマイズできるようにします。 詳細については、「ページ割り付けレポートのパラメーター コレクションの参照 (レポート ビルダー)」を参照してください。

パラメーターを指定してレポートを表示する

パラメーターを持つレポートを表示する場合、値を対話的に指定できるように、[パラメーター] ウィンドウに各パラメーターが表示されます。 次の画像は、@ReportMonth、@ReportYear、@EmployeeID、@ShowAll、@ExpandTableRows、@CategoryQuota および @SalesDate というパラメーターを持つレポートの [パラメーター] ウィンドウを示しています。

1. パラメーター ウィンドウ: 各パラメーターのプロンプトと既定値が [パラメーター] ウィンドウに表示されます。 パラメーターのレイアウトをカスタマイズできます。 詳細については、「レポートのパラメーター ペインをカスタマイズする (Report Builder)」をご覧ください。

2. @SalesDate パラメーター: パラメーター @SalesDate は 日付/時刻 データ型です。 テキスト ボックスの横に [日付を選択] プロンプトが表示されます。 日付を変更するには、テキスト ボックスに新しい日付を入力するか、カレンダー コントロールを使用します。

3. @ShowAll パラメーター: パラメーター @ShowAll は Boolean データ型です。 オプション ボタンを使用して、 True または Falseを指定します。

4. パラメーター エリアの表示/非表示の切り替えハンドル: レポート ビューアー ツール バーで、この矢印を選択すると、[パラメーター] ウィンドウの表示/非表示を切り替えることができます。

5. @CategoryQuota パラメーター: パラメーター @CategoryQuota は Float データ型であるため、数値が使用されます。 @CategoryQuota には、複数の値を設定できます。

6. レポートの表示: パラメーターの値を入力した後、[レポートの表示] を選択してレポートを実行します。 すべてのパラメーターに既定値が定義されている場合、レポートは最初に表示するときに自動的に実行されます。

パラメーターを作成する

レポート パラメーターは、いくつかの方法で作成できます:

• パラメーターを含む変数またはストアド プロシージャでデータセット クエリを使用します。 詳細については、「パラメーター付きのデータセット クエリまたはストアド プロシージャ」を参照してください。
• パラメーターを手動で作成します。 詳細については、「パラメーターを手動で作成する」を参照してください。
• パラメーターへの参照を含むレポート パーツを追加します。 詳細については、「パラメーター付きレポート パーツ」を参照してください。

パラメーターを持つデータセット クエリまたはストアド プロシージャ

変数を含むデータセット クエリまたは入力パラメーターを含むデータセットのストアド プロシージャを追加する。 データセット パラメーターは変数または入力パラメーターごとに作成され、レポート パラメーターはデータセット パラメーターごとに作成されます。

レポート ビルダーのこのイメージには、以下のものが示されています。

1. [レポート データ] ペインに表示されるレポート パラメーター。

2. パラメーターを持つデータセット。

3. [パラメーター] ペイン。

4. [データセットのプロパティ] ダイアログ ボックスに表示されているパラメーター。

データセットは、埋め込みデータセットまたは共有データセットにすることができます。 レポートに共有データセットを追加する場合、内部としてマークされているデータセット パラメーターはレポートでオーバーライドできません。 内部としてマークされていないデータセット パラメーターはオーバーライドできます。

詳細については、「データセットのクエリ」を参照してください。

パラメーターを手動で作成する

[レポート データ] ペインからパラメーターを手動で作成します。 レポート パラメーターを構成すると、ユーザーが値を対話的に入力してレポートの内容や外観をカスタマイズできるようにすることができます。 ユーザーが事前構成済みの値を変更できないように、レポート パラメーターを構成することもできます。

パラメーターを持つレポート パーツ

パラメーターへの参照、または変数を含む共有データセットへの参照を含むレポート パーツを追加する。

レポート パーツはレポート サーバーに保存され、他のユーザーが各自のレポートで使用できます。 レポート パーツとして保存したパラメーターは、レポート サーバーからは管理できません。 パラメーターは、レポート パーツ ギャラリー で検索できます。 追加した後は、レポートで構成できます。 詳細については、「レポート パーツ (レポート ビルダーおよび SSRS)」を参照してください。

パラメーター値

レポートのパラメーター値を選択するときに使用できるオプションを次に示します:

• ドロップダウン リストから 1 つのパラメーター値を選択する。

• ドロップダウン リストから複数のパラメーター値を選択する。

• 1 つのパラメーターのドロップダウン リストから値を選択する。この値は、別のパラメーターのドロップダウン リストで使用できる値を決定します。 これらの値はカスケード型パラメーターです。 カスケード型パラメーターを使用すると、何千ものパラメーター値を管理しやすい数まで連続的にフィルター処理することができます。

  詳細については、「カスケード型パラメーターのページ割り付けレポートへの追加 (Report Builder)」を参照してください。

• 既定値がすでにパラメーターに存在しているため、パラメーターを選択しなくてもレポートを実行できます。

レポート パラメーターのプロパティ

[レポートのプロパティ] ダイアログ ボックスを使用して、レポート パラメーターのプロパティを変更できます。 次の表に、各パラメーターに設定できるプロパティの概要を示します。

データセット クエリ

データセット クエリのデータをフィルター処理するには、結果セットに追加するか、結果セットから除外する値を指定して、取得データを制限する制限句を含めます。

データ ソースのクエリ デザイナーを使用すると、パラメーター化クエリの作成に役立ちます。

• Transact SQL クエリでは、さまざまなデータ ソースで、異なるパラメーターの構文がサポートされます。 サポートは、位置または名前によってクエリ内で識別されるパラメーターに応じて異なります。 詳細については、「レポート データセット (SSRS)」で特定の外部データ ソースの記事を参照してください。 リレーショナル クエリ デザイナーで、フィルターのパラメーター オプションを選択してパラメーター化クエリを作成する必要があります。 詳細については、「関係クエリ デザイナーのユーザー インターフェイス (Report Builder)」を参照してください。

• クエリ デザイナーで指定したフィルターに基づいてパラメーターを作成するかどうかを指定できます。 Microsoft SQL Server Analysis Services、SAP NetWeaver BI、Hyperion Essbase などの多次元データ ソースに基づくクエリの場合は、この仕様にすることができます。 詳細については、「クエリ デザイン ツール (SSRS)」に記載されている、データ拡張機能に対応するクエリ デザイナーの記事をご覧ください。

発行されたレポートのパラメーターの管理

レポートをデザインするときは、レポート パラメーターはレポート定義に保存されます。 レポートをパブリッシュするときは、レポート パラメーターはレポート定義とは別に保存され管理されます。

パブリッシュ済みのレポートには、次のツールを使用できます:

• レポート パラメーター プロパティ: レポート パラメーターの値を (レポート定義とは関係なく) レポート サーバー上で直接変更します。

• キャッシュされたレポート: レポートのキャッシュ計画を作成するには、各パラメーターに既定値が指定されている必要があります。 詳細については、「レポートのキャッシュ (SSRS)」を参照してください。

• キャッシュされた共有データセット: 共有データセットのキャッシュ計画を作成するには、各パラメーターに既定値が指定されている必要があります。 詳細については、「レポートのキャッシュ (SSRS)」を参照してください。

• リンクされたレポート: さまざまな対象ユーザーのためにデータをフィルター処理するパラメーター値が事前に設定されたリンク レポートを作成できます。 詳細については、「リンク レポートを作成する」を参照してください。

• レポートのサブスクリプション: データをフィルター処理してレポートをサブスクリプションで配信するためのパラメーター値を指定できます。 詳細については、「サブスクリプションと配信 (Reporting Services)」を参照してください。

• URL アクセス: レポートへの URL でパラメーター値を指定できます。 URL アクセスを使用して、レポートを実行したりパラメーター値を指定したりすることもできます。 詳しくは、「URL アクセス (SSRS)」をご覧ください。

レポート定義を再パブリッシュした場合には、パブリッシュ済みレポートのパラメーター プロパティは保持されます。 レポート定義が同じレポートとして再パブリッシュされ、パラメーター名およびデータ型が同じである場合、プロパティ設定は保持されます。 レポート定義でパラメーターを追加または削除する場合、発行されたレポート内でパラメーターのプロパティを変更する必要がある可能性があります。 または、既存のパラメーターのデータ型または名前を変更するために、プロパティの変更が必要になる場合があります。

パラメーターは変更できない場合もあります。 レポート パラメーターでデータセット クエリからの既定値が取得される場合、その値を発行されたレポートで変更できません。 また、レポート サーバーで変更することはできません。 実行時に使用される値は、クエリの実行時に決定されます。 式ベースのパラメーターを使用すると、式の評価時に決定されます。

レポート実行オプションは、パラメーターの処理方法に影響します。 スナップショットとして実行されるレポートは、クエリがパラメーターの既定値を含まない限り、クエリから派生したパラメーターを使用できません。

サブスクリプションのパラメーター

オンデマンドのレポートまたはスナップショットに対してサブスクリプションを定義し、サブスクリプションの処理中に使用するパラメーター値を指定できます。

• オンデマンド レポート: 要求時レポートでは、レポートに一覧表示された各パラメーターのパブリッシュされた値とは異なる、別のパラメーター値を指定できます。 たとえば、 期間 パラメーターを使用して、顧客に現在の日付、週、または月のサービス要求を返すサービスの呼び出しレポートを保持していると仮定します。 レポートの既定のパラメーター値が 今日に設定されている場合、サブスクリプションでは別のパラメーター値 ( 週 、 月など) を使用して、週単位または月単位の数値を含むレポートを生成できます。

• スナップショット: スナップショットでは、サブスクリプションはスナップショットに対して定義されているパラメーター値を使用する必要があります。 サブスクリプションを使用して、スナップショットに定義されているパラメーター値をオーバーライドすることはできません。 たとえば、レポート スナップショットとして実行される西地区の売上レポートをサブスクライブしていて、そのスナップショットに地域のパラメーター値として Western が指定されていると仮定します。 この場合、このレポートへのサブスクリプションを作成するには、サブスクリプションで Western パラメーター値を使用する必要があります。 パラメーターが無視されることを示すために、サブスクリプション ページのパラメーター フィールドは読み取り専用フィールドに設定されます。

• レポート実行オプションは、パラメーターの処理方法に影響します。 レポート スナップショットとして実行されるパラメーター化されたレポートでは、レポート スナップショットに定義されているパラメーター値が使用されます。 パラメーター値は、レポートの [パラメーター プロパティ] ページで定義されています。 スナップショットとして実行されるレポートは、クエリがパラメーターの既定値を含まない限り、クエリから派生したパラメーターを使用できません。

• サブスクリプションを定義した後にレポート スナップショットのパラメーター値が変わると、レポート サーバーでサブスクリプションが非アクティブ化されます。 サブスクリプションの非アクティブ化は、レポートが変更されたことを示します。 サブスクリプションをアクティブ化するには、サブスクリプションを開いてから保存します。

詳細については、「サブスクリプションと配信 (Reporting Services)」を参照してください。

パラメーターとデータの確保

秘密性の高い情報を含むパラメーター化されたレポートを配布する際には注意が必要です。 レポート パラメーターは簡単に別の値に置き換えることができるので、予想外の情報が公開される可能性があるためです。

従業員データや個人データに対してパラメーターを設定する代わりに、組み込みフィールド から UserID フィールドを含む式に基づいてデータを選択すると、セキュリティを強化できます。 UserID は、レポートを実行しているユーザーの ID を入手するための手段として利用できます。後は、その ID を使用して、ユーザー固有のデータを取得できます。

関連するコンテンツ

• チュートリアル: レポートへのパラメータの追加 (レポート ビルダー)

• ページ割り付けレポートのレポート パラメーターの概念 (Report Builder)

• SQL Server Reporting Services で利用可能なツール