URL アクセス パラメーター リファレンス
次のパラメーターを URL の一部として使用すると、SQL Server 2016 (13.x) Reporting Services 以降 (SSRS) のレポートのルック アンド フィールを構成できます。 ここでは、最も一般的なパラメーターについて説明します。 パラメーターは大文字と小文字が区別されます。レポート サーバーに出力する場合は rs: 、HTML ビューアーに出力する場合は rc: をパラメーターの先頭に追加します。 デバイスや表示拡張機能に固有のパラメーターを指定することもできます。 デバイスに固有のパラメーターの詳細については、「URL でデバイス情報設定を指定する」を参照してください。
重要
SharePoint モード レポート サーバーの場合、SharePoint および Reporting Services HTTP プロキシ経由で要求をルーティングする _vti_bin プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。 例については、「URL アクセスを使用したレポートサーバーアイテムへのアクセス」を参照してください。
SharePoint と Reporting Services の統合は、SQL Server 2016 以降では使用できません。
HTML ビューアー コマンド (rc:)
HTML ビューアー コマンドは HTML ビューアーを対象として使用され、接頭辞として rc: が付きます。
Toolbar:ツール バーの表示と非表示を切り替えます。 このパラメーターの値が falseの場合、残りのオプションすべてが無視されます。 このパラメーターを省略すると、サポートされている表示形式でツール バーが自動的に表示されます。 このパラメーターの既定値は trueです。
重要
rc:Toolbar=false は、SharePoint サイト上でホストされているレポートを対象とするために (ドメイン名ではなく) IP アドレスを使用する URL アクセス文字列に対しては機能しません。
パラメーター: ツール バーのパラメーター領域の表示と非表示を切り替えます。 このパラメーターを trueに設定すると、ツール バーのパラメーター領域が表示されます。 このパラメーターを false に設定すると、パラメーター領域は表示されません。ユーザーが表示することもできません。 このパラメーターの値を Collapsed に設定すると、パラメーター領域は表示されませんが、ユーザーが表示と非表示を切り替えることができます。 このパラメーターの既定値は trueです。
ネイティブ モードの例:
https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint モードの例:
https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=CollapsedZoom: レポート ズーム値を整数のパーセンテージまたは文字列定数として設定します。 標準的な文字列値には Page Width と Whole Pageなどがあります。 Internet Explorer 5.0 より前のバージョンの Internet Explorer および Microsoft 以外のすべてのブラウザーでは、このパラメーターが無視されます。 このパラメーターの既定値は 100です。
ネイティブ モードの例:
https://myrshost/reportserver?/Sales&rc:Zoom=Page WidthSharePoint モードの例:
https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page WidthSection: 表示するレポートのページを設定します。 レポートのページ数よりも大きい値を設定すると、最後のページが表示されます。 0 よりも小さい値を設定すると、レポートの 1 ページが表示されます。 このパラメーターの既定値は 1です。
ネイティブ モードで、レポートの 2 ページ目を表示する例:
https://myrshost/reportserver?/Sales&rc:Section=2SharePoint モードで、レポートの 2 ページ目を表示する例:
https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2FindString:レポートの中から特定のテキスト セットを検索し、そのテキストを強調表示します。
重要
rc:FindString は、rc:Toolbar=false を URL アクセス文字列に含めない限り、機能しません。
ネイティブ モードの例:
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-400StartFind: 検索する最後のセクションを指定します。 このパラメーターの既定値は、レポートの最終ページです。
Product Catalog サンプル レポートの 1 - 5 ページを検索し、最初に出現する "Mountain-400" という文字列を探す、ネイティブ モードの例。
https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400EndFind: 検索に使用する最終ページの番号を設定します。 たとえば、 5 の値は、検索する最後のページがレポートの 5 ページであることを示します。 既定値は現在のページ番号です。 このパラメーターは、StartFind パラメーターと一緒に使用します。 前の例を参照してください。
FallbackPage: 検索またはドキュメント マップの選択が失敗した場合に表示するページ番号を設定します。 既定値は現在のページ番号です。
GetImage: HTML ビューアー ユーザー インターフェイス用の特定のアイコンを取得します。
Icon: 特定の表示拡張機能のアイコンを取得します。
Stylesheet:HTML ビューアーに適用するスタイル シートを指定します。
デバイス情報設定:
rc:tag=valueの形式でデバイス情報設定を指定します。この tag は、現在使用されている表示拡張機能に固有のデバイス情報設定の名前です (Format パラメーターの説明を参照してください)。たとえば、IMAGE 表示拡張機能の OutputFormat デバイス情報設定を使用すると、URL アクセス文字列に...&rs:Format=IMAGE&rc:OutputFormat=JPEGパラメーターを指定することで、レポートを JPEG 画像で表示できます。 拡張機能に固有のすべてのデバイス情報設定の詳細については、「表示拡張機能のデバイス情報設定 (Reporting Services)」を参照してください。
レポート サーバー コマンド (rs:)
レポート サーバー コマンドには接頭辞として rs: が付き、レポート サーバーを対象として使用されます。
コマンド:アイテムの種類に応じて、カタログ アイテムに対して操作を実行します。 既定値は、URL アクセス文字列で参照されるカタログ アイテムの種類で決まります。 有効な値は次のとおりです。
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=GetChildrenRender: レポートはブラウザーでレンダリングされ、ユーザーに表示されます。
ネイティブ モードの例:
https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderSharePoint モードの例:
https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=RenderGetSharedDatasetDefinition: 共有データセットに関連付けられた XML 定義を表示します。 クエリ、データセット パラメーター、既定値、データセット フィルター、照合順序や大文字と小文字の区別などのデータ オプションを含む共有データセット プロパティは、定義内に保存されます。 この値を使用するには、共有データセットに対する Read Report Definition 権限が必要です。
ネイティブ モードの例:
https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinitionGetDataSourceContents: 指定した共有データ ソースのプロパティを 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=GetDataSourceContentsGetResourceContents: リソースを表示し、リソースとブラウザーの互換性がある場合は、そのリソースを HTML ページ内に表示します。 それ以外の場合は、ファイルまたはリソースを開くか、ディスクに保存するように求められます。
ネイティブ モードの例:
https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsSharePoint モードの例:
https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContentsGetComponentDefinition: パブリッシュ済みレポート アイテムに関連付けられた 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 構成ファイル」を参照してください。
たとえば、ネイティブ モードのレポート サーバーから直接レポートの PDF コピーを取得するには、次の URL を使用します。
https://myrshost/ReportServer?/myreport&rs:Format=PDFSharePoint モード レポート サーバーからレポートの PDF コピーを直接取得する例:
https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDFParameterLanguage:ブラウザーの言語とは関係なく、URL で渡されるパラメーターの言語を指定します。 既定値は、ブラウザーの言語です。 値は、 en-us や de-deなどのカルチャ値に設定できます。
ネイティブ モードで、ブラウザーの言語をオーバーライドし、de-DE というカルチャ値を指定する例:
https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DEスナップショット:レポート履歴スナップショットに基づいたレポートを表示します。 詳細については、「URL アクセスを使用してレポート履歴スナップショットを表示する」を参照してください。
ネイティブ モードで、日付が 2003-04-07 でタイムスタンプが 13:40:02 のレポート履歴スナップショットを取得する例:
https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02PersistStreams:1 つの永続化ストリームでレポートを表示します。 このパラメーターは、表示レポートをチャンク単位で送信するために画像レンダラーによって使用されます。 URL アクセス文字列でこのパラメーターを使用した後、同じ URL アクセス文字列を、 GetNextStream パラメーターではなく PersistStreams パラメーターと共に使用すると、永続化ストリームの次のチャンクを取得できます。 この URL コマンドは、最終的に永続化ストリームの末尾に到達した時点で 0 バイト ストリームを返します。 既定値は false です。
GetNextStream:PersistStreams パラメーターを使用してアクセスした永続化ストリームの次のデータ チャンクを取得します。 詳細については、 PersistStreamsの説明を参照してください。 既定値は false です。
SessionID:クライアント アプリケーションとレポート サーバー間で確立されたアクティブ レポート セッションを指定します。 このパラメーターの値は、セッション ID に設定されます。
セッション ID をクッキーまたは URL の一部として指定できます。 セッション クッキーを使用しないようにレポート サーバーを構成している場合、指定したセッション ID なしの最初の要求はセッション ID 付きでリダイレクトされます。 レポート サーバーのセッションの詳細については、「実行状態の識別」を参照してください。
ClearSession:値が true の場合は、レポート セッションからレポートを削除するようにレポート サーバーに指示します。 認証されているユーザーに関連付けられたすべてのレポート インスタンスがレポート セッションから削除されます (レポート インスタンスは、別のレポート パラメーターの値を指定して、レポートを複数回実行するように定義されます)。既定値は false です。
true: 値が ResetSession の場合は、レポート セッションのすべてのレポート スナップショットとの関連付けを削除することによって、レポート セッションをリセットするようレポート サーバーに指示します。 既定値は false です。
ShowHideToggle:レポートのセクションの表示と非表示を切り替えます。 切り替えるセクションを表す正の整数を指定します。
レポート ビューアー Web パーツのコマンド (rv:)
次の SQL Server レポート パラメーター名は予約されており、SharePoint と統合されているレポート ビューアー Web パーツを対象とするために使用されます。 これらのパラメーター名の先頭には rv: が付いています。 レポート ビューアー Web パーツでは、rs:ParameterLanguage パラメーターも受け取られます。
Toolbar:レポート ビューアー Web パーツのツール バーの表示を制御します。 既定値は Fullです。 可能な値は次のとおりです。
Full:ツール バーを完全に表示します。
ナビゲーション: ツール バーに改ページのみを表示します。
None:ツール バーを表示しません。
SharePoint モードで、ツール バーに改ページのみを表示する例:
https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=NavigationHeaderArea:レポート ビューアー Web パーツのヘッダーの表示を制御します。 既定値は Fullです。 可能な値は次のとおりです。
Full:ヘッダーを完全に表示します。
BreadCrumbsOnly: ヘッダーに階層リンクのナビゲーションのみを表示して、アプリケーションでの現在位置をユーザーに示します。
None:ヘッダーを表示しません。
SharePoint モードで、ヘッダーに階層リンクのナビゲーションのみを表示する例:
https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnlyDocMapAreaWidth:レポート ビューアー Web パーツのパラメーター領域の表示幅をピクセル単位で制御します。 既定値は、レポート ビューアー Web パーツの既定値と同じです。 値には、負以外の整数値を指定する必要があります。
AsyncRender:レポートが非同期に表示されるかどうかを制御します。 既定値は trueで、レポートが非同期に表示されることを示します。 この値には、 true または falseのブール値を指定する必要があります。
ParamMode:レポート ビューアー Web パーツのパラメーター プロンプト領域を全体表示で表示する方法を制御します。 既定値は Fullです。 有効な値は次のとおりです。
Full:パラメーター プロンプト領域を表示します。
Collapsed: パラメーター プロンプト領域を折りたたみます。
Hidden: パラメーター プロンプト領域を非表示にします。
SharePoint モードで、パラメーター プロンプト領域を折りたたむ例:
https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=CollapsedDocMapMode:レポート ビューアー Web パーツのドキュメント マップ領域を全体表示で表示する方法を制御します。 既定値は Fullです。 有効な値は次のとおりです。
Full:ドキュメント マップ領域を表示します。
Collapsed: ドキュメント マップ領域を折りたたみます。
Hidden: ドキュメント マップ領域を非表示にします。
DockToolBar:レポート ビューアー Web パーツのツール バーを上部にドッキングするか、下部にドッキングするかを制御します。 有効値は Top および Bottomです。 既定値は Topです。
SharePoint モードで、下部にツール バーをドッキングする例:
https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=BottomToolBarItemsDisplayMode:表示するツール バー項目を制御します。 これはビットごとの列挙値です。 ツール バー項目を含めるには、項目の値を合計値に加算します。 たとえば、 [操作] メニューなしにする場合は、rv:ToolBarItemsDisplayMode=63 (または 0x3F) を使用します。これは、1 + 2 + 4 + 8 + 16 + 32 です。 [操作] メニュー項目のみにする場合は、rv:ToolBarItemsDisplayMode=960 (or 0x3C0) を使用します。 既定値は -1です。すべてのツール バー項目を表示します。 有効な値は次のとおりです。
1 (0x1) : [戻る] ボタン
2 (0x2) : テキスト検索コントロール
4 (0x4) : ページ ナビゲーションのコントロール
8 (0x8) : [更新] ボタン
16 (0x10) : [ズーム] リスト ボックス
32 (0x20) : [Atom フィード] ボタン
64 (0x40) : [操作] の [印刷] メニュー オプション
128 (0x80) : [操作] の [エクスポート] サブメニュー
256 (0x100) : [操作] の [レポート ビルダーで開く] メニュー オプション
512 (0x200) : [操作] の [サブスクライブ] メニュー オプション
1024 (0x400) : [操作] の [新しいデータの警告] メニュー オプション
SharePoint モードで、 [戻る] ボタン、テキスト検索コントロール、ページ ナビゲーション コントロール、 [更新] ボタンのみを表示する例:
https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15
関連するコンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示