Reporting Services でのパラメータを使用した作業

[アーティクル]
12/15/2008

更新 : 2006 年 7 月 17 日

Reporting Services では、パラメータを使用して、レポートで使用するデータの指定、関連するレポートの接続、レポートの表示方法の変更などを行います。レポートには、クエリパラメータとレポートパラメータの 2 種類のパラメータがあります。

変数を含むデータセットクエリを定義する場合、Reporting Services によって対応するクエリパラメータが作成されます。クエリパラメータを使用すると、データソースから取得するデータを、レポートに必要なデータのみに制限できます。
レポートツールバーに表示されるレポートパラメータを使用して、レポートの処理時に使用する値の選択や入力を行うことができます。レポートデザイナでは、レポートパラメータはクエリパラメータから自動的に作成されます。レポートビルダでは、フィルタ句でプロンプトを設定すると、レポートパラメータが作成されます。クエリパラメータに関連付けられていないレポートパラメータを定義することもできます。Parameters グローバルコレクションを使用して、式にレポートパラメータへの参照を含めることができます。レポート定義全体で式を使用して内容や表示方法を制御できるので、レポートパラメータを使用すると、レポートを効果的にカスタマイズできます。

パラメータの主な特徴と Reporting Services での使用方法の概要を次に示します。

レポートパラメータはレポートサーバーで処理されますが、クエリパラメータはデータソースサーバーで処理されます。
クエリパラメータの各値は、既定により、対応するレポートパラメータの値にマップされます。このため、レポートパラメータ用に選択した値をクエリに渡して、データソースから取得されるデータを制限できます。
表示方法の変更、データのフィルタ選択、並べ替えやグループ化の制御、テキストボックスのプロパティの変更を行うには、クエリパラメータに関連付けられていないレポートパラメータを使用します。この操作を行うには、パラメータを含む式を記述します。式は、レポートの処理時に、現在のパラメータ設定を使用して評価されます。このように、レポートパラメータを使用すると、式を指定してレポートのさまざまな特徴を制御できます。
レポートパラメータについて、単一値または複数値のどちらか、実行時に表示されるかどうか、静的またはクエリベースのどちらの有効な値の一覧を使用するか、既定値を使用するかどうか、NULL 値または空白の値を受け入れるかどうかなどを指定するプロパティを設定できます。複数値のパラメータには、複数の値を選択できます。
レポート内の他のパラメータの有効な値の一覧を定義するカスケード型パラメータを作成できます (特定の製品カテゴリを選択すると製品の一覧が決定されるなど)。
パラメータを使用して、親レポートをドリルスルーレポートや埋め込まれたサブレポートにリンクできます。
いったんレポートがパブリッシュされると、パブリッシュされたレポートのパラメータプロパティを、元のパラメータ定義とは別に管理できるようになります。デザイン時のレポートパラメータの構成によっては、パブリッシュされたレポートの多くのパラメータプロパティをレポートサーバー管理者が変更できます。詳細については、「パブリッシュ済みレポートのパラメータプロパティの設定」を参照してください。
パラメータをサブスクリプション内で設定できます。レポートをサブスクライブする各ユーザーは、サブスクリプションと共に格納され、かつサブスクリプションによって使用されるパラメータ値を指定することができます。詳細については、「サブスクリプションでのパラメータの設定」を参照してください。
パラメータは、URL アクセスによって設定できます。詳細については、「URL アクセスパラメータの使用」を参照してください。

セキュリティメモ :
String 型のパラメータが含まれるレポートでは、使用可能な値の一覧 (有効な値の一覧とも呼ばれる) を必ず使用してください。また、レポートを実行するすべてのユーザーに対して、レポート表示に必要な権限のみを与えてください。String 型のパラメータを定義する場合は、任意の値が許容されるテキストボックスが表示されます。使用可能な値の一覧を使用すると、入力できる値が制限されます。クエリパラメータにレポートパラメータが関連付けられている場合に、使用可能な値の一覧を使用しなければ、レポートユーザーはテキストボックスに SQL 構文を入力できるので、レポートとサーバーが SQL インジェクション攻撃を受ける危険性が生じます。さらに、ユーザーが新しい SQL ステートメントを実行するための十分な権限を持っている場合は、サーバーで予想外の結果が生じる可能性もあります。クエリパラメータと関連付けられていないレポートパラメータがあり、このパラメータ値がレポートに含まれていると、レポートユーザーが式の構文または URL をパラメータ値に入力して、このレポートを Excel または HTML に変換することも可能になります。別のユーザーがこのレポートを表示して、表示されたパラメータコンテンツをクリックすると、悪意のあるスクリプトまたはリンクが意図せず実行されてしまう可能性があります。悪意のあるスクリプトを誤って実行するリスクを軽減するためには、信頼されたソースのレポートしか開かないようにする必要があります。レポートの保護の詳細については、「レポートとリソースの保護」を参照してください。

String 型のパラメータが含まれるレポートでは、使用可能な値の一覧 (有効な値の一覧とも呼ばれる) を必ず使用してください。また、レポートを実行するすべてのユーザーに対して、レポート表示に必要な権限のみを与えてください。String 型のパラメータを定義する場合は、任意の値が許容されるテキストボックスが表示されます。使用可能な値の一覧を使用すると、入力できる値が制限されます。クエリパラメータにレポートパラメータが関連付けられている場合に、使用可能な値の一覧を使用しなければ、レポートユーザーはテキストボックスに SQL 構文を入力できるので、レポートとサーバーが SQL インジェクション攻撃を受ける危険性が生じます。さらに、ユーザーが新しい SQL ステートメントを実行するための十分な権限を持っている場合は、サーバーで予想外の結果が生じる可能性もあります。クエリパラメータと関連付けられていないレポートパラメータがあり、このパラメータ値がレポートに含まれていると、レポートユーザーが式の構文または URL をパラメータ値に入力して、このレポートを Excel または HTML に変換することも可能になります。別のユーザーがこのレポートを表示して、表示されたパラメータコンテンツをクリックすると、悪意のあるスクリプトまたはリンクが意図せず実行されてしまう可能性があります。悪意のあるスクリプトを誤って実行するリスクを軽減するためには、信頼されたソースのレポートしか開かないようにする必要があります。レポートの保護の詳細については、「レポートとリソースの保護」を参照してください。

このセクションの内容

パラメータを使用したレポートデータの制御
パラメータを使用してレポートのデータを制御する方法を説明します。

パラメータを使用したレポートの外観の制御
パラメータを使用して、表示設定、並べ替え順、フィルタ選択、色、テキストボックスのプロパティなど、レポートの外観を制御する方法を説明します。

パラメータを使用した他のレポートへの接続
パラメータを使用して、ドリルスルーレポート、サブレポート、リンクレポートをリンクする方法を説明します。

単一値および複数値パラメータの使用
単一値および複数値パラメータの使用方法を説明します。

レポートパラメータの作成とレポートパラメータプロパティの設定
レポートパラメータのプロパティを作成して設定する方法を説明します。

式におけるパラメータの使用
単一値および複数値パラメータの構文など、式にパラメータを含める方法を説明します。

参照

次の方法で共有

Reporting Services でのパラメータを使用した作業

このセクションの内容

参照

処理手順

概念

その他の技術情報

ヘルプおよび情報

その他のリソース