レポートのパラメーターをレポート URL に含めることで、レポートに渡すことができます。 これらの URL パラメーターは、レポート処理エンジンに直接渡されるため、プレフィックスは付けされません。
重要
SharePoint および _vti_bin HTTP プロキシ経由で要求をルーティングする Reporting Services プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にいくつかのコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。
プロキシ構文を含めない場合は、パラメーターの前に rp: を付ける必要があります。
すべてのクエリ パラメーターには、対応するレポート パラメーターを指定できます。 クエリ パラメーターをレポートに渡すには、対応するレポート パラメーターを渡します。 詳細については、「 リレーショナル クエリ デザイナーでのクエリの作成 (レポート ビルダーおよび SSRS)」を参照してください。
重要
レポート パラメーターでは大文字と小文字が区別されます。
注
レポート パラメーターでは大文字と小文字が区別され、次の特殊文字を使用します。
- URL 文字列内のすべての空白文字は、URL エンコード標準に従って文字 "%20" に置き換えられます。
- URL のパラメーター部分の空白文字は、プラス文字 (+) に置き換えられます。
- 文字列の任意の部分のセミコロンは、"%3A." という文字に置き換えられます。
- ブラウザーでは、適切な URL エンコードが自動的に実行されます。 文字を手動でエンコードする必要はありません。
URL 内でレポート パラメーターを設定するには、次の構文を使用します。
parameter=value
たとえば、レポートで定義されている 2 つのパラメーター "ReportMonth" と "ReportYear" を指定するには、ネイティブ モードのレポート サーバーに次の 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
Boolean値を渡すには、false に 0、true に 1 を使用します。
Float値を渡すには、サーバー ロケールの小数点区切り記号を含めます。
注
レポートに既定値を持つレポート パラメーターが含まれており、 Prompt プロパティの値が false されている場合 (つまり、レポート マネージャーで Prompt User プロパティが選択されていません)、URL 内でそのレポート パラメーターの値を渡すことはできません。 これにより、管理者は、エンド ユーザーが特定のレポート パラメーターの値を追加または変更できないようにすることができます。
その他の例
次の URL の例には、スペースと複数のパラメーターが含まれています
"SQL Server ユーザー教育チーム" のフォルダー名にはスペースが含まれているため、各スペースは "+" に置き換えられます。
"チーム プロジェクト レポート" のレポート名にはスペースが含まれているため、"+" は各スペースを置き換えます。
値が "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