次の方法で共有


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=Collapsed

SharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Parameters False パラメーター領域を非表示にし、ユーザーはそれを表示できません。
Parameters Collapsed パラメーター領域を非表示にしますが、ユーザーはそれを表示するように切り替えることができます。

例:

ネイティブ モード: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Zoom Page Width ページ幅に合わせてレポートのズームを設定します。

例:

ネイティブ モード: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20Width

SharePoint モード: 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=2

SharePoint モード: 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-400

SharePoint モード: 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=listChildren

SharePoint モード:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren
Command Render レポートはブラウザーでレンダリングし、ユーザーに表示されます。

:

ネイティブ モード:https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

SharePoint モード: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=GetDataSourceContents

SharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents
Command GetResourceContents リソースをレンダリングし、リソースとブラウザーの互換性がある場合は、そのリソースを HTML ページ内に表示します。 それ以外の場合は、ファイルまたはリソースを開くか、ディスクに保存するかを選択できます。

:

ネイティブ モード: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

SharePoint モード: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
Command GetComponentDefinition 公開済みレポート アイテムに関連付けられた XML 定義を表示します。 この値を使用するには、パブリッシュ済みレポート アイテムに対する Read Contents 権限が必要です。
Format HTML5
PPTX
ATOM
HTML4.0
MHTML
IMAGE
EXCEL (.xlsの場合)
EXCELOPENXML (.xlsxの場合)
WORD (.docの場合)
WORDOPENXML (.docxの場合)
CSV
PDF
XML
レポートをレンダリングし、表示する形式を指定します。 既定値は 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-usde-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 true
false
1 つの永続化ストリームでレポートをレンダリングします。 画像レンダラーは、このパラメーターを使用して、表示レポートを一度に1チャンクずつ送信します。 URL アクセス文字列でこのパラメーターを使用した後、同じ URL アクセス文字列を、GetNextStream パラメーターではなく PersistStreams パラメーターと共に使用すると、永続化ストリームの次のチャンクを取得できます。 この URL コマンドは、最終的に永続化ストリームの末尾に到達した時点で 0 バイト ストリームを返します。 既定値は false です。
GetNextStream true
false
PersistStreams パラメーターを使用してアクセスした永続化ストリームの次のデータ チャンクを取得します。 詳細については、PersistStreams コマンドの説明を参照してください。 既定値は false です。
SessionID クライアント アプリケーションとレポート サーバー間で確立されたアクティブ レポート セッションを指定します。 このパラメーターの値は、セッション ID に設定されます。

セッション ID をクッキーまたは URL の一部として指定できます。 セッション クッキーを使用しないようにレポート サーバーを構成している場合、指定したセッション ID なしの最初の要求はセッション ID 付きでリダイレクトされます。 レポート サーバーのセッションの詳細については、「実行状態の識別」を参照してください。
ClearSession true
false
認証されているユーザーに関連付けられたすべてのレポート インスタンスがレポート セッションから削除されます。 レポート インスタンスは、別のレポート パラメーターの値を指定して、レポートを複数回実行するように定義されます。 既定値は false です。 有効値は true および falseです。
ResetSession true
false
レポート セッションのすべてのレポート スナップショットとの関連付けを削除することによって、レポート セッションをリセットします。 既定値は 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 true
false
レポートが非同期に表示されるかどうかを制御します。 既定値は 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