URL アクセス パラメーター リファレンス
次のパラメーターを URL の一部として使用すると、 レポートのルック アンド フィールを構成できます。 ここでは、最も一般的なパラメーターについて説明します。 パラメーターは大文字と小文字が区別されます。レポート サーバーに出力する場合は rs: 、HTML ビューアーに出力する場合は rc: をパラメーターの先頭に追加します。 デバイスや表示拡張機能に固有のパラメーターを指定することもできます。 デバイスに固有のパラメーターの詳細については、「 URL でデバイス情報設定を指定する」を参照してください。
重要
SharePoint および _vti_bin
HTTP プロキシ経由で要求をルーティングする Reporting Services プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にいくつかのコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。 例については、「 Access Report Server Items Using URL Access」を参照してください。
レポート パラメーターを URL に含める方法および例については、「 Pass a Report Parameter Within a URL」を参照してください。
HTML ビューアーのコマンド (rc:)
次の表では、先頭に rc: が付き、HTML ビューアーを対象とするために使用される URL アクセス パラメーターについて説明します。
パラメーター | 説明 | 値 |
---|---|---|
ツール バー | ツール バーの表示と非表示を切り替えます。 ** 重要 ** rc:Toolbar= false は、SharePoint サイトでホストされているレポートをターゲットにするために、ドメイン名ではなく IP アドレスを使用する URL アクセス文字列では機能しません。 |
このパラメーターの値が false の場合、残りのオプションすべてが無視されます。 このパラメーターを省略すると、サポートされている表示形式でツール バーが自動的に表示されます。 このパラメーターの既定値は true です。true false |
パラメーター | ツール バーのパラメーター領域の表示と非表示を切り替えます。Native モードの例:http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed SharePoint モードの例:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed |
このパラメーターを true に設定すると、ツール バーのパラメーター領域が表示されます。 このパラメーターを false に設定すると、パラメーター領域は表示されません。ユーザーが表示することもできません。 このパラメーターの値を Collapsed に設定すると、パラメーター領域は表示されませんが、エンド ユーザーが表示と非表示を切り替えることができます。 このパラメーターの既定値は true です。 有効な値は次のとおりです。true false Collapsed |
ズーム | レポート ズーム値を整数のパーセンテージまたは文字列定数として設定します。Native モードの例:http://myrshost/reportserver?/Sales&rc:Zoom=Page Width SharePoint モードの例:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width |
標準的な文字列値には Page Width と Whole Page などがあります。 Internet Explorer 5.0 より前のバージョンの Internet Explorer および Microsoft 以外のすべてのブラウザーでは、このパラメーターが無視されます。 このパラメーターの既定値は 100 です。 |
セクション | 表示するレポートのページを設定します。Native モードの例を使用して、レポートの 2 ページ目を表示します。http://myrshost/reportserver?/Sales&rc:Section=2 SharePoint モードの例を使用して、レポートの 2 ページ目を表示します。http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2 |
レポートのページ数よりも大きい値を設定すると、最後のページが表示されます。 0 よりも小さい値を設定すると、レポートの 1 ページが表示されます。 このパラメーターの既定値は 1 です。 |
FindString | レポート内で特定のテキスト セットを検索します。Native モードの例:http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400 SharePoint モードの例:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400 |
|
StartFind | 検索する最後のセクションを指定します。Native 1 ページ目から 5 ページ目で終わる製品カタログ サンプル レポートで、"Mountain-400" というテキストの最初の出現箇所を検索するモードの例:https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
このパラメーターの既定値は、レポートの最終ページです。 |
EndFind | 検索に使用する最終ページの番号を設定します。 たとえば、5 の値は、検索する最後のページがレポートの 5 ページであることを示します。 このパラメーターは、 StartFind パラメーターと一緒に使用します。 StartFind については、上記の例を参照してください。 |
既定値は現在のページ番号です。 |
FallbackPage | 検索またはドキュメント マップの選択が失敗した場合に表示するページ番号を設定します。 | 既定値は現在のページ番号です。 |
GetImage | HTML ビューアー ユーザー インターフェイス用の特定のアイコンを取得します。 | |
アイコン | 特定の表示拡張機能のアイコンを取得します。 | |
スタイルシート | HTML ビューアーに適用するスタイル シートを指定します。 | |
デバイス情報設定 | rc:tag=value の形式でデバイス情報設定を指定します。この tag は、現在使用されている表示拡張機能に固有のデバイス情報設定の名前です (Format パラメーターの説明を参照してください)。 たとえば、IMAGE 表示拡張機能の OutputFormat デバイス情報設定を使用すると、URL アクセス文字列に ...&rs:Format=IMAGE&rc:OutputFormat=JPEG パラメーターを指定することで、レポートを JPEG 画像で表示できます。 拡張機能固有のすべてのデバイス情報設定の詳細については、「 表示拡張機能のデバイス情報設定 (Reporting Services)」を参照してください。 |
レポート サーバー コマンド (rs:)
次の表では、 rs: で始まる URL アクセス パラメーターについて説明します。これは、レポート サーバーを対象とするために使用されます。
パラメーター | 説明 |
---|---|
コマンド | アイテムの種類に応じて、カタログ アイテムに対して操作を実行します。 既定値は、URL アクセス文字列で参照されるカタログ アイテムの種類で決まります。 有効な値は次のとおりです。ListChildren と GetChildren フォルダーの内容を表示します。 フォルダー アイテムは、汎用アイテム ナビゲーション ページに表示されます。Native モードの例:http://myrshost/reportserver?/Sales&rs:Command=GetChildren SharePoint モードの例:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren |
Render 指定したレポートを表示します。Native モードの例:http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render SharePoint モードの例:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
|
GetSharedDatasetDefinition 共有データセットに関連付けられている XML 定義を表示します。 クエリ、データセット パラメーター、既定値、データセット フィルター、照合順序や大文字と小文字の区別などのデータ オプションを含む共有データセット プロパティは、定義内に保存されます。 この値を使用するには、共有データセットに対する Read Report Definition 権限が必要です。Native モードの例:https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
|
GetDataSourceContents 特定の共有データ ソースのプロパティを XML として表示します。 ブラウザーで XML がサポートされていて、目的のデータ ソースに対して Read Contents 権限が与えられている認証ユーザーである場合は、そのデータ ソース定義が表示されます。Native モードの例:http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents SharePoint モードの例:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents |
|
GetResourceContents リソースがブラウザーと互換性がある場合は、リソースをレンダリングし、HTML ページに表示します。 それ以外の場合は、ファイルまたはリソースを開くか、ディスクに保存するように要求されます。Native モードの例:http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents SharePoint モードの例:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
|
GetComponentDefinition パブリッシュされたレポート アイテムに関連付けられている XML 定義を表示します。 この値を使用するには、パブリッシュされたレポート アイテムに対する Read Contents 権限が必要です。 |
|
形式 | レポートを表示する形式を指定します。 一般的な値には、ATOM 、HTML4.0 、MHTML 、IMAGE 、EXCEL 、WORD 、CSV 、PDF 、XML があります。 既定値は HTML4.0 です。 詳細については、「 URL アクセスを使用してレポートをエクスポート」を参照してください。Native のレポート サーバーからレポートの PDF コピーを直接取得する例。http://myrshost/ReportServer?/myreport&rs:Format=PDF たとえば、 SharePoint モードです。http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
ParameterLanguage | ブラウザーの言語とは関係なく、URL で渡されるパラメーターの言語を指定します。 既定値は、ブラウザーの言語です。 値は、en-us や de-de. などのカルチャ値に設定できます。Native モードで、ブラウザーの言語をオーバーライドし、de-DE というカルチャ値を指定する例。http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE |
スナップショット | レポート履歴スナップショットに基づいたレポートを表示します。 詳細については、「 URL アクセスを使用してレポート履歴スナップショットを表示する」を参照してください。Native モードで、日付が 2003-04-07 でタイムスタンプが 13:40:02 のレポート履歴スナップショットを取得する例。http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02 |
PersistStreams | 1 つの永続化ストリームでレポートを表示します。 このパラメーターは、表示レポートをチャンク単位で送信するために画像レンダラーによって使用されます。 URL アクセス文字列でこのパラメーターを使用した後、同じ URL アクセス文字列を、 GetNextStream パラメーターではなく PersistStreams パラメーターと共に使用すると、永続化ストリームの次のチャンクを取得できます。 この URL コマンドは、最終的に永続化ストリームの末尾に到達した時点で 0 バイト ストリームを返します。 既定値は false です。 |
GetNextStream | PersistStreams パラメーターを使用してアクセスした永続化ストリームの次のデータ チャンクを取得します。 詳細については、 PersistStreamsの説明を参照してください。 既定値は false です。 |
SessionID | クライアント アプリケーションとレポート サーバー間で確立されたアクティブ レポート セッションを指定します。 このパラメーターの値は、セッション ID に設定されます。 セッション ID をクッキーまたは URL の一部として指定できます。 セッション クッキーを使用しないようにレポート サーバーを構成している場合、指定したセッション ID なしの最初の要求はセッション ID 付きでリダイレクトされます。 レポート サーバーのセッションの詳細については、「 Identifying Execution State」を参照してください。 |
ClearSession | 値が true の場合は、レポート セッションからレポートを削除するようにレポート サーバーに指示します。 認証されているユーザーに関連付けられたすべてのレポート インスタンスがレポート セッションから削除されます (レポート インスタンスは、レポート パラメーター値が異なる同じレポート実行として複数回定義されます)。既定値は false です。 |
ResetSession | 値が true の場合は、レポート セッションのすべてのレポート スナップショットとの関連付けを削除することによって、レポート セッションをリセットするようレポート サーバーに指示します。 既定値は false です。 |
ShowHideToggle | レポートのセクションの表示と非表示を切り替えます。 切り替えるセクションを表す正の整数を指定します。 |
レポート ビューアー Web パーツのコマンド (rv:)
次の表では、SharePoint と統合されたレポート ビューアー Web パーツを対象とするために使用される SQL Server 予約レポート パラメーター名について説明します。 これらのパラメーター名の先頭には rv: が付いています。 レポート ビューアー Web パーツでは、 rs:ParameterLanguage パラメーターも受け取ります。
パラメーター | アクション |
---|---|
ツール バー | レポート ビューアー Web パーツのツール バーの表示を制御します。 既定値は Full です。 可能な値は次のとおりです。Full : ツール バーを完全に表示します。Navigation : ツール バーに改ページのみ表示します。None : ツール バーを表示しません。SharePoint モードで、ツール バーに改ページのみを表示する例。http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
HeaderArea | レポート ビューアー Web パーツのヘッダーの表示を制御します。 既定値は Full です。 可能な値は次のとおりです。Full : ヘッダーを完全に表示します。BreadCrumbsOnly : ヘッダーに階層リンクのナビゲーションのみを表示して、アプリケーションでの現在位置をユーザーに示します。None : ヘッダーを表示しません。SharePoint モードで、ヘッダーに階層リンクのナビゲーションのみを表示する例。http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
DocMapAreaWidth | レポート ビューアー Web パーツのパラメーター領域の表示幅をピクセル単位で制御します。 既定値は、レポート ビューアー Web パーツの既定値と同じです。 値には、負以外の整数値を指定する必要があります。 |
AsyncRender | レポートが非同期に表示されるかどうかを制御します。 既定値は true で、レポートが非同期に表示されることを示します。 この値には、true または false のブール値を指定する必要があります。 |
ParamMode | レポート ビューアー Web パーツのパラメーター プロンプト領域を全体表示で表示する方法を制御します。 既定値は Full です。 有効な値は次のとおりです。Full : パラメーター プロンプト領域を表示します。Collapsed : パラメーター プロンプト領域を折りたたみます。Hidden : パラメーター プロンプト領域を非表示にします。SharePoint モードで、パラメーター プロンプト領域を折りたたむ例。http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
DocMapMode | レポート ビューアー Web パーツのドキュメント マップ領域を全体表示で表示する方法を制御します。 既定値は Full です。 有効な値は次のとおりです。Full : ドキュメント マップ領域を表示します。Collapsed : ドキュメント マップ領域を折りたたみます。Hidden : ドキュメント マップ領域を非表示にします。 |
DockToolBar | レポート ビューアー Web パーツのツール バーを上部にドッキングするか、下部にドッキングするかを制御します。 有効値は Top または Bottom です。 既定値は Top です。SharePoint モードで、下部にツール バーをドッキングする例。http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
ToolBarItemsDisplayMode | 表示するツール バー項目を制御します。 これはビットごとの列挙値です。 ツール バー項目を含めるには、項目の値を合計値に加算します。 たとえば、[アクション] メニューが表示されない場合は、rv:ToolBarItemsDisplayMode=63 (または 0x3F) を使用します。これは 1+2+4+8+16+32 を表します。[アクション] メニュー項目のみを表示する場合は、rv:ToolBarItemsDisplayMode=960 (または 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 モードでは、 Back ボタン、テキスト検索コントロール、ページ ナビゲーション コントロール、 Refresh ボタンのみを表示します。http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |