URL 内でレポート パラメーターを渡す

レポート パラメーターはレポート URL に含めることでレポートに渡すことができます。 このような URL パラメーターにはプレフィックスを付けません。パラメーターはレポート処理エンジンに直接渡されるためです。

重要
SharePoint および Reporting Services HTTP プロキシ経由で要求をルーティングする _vti_bin プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にいくつかのコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。 プロキシ構文を含めない場合は、パラメーターの先頭に rp: を付ける必要があります。

すべてのクエリ パラメーターには、対応するレポート パラメーターを指定できます。 クエリ パラメーターをレポートに渡すには、対応するレポート パラメーターを渡します。 詳細については、「リレーショナル クエリ デザイナーでのクエリの作成 (レポート ビルダーおよび SSRS)」を参照してください。

重要
レポート パラメーターでは大文字と小文字が区別されます。

注
レポート パラメーターでは大文字と小文字が区別され、次の特殊文字が使用されます。 URL 文字列では、URL エンコード規格に基づいてすべての空白文字が文字列 "%20" に置き換えられます。 URL のパラメーター部分にある空白文字はプラス記号 (+) に置き換えられます。 文字列の任意の部分にあるセミコロンは文字列 "%3A" に置き換えられます"。 通常、適切な URL エンコードはブラウザーによって自動的に行われます。 これらの文字を手動でエンコードする必要はありません。

URL 内にレポート パラメーターを設定するには、次の構文を使用します。

parameter=value

たとえば、レポートで定義されている "ReportMonth" と "ReportYear" の 2 つのパラメーターを指定するには、ネイティブ モードのレポート サーバーで次の URL を使用します。

http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&ReportMonth=3&ReportYear=2008

たとえば、レポートで定義されている同じ 2 つのパラメーターを指定するには、SharePoint 統合モードのレポート サーバーで次の URL を使用します。 _vti_bin プロキシ構文に注意してください。

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl&ReportMonth=3&ReportYear=2008

パラメーターに NULL 値を渡すには、次の構文を使用します。

parameter:isnull=true

以下に例を示します。

SalesOrderNumber:isnull=true

注
既定値を持つレポート パラメーターがレポートに含まれており、Prompt プロパティの値が false である場合 (つまりレポート マネージャーで Prompt User プロパティが選択されていない場合)、URL 内でそのレポート パラメーターに値を渡すことはできません。 管理者はこの方法を使用して、エンド ユーザーが特定のレポート パラメーターの値を追加したり変更したりすることを禁止できます。

その他の例

次の URL の例には、空白や複数のパラメーターが含まれています。

• "SQL Server User Education Team" のフォルダー名には空白が含まれているため、各空白が "+" に置き換わります。

• "team project report" というレポート名には空白が含まれているため、各空白が "+" に置き換わります。

• 値 "xgroup" を指定した "teamgrouping2" および値 "ygroup" を指定した "teamgrouping1" という 2 つのパラメーターを渡します。

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup

次の URL の例には、複数の値を持つパラメーター OrderID が含まれています。 複数の値を持つパラメーターの形式では、値ごとにパラメーター名を繰り返します。

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup&OrderID=747&OrderID=787&OrderID=12

次の URL の例では、"7/1/2005 " という値を持つ単一のパラメーター SellStartDate を、ネイティブ モードのレポート サーバーに渡します。

http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005

関連項目

参照

URL アクセス パラメーター リファレンス

概念

URL アクセス (SSRS)