URL アクセス パラメーター リファレンス
パラメーターを URL の一部として使用すると、SQL Server 2016 (13.x) Reporting Services 以降 (SSRS) のレポートの外観を構成できます。 この記事では、最もよく使用されるパラメーターについて説明します。
パラメーターの大文字と小文字は区別されません。 プレフィックスが必要です:
rs:: レポート サーバーを対象とします。rc:: HTML ビューアーを対象とします。rv:: Report Viewer Web パーツを対象とします。
デバイスや表示拡張機能に固有のパラメーターを指定することもできます。 デバイスに固有のパラメーターの詳細については、「URL でデバイス情報設定を指定する」を参照してください。
重要
SharePoint モード レポート サーバーの場合、SharePoint および Reporting Services HTTP プロキシ経由で要求をルーティングする _vti_bin プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。 例については、「URL アクセスを使用したレポートサーバーアイテムへのアクセス」を参照してください。
SharePoint と Reporting Services の統合は、SQL Server 2016 以降では使用できません。
HTML ビューアー コマンド (rc:)
プレフィックス rc: を使用して HTML ビューアーをターゲットにします。
| command | パラメーター | 説明 |
|---|---|---|
Toolbar |
True |
ツール バーを表示します。 既定値は true です。 注: このパラメーターを省略すると、サポートされている表示形式でツール バーが自動的に表示されます。 |
Toolbar |
False |
ツール バーを非表示にします。 このパラメーターが false の場合、残りのオプションすべてが無視されます。 |
Toolbar |
Navigation |
ツール バーに改ページのみを表示します。 |
Parameters |
True |
ツール バーのパラメーター領域を表示します。 既定値は true です。 例: ネイティブ モード: https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Parameters |
False |
パラメーター領域を非表示にし、ユーザーはそれを表示できません。 |
Parameters |
Collapsed |
パラメーター領域を非表示にしますが、ユーザーはそれを表示するように切り替えることができます。 例: ネイティブ モード: https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Zoom |
Page Width |
ページ幅に合わせてレポートのズームを設定します。 例: ネイティブ モード: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20WidthSharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width |
Zoom |
Whole Page |
ページ全体に合わせてレポートのズームを設定します。 |
Zoom |
<integer percentage> |
レポートのズームを特定のパーセンテージに設定します。 既定値は 100 です。 |
Section |
<page number> |
表示するレポートのページを設定します。 レポートのページ数よりも大きい値を設定すると、最後のページが表示されます。 0 よりも小さい値を設定すると、レポートの 1 ページが表示されます。 既定値は 1です。 例: ネイティブ モード: https://myrshost/reportserver?/Sales&rc:Section=2SharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2 |
FindString |
<text> |
レポートから特定のテキストを検索し、そのテキストを強調表示します。 注: URL アクセス文字列に rc:Toolbar=false を含めない限り、rc:FindString は機能しません。例: ネイティブ モード: https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400SharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400 |
StartFind |
<start page> |
検索する最初のセクションを指定します。 既定値はレポートの最初のページです。 例: ネイティブ モード: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
EndFind |
<end page> |
検索に使用する最終ページの番号を設定します。 既定値は現在のページ番号です。 このパラメーターは StartFind パラメーターと一緒に使用します。例: StartFind の例を参照してください。 |
FallbackPage |
<page number> |
検索または見出しマップの選択が失敗した場合に表示するページ番号を設定します。 既定値は現在のページ番号です。 |
GetImage |
<icon name> |
HTML ビューアー ユーザー インターフェイス用の特定の画像を取得します。 |
Icon |
<icon name> |
特定の表示拡張機能のアイコンを取得します。 |
Stylesheet |
<stylesheet file name> |
HTML ビューアーに適用するスタイル シートを指定します。 |
| デバイス情報設定 | rc:tag=value の形式でデバイス情報設定を指定します。この tag は、現在使用されている表示拡張機能に固有のデバイス情報設定の名前です 詳細については、Format コマンドの説明を参照してください。IMAGE 表示拡張機能の OutputFormat デバイス情報設定を使用すると、URL アクセス文字列に ...&rs:Format=IMAGE&rc:OutputFormat=JPEG パラメーターを指定することで、レポートを JPEG 画像で表示できます。 拡張機能に固有のすべてのデバイス情報設定の詳細については、「表示拡張機能のデバイス情報設定 (Reporting Services)」を参照してください。 |
レポート サーバー コマンド (rs:)
プレフィックス rs: を使用してレポート サーバーをターゲットにします。
| command | パラメーター | 説明 |
|---|---|---|
Command |
ListChildren および GetChildren |
フォルダーの内容が表示されます。 フォルダー アイテムは、汎用アイテム ナビゲーション ページに表示されます。 例: ネイティブ モード: https://myrshost/reportserver?/Sales&rs:Command=GetChildrenネイティブ モードの名前付きインスタンス: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildrenSharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren |
Command |
Render |
レポートはブラウザーでレンダリングし、ユーザーに表示されます。 例: ネイティブ モード: https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderSharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
Command |
GetSharedDatasetDefinition |
共有データセットに関連付けられた XML 定義を表示します。 共有データセットのプロパティが定義に保存されます。 これらのプロパティには、クエリ、データセット パラメーター、既定値、データセット フィルター、照合順序や大文字小文字の区別などのデータ オプションが含まれます。 この値を使用するには、共有データセットに対する Read Report Definition 権限が必要です。 例: ネイティブ モード: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
Command |
GetDataSourceContents |
指定した共有データ ソースのプロパティを XML 形式で表示します。 ブラウザーで XML がサポートされていて、目的のデータ ソースに対して Read Contents 権限が与えられている認証ユーザーである場合は、そのデータ ソース定義が表示されます。 例: ネイティブ モード: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContentsSharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents |
Command |
GetResourceContents |
リソースをレンダリングし、リソースとブラウザーの互換性がある場合は、そのリソースを HTML ページ内に表示します。 それ以外の場合は、ファイルまたはリソースを開くか、ディスクに保存するかを選択できます。 例: ネイティブ モード: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsSharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
Command |
GetComponentDefinition |
公開済みレポート アイテムに関連付けられた XML 定義を表示します。 この値を使用するには、パブリッシュ済みレポート アイテムに対する Read Contents 権限が必要です。 |
Format |
HTML5PPTXATOMHTML4.0MHTMLIMAGEEXCEL (.xlsの場合)EXCELOPENXML (.xlsxの場合)WORD (.docの場合)WORDOPENXML (.docxの場合)CSVPDFXML |
レポートをレンダリングし、表示する形式を指定します。 既定値は HTML5です。 詳細については、「URL アクセスを使用してレポートをエクスポートする」を参照してください。 完全な一覧が必要な場合、レポート サーバー rsreportserver.config ファイルの \<Render> 拡張セクションを参照してください。 詳細については、「RsReportServer.config 構成ファイル」を参照してください。 例: ネイティブ モード: https://myrshost/ReportServer?/myreport&rs:Format=PDF SharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
ParameterLanguage |
en-us、de-DE などです。 |
ブラウザーの言語とは関係なく、URL で渡されるパラメーターの言語を指定します。 既定値は、ブラウザーの言語です。 例: ネイティブ モード: https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE |
Snapshot |
レポート履歴スナップショットに基づいたレポートをレンダリングします。 詳細については、「URL アクセスを使用してレポート履歴スナップショットを表示する」を参照してください。 例: ネイティブ モード: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02 |
|
PersistStreams |
truefalse |
1 つの永続化ストリームでレポートをレンダリングします。 画像レンダラーは、このパラメーターを使用して、表示レポートを一度に1チャンクずつ送信します。 URL アクセス文字列でこのパラメーターを使用した後、同じ URL アクセス文字列を、GetNextStream パラメーターではなく PersistStreams パラメーターと共に使用すると、永続化ストリームの次のチャンクを取得できます。 この URL コマンドは、最終的に永続化ストリームの末尾に到達した時点で 0 バイト ストリームを返します。 既定値は false です。 |
GetNextStream |
truefalse |
PersistStreams パラメーターを使用してアクセスした永続化ストリームの次のデータ チャンクを取得します。 詳細については、PersistStreams コマンドの説明を参照してください。 既定値は false です。 |
SessionID |
クライアント アプリケーションとレポート サーバー間で確立されたアクティブ レポート セッションを指定します。 このパラメーターの値は、セッション ID に設定されます。 セッション ID をクッキーまたは URL の一部として指定できます。 セッション クッキーを使用しないようにレポート サーバーを構成している場合、指定したセッション ID なしの最初の要求はセッション ID 付きでリダイレクトされます。 レポート サーバーのセッションの詳細については、「実行状態の識別」を参照してください。 |
|
ClearSession |
truefalse |
認証されているユーザーに関連付けられたすべてのレポート インスタンスがレポート セッションから削除されます。 レポート インスタンスは、別のレポート パラメーターの値を指定して、レポートを複数回実行するように定義されます。 既定値は false です。 有効値は true および falseです。 |
ResetSession |
truefalse |
レポート セッションのすべてのレポート スナップショットとの関連付けを削除することによって、レポート セッションをリセットします。 既定値は false です。 有効値は true および falseです。 |
ShowHideToggle |
<positive integer> |
レポートのセクションの表示と非表示を切り替えます。 切り替えるセクションを表す正の整数を指定します。 |
レポート ビューアー Web パーツのコマンド (rv:)
プレフィックス rv: を使用して SharePoint と統合する Report Viewer Web パーツをターゲットにします。 Report Viewer Web パーツでは、rs:ParameterLanguage パラメーターも受け取られます。
| command | パラメーター | 説明 |
|---|---|---|
Toolbar |
Full |
ツール バーを完全に表示します。 既定値は Fullです。 |
Toolbar |
Navigation |
ツール バーに改ページのみを表示します。 例: SharePoint モード: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
Toolbar |
None |
ツール バーを表示しません。 |
HeaderArea |
Full |
ヘッダーを完全に表示します。 既定値は Fullです。 |
HeaderArea |
BreadCrumbsOnly |
ヘッダーに階層リンクのナビゲーションのみを表示して、アプリケーションでの現在位置をユーザーに示します。 例: SharePoint モード: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
HeaderArea |
None |
ヘッダーを非表示にします。 |
DocMapAreaWidth |
Report Viewer Web パーツのパラメーター領域の表示幅をピクセル単位で制御します。 既定値は、レポート ビューアー Web パーツの既定値と同じです。 値には、負以外の整数値を指定する必要があります。 | |
AsyncRender |
truefalse |
レポートが非同期に表示されるかどうかを制御します。 既定値は trueで、レポートが非同期に表示されることを示します。 この値には、 true または falseのブール値を指定する必要があります。 |
ParamMode |
Full |
パラメーター プロンプト領域を表示します。 既定値は Fullです。 |
Collapsed |
パラメーター プロンプト領域を折りたたみます。 例: SharePoint モード: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
|
ParamMode |
Hidden |
パラメーター プロンプト領域を非表示にします。 |
DocMapMode |
Full |
ドキュメント マップ領域を表示します。 既定値は Fullです。 |
DocMapMode |
Collapsed |
ドキュメント マップ領域を折りたたみます。 |
DocMapMode |
Hidden |
ドキュメント マップ領域を非表示にします。 |
DockToolBar |
Top |
上にあるツール バーにドッキングします。 既定値は Topです。 |
DockToolBar |
Bottom |
下にあるツール バーにドッキングします。 例: SharePoint モード: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
ToolBarItemsDisplayMode |
1 (0x1) |
[戻る] ボタン |
ToolBarItemsDisplayMode |
2 (0x2) |
テキスト検索コントロール |
ToolBarItemsDisplayMode |
4 (0x4) |
ページ ナビゲーション コントロール |
ToolBarItemsDisplayMode |
8 (0x8) |
[更新] ボタン |
ToolBarItemsDisplayMode |
16 (0x10) |
[ズーム] リスト ボックス |
ToolBarItemsDisplayMode |
32 (0x20) |
[Atom フィード] ボタン |
ToolBarItemsDisplayMode |
64 (0x40) |
[アクション] の [印刷] メニュー オプション |
ToolBarItemsDisplayMode |
128 (0x80) |
[アクション] の [エクスポート] サブメニュー |
ToolBarItemsDisplayMode |
256 (0x100) |
[アクション] の [Report Builder で開く] メニュー オプション |
ToolBarItemsDisplayMode |
512 (0x200) |
[アクション] の [サブスクライブ] メニュー オプション |
ToolBarItemsDisplayMode |
1024 (0x400) |
[アクション] の [新しいデータの警告] メニュー オプション |
ToolBarItemsDisplayMode |
複数値 | 表示するツール バー項目を制御します。 この値はビットごとの列挙値です。 ツール バー項目を含めるには、項目の値を合計値に加算します。 たとえば、[アクション] メニューなしにする場合は、rv:ToolBarItemsDisplayMode=63 (または 0x3F) を使用します。これは、1 + 2 + 4 + 8 + 16 + 32 です。 アクション メニュー項目の場合のみ、rv:ToolBarItemsDisplayMode=960 (または0x3C0) を使用します。 既定値は -1です。すべてのツール バー項目を表示します。 有効な値は次のとおりです。例: SharePoint モード: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |