URL 内でレポート パラメーターを渡す
レポート パラメーターはレポート URL に含めることで SQL Server Reporting Services (SSRS) レポート サーバーに渡すことができます。 すべてのクエリ パラメーターには、対応するレポート パラメーターを指定できます。 クエリ パラメーターをレポートに渡すには、対応するレポート パラメーターを渡します。 詳細については、「リレーショナル クエリ デザイナーでのクエリの作成 (レポート ビルダーおよび SSRS)」を参照してください。
基本的なパラメーター構文
- レポート パラメーターでは大文字と小文字が区別されます。
- 特殊文字の場合:
- URL 文字列内の空白文字を、文字
%20
に置き換えます。 - URL のパラメーター部分にある空白文字はプラス記号
+
に置き換えられます。 - 文字列の任意の部分にあるセミコロンは、文字
%3A
で置き換えられます。
- URL 文字列内の空白文字を、文字
- 通常、ブラウザーは URL エンコードを自動的に処理するため、文字を手動でエンコードする必要はありません。
- SharePoint および
_vti_bin
HTTP プロキシ経由で要求をルーティングする Reporting Services プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にいくつかのコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。 プロキシ構文を含めない場合は、パラメーターの先頭にrp:
を付ける必要があります。
例
Note
SharePoint と SSRS の統合は、SQL Server 2016 以降では使用できません。
- URL 内でレポート パラメーターを設定します。
- 構文:
parameter=value
- 構文:
- レポートで定義されている 2 つのパラメーターを指定します。
- SSRS SharePoint モード サーバーの例:
https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl&ReportMonth=3&ReportYear=2008
- SSRS ネイティブ モード サーバーの例:
https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ReportMonth=3&ReportYear=2008
- SSRS SharePoint モード サーバーの例:
- パラメーターに null 値を渡します。
- 構文:
parameter:isnull=true
- 例:
SalesOrderNumber:isnull=true
- 構文:
- ブール値を渡します。 可能な値は、fales の場合は
0
、true の場合は1
となります。- 例:
https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ShowDetails=1
- 例:
- float 値を渡します。 サーバー ロケールに応じた小数点の記号を指定します。