次の方法で共有

  • [アーティクル]

パラメーター化されたレポートの実行

パラメーター化されたレポートは、入力値を使用してレポート処理を完了するレポートです。パラメーター化されたレポートの一般的な例としては、地域の値や製品カテゴリ、識別子でフィルター処理を行うレポートなどが挙げられます。パラメーターは、通常、レポートに使用されるデータを選択するクエリを完了するために使用されます。パラメーター化されたレポートを管理または実行する場合は、パラメーターの選択により、作業対象のレポートにどのような影響が出るかを理解しておく必要があります。

注意注

レポートで使用されるパラメーターは、レポートの作成者によって定義されます。レポートのパブリッシュ後は、ユーザーがいくつかのパラメーター プロパティを変更して、使用される値や値の取得方法を変更できます。パラメーターの作成の詳細については、「パラメーター (レポート ビルダー 3.0 および SSRS)」を参照してください。パラメーターの管理の詳細については、「パブリッシュ済みレポートのパラメーター プロパティの設定」を参照してください。

パラメーター値の保存および要求

実行時にパラメーター値を取得するには、レポートと一緒に既定値を保存するか、ユーザーに値の入力または選択を要求します。常に特定の値でレポートを処理する場合は、パラメーター値をレポートと一緒に保存すると便利です。たとえば、ある地域の支社に専用の Web サイトがある場合、常に特定の地域コードを使用するこの Web サイト上で、地域の売上レポートをホストすることができます。

また、レポートを開く際に、ユーザーに値を入力または選択するように要求することもできます。パラメーター値を要求するレポートを構成する場合は、ユーザーが特定の値を入力できるように入力フィールドが表示されます。ユーザーは、値を入力したら、[レポートの表示] をクリックしてレポートを実行します。値が有効な場合は、レポートが表示されます。値が有効でない場合は、エラー メッセージか空のレポートが返されます。保存されているパラメーター値を使用する場合は、入力フィールドや [レポートの表示] ボタンが表示されることなく、レポートが開きます。この場合、レポートを実行するユーザーはすべて、同じパラメーター値を使用します。

レポートにクエリ ベースのパラメーターが含まれていて、各ユーザーがデータ ソースにログオンする必要がある場合は、ページにパラメーターの入力フィールドが表示される前に、資格情報の入力が求められます。この場合は、資格情報を入力しないと、パラメーター値を取得できません。

パラメーター化されたレポートを実行するには、通常、入力する値を知っている必要があります。場合によっては、レポートに選択可能な有効値のドロップダウン リストが実装されています。

パブリッシュされたレポートのパラメーター プロパティ (既定値を含む) を設定するには、レポート マネージャーを使用します。詳細については、「パラメーター (レポート ビルダー 3.0 および SSRS)」および「サブスクリプションでのパラメータの設定」を参照してください。

レポートの URL でのパラメーターの設定

パラメーター化されたレポートを実行するもう 1 つの方法は、URL を利用することです。エンコードされた名前と値の組に 1 つ以上のパラメーターを指定できます。この場合、アンパサンド (&) を使用してパラメーターを区別します。

NULL パラメーターの構文は特殊で、NULL 値に isnull を指定する必要があります。パラメーターに NULL 値を指定すると、そのパラメーターに指定された他のすべての値が無視されます。次の例は、NULL および定数値を示す複数のパラメーターを表しています。

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder&region=west&sales:isnull=true

複数の値が使用されるパラメーターは、次のようにパラメーター名を繰り返して指定します。次に例を示します。

http://exampleWebServerName/reportserver?/foldercontainingreports/orders&region=east&region=west

Boolean パラメーターには、値 0 または 1 が指定されます。

Float パラメーターには、サーバー ロケールに応じた小数点の記号を指定する必要があります。

DateTime パラメーターは、YYYY-MM-DDTHH:MM:SS 形式で指定する必要があります。これは、国際標準化機構 (ISO) 8601 標準に基づいた形式です。URL でのパラメーターの設定の詳細については、「URL アクセス パラメーターの使用」を参照してください。