URL アクセス パラメーター リファレンス
次のパラメーターを URL の一部として使用すると、レポートのルック アンド フィールを構成できます。 ここでは、最も一般的なパラメーターについて説明します。 パラメーターは大文字と小文字が区別されます。レポート サーバーに出力する場合は rs:、HTML ビューアーに出力する場合は rc: をパラメーターの先頭に追加します。 デバイスや表示拡張機能に固有のパラメーターを指定することもできます。 デバイス固有のパラメーターの詳細については、「URL でデバイス情報設定を指定する」を参照してください。
.gif "重要な注意事項") 重要 |
|---|
SharePoint および Reporting Services HTTP プロキシ経由で要求をルーティングする _vti_bin プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にいくつかのコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。 例については、「URL アクセスを使用したレポート サーバー アイテムへのアクセス」を参照してください。 |
レポート パラメーターを URL に含める方法および例については、「URL 内でレポート パラメーターを渡す」を参照してください。
HTML ビューアーのコマンド (rc:)
次の表は、先頭に rc: を付けて HTML ビューアーをターゲットとするために使用する URL アクセス パラメーターを示しています。
パラメーター |
動作 |
||
|---|---|---|---|
Toolbar |
ツール バーの表示と非表示を切り替えます。 このパラメーターの値が false の場合、残りのオプションすべてが無視されます。 このパラメーターを省略すると、サポートされている表示形式でツール バーが自動的に表示されます。 このパラメーターの既定値は true です。
|
||
Parameters |
ツール バーのパラメーター領域の表示と非表示を切り替えます。 このパラメーターを true に設定すると、ツール バーのパラメーター領域が表示されます。 このパラメーターを false に設定すると、パラメーター領域は表示されません。ユーザーが表示することもできません。 このパラメーターの値を Collapsed に設定すると、パラメーター領域は表示されませんが、エンド ユーザーが表示と非表示を切り替えることができます。 このパラメーターの既定値は true です。 Native モードの例。 SharePoint モードの例。 |
||
Zoom |
レポート ズーム値を整数のパーセンテージまたは文字列定数として設定します。 標準的な文字列値には Page Width と Whole Page などがあります。 Internet Explorer 5.0 よりも前のバージョンの Internet Explorer および Microsoft 以外のすべてのブラウザーでは、このパラメーターが無視されます。 このパラメーターの既定値は 100 です。 Native モードの例。 SharePoint モードの例。 |
||
Section |
表示するレポートのページを設定します。 レポートのページ数よりも大きい値を設定すると、最後のページが表示されます。 0 よりも小さい値を設定すると、レポートの 1 ページが表示されます。 このパラメーターの既定値は 1 です。 Native モードで、レポートの 2 ページ目を表示する例。 SharePoint モードで、レポートの 2 ページ目を表示する例。 |
||
FindString |
レポート内で特定のテキスト セットを検索します。 Native モードの例。 SharePoint モードの例。 |
||
StartFind |
検索する最後のセクションを指定します。 このパラメーターの既定値は、レポートの最終ページです。 Product Catalog サンプル レポートの 1 ～ 5 ページを検索し、最初に出現する "Mountain-400" という文字列を探す、Native モードの例。 |
||
EndFind |
検索に使用する最終ページの番号を設定します。 たとえば、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 アクセス パラメーターを示しています。
パラメーター |
動作 |
|---|---|
Command |
アイテムの種類に応じて、カタログ アイテムに対して操作を実行します。 既定値は、URL アクセス文字列で参照されるカタログ アイテムの種類で決まります。 以下の値が有効です。
|
Format |
レポートを表示する形式を指定します。 一般的な値には、ATOM、HTML4.0、MHTML、IMAGE、EXCEL、WORD、CSV、PDF、XML があります。 既定値は HTML4.0 です。 詳細については、「URL アクセスを使用してレポートをエクスポートする」を参照してください。 Native のレポート サーバーからレポートの PDF コピーを直接取得する例。 SharePoint モードの例。 |
ParameterLanguage |
ブラウザーの言語とは関係なく、URL で渡されるパラメーターの言語を指定します。 既定値は、ブラウザーの言語です。 値は、en-us や de-de. などのカルチャ値に設定できます。 Native モードで、ブラウザーの言語をオーバーライドし、de-DE というカルチャ値を指定する例。 |
Snapshot |
レポート履歴スナップショットに基づいたレポートを表示します。 詳細については、「URL アクセスを使用してレポート履歴スナップショットを表示する」を参照してください。 Native モードで、日付が 2003-04-07 でタイムスタンプが 13:40:02 のレポート履歴スナップショットを取得する例。 |
PersistStreams |
1 つの永続化ストリームでレポートを表示します。 このパラメーターは、表示レポートをチャンク単位で送信するために画像レンダラーによって使用されます。 URL アクセス文字列でこのパラメーターを使用した後、同じ URL アクセス文字列を、PersistStreams パラメーターではなく GetNextStream パラメーターと共に使用すると、永続化ストリームの次のチャンクを取得できます。 この URL コマンドは、最終的に永続化ストリームの末尾に到達した時点で 0 バイト ストリームを返します。 既定値は false です。 |
GetNextStream |
PersistStreams パラメーターを使用してアクセスした永続化ストリームの次のデータ チャンクを取得します。 詳細については、PersistStreams の説明を参照してください。 既定値は false です。 |
SessionID |
クライアント アプリケーションとレポート サーバー間で確立されたアクティブ レポート セッションを指定します。 このパラメーターの値は、セッション ID に設定されます。 セッション ID をクッキーまたは URL の一部として指定できます。 セッション クッキーを使用しないようにレポート サーバーを構成している場合、指定したセッション ID なしの最初の要求はセッション ID 付きでリダイレクトされます。 レポート サーバーのセッションの詳細については、「実行状態の識別」を参照してください。 |
ClearSession |
値が true の場合は、レポート セッションからレポートを削除するようにレポート サーバーに指示します。 認証されているユーザーに関連付けられたすべてのレポート インスタンスがレポート セッションから削除されます (レポート インスタンスは、別のレポート パラメーターの値を指定して、レポートを複数回実行するように定義されます)。既定値は false です。 |
ResetSession |
値が true の場合は、レポート セッションのすべてのレポート スナップショットとの関連付けを削除することによって、レポート セッションをリセットするようレポート サーバーに指示します。 既定値は false です。 |
ShowHideToggle |
レポートのセクションの表示と非表示を切り替えます。 切り替えるセクションを表す正の整数を指定します。 |
レポート ビューアー Web パーツのコマンド (rv:)
次の表では、SharePoint と統合されているレポート ビューアー Web パーツをターゲットとするために使用する、SQL Server の予約済みのレポート パラメーター名について説明します。 これらのパラメーター名の先頭には rv: が付いています。 レポート ビューアー Web パーツでは、rs:ParameterLanguage パラメーターも受け取ります。
パラメーター |
動作 |
|---|---|
Toolbar |
レポート ビューアー Web パーツのツール バーの表示を制御します。 既定値は Full です。 値は次のとおりです。
SharePoint モードで、ツール バーに改ページのみを表示する例。 |
HeaderArea |
レポート ビューアー Web パーツのヘッダーの表示を制御します。 既定値は Full です。 値は次のとおりです。
SharePoint モードで、ヘッダーに階層リンクのナビゲーションのみを表示する例。 |
DocMapAreaWidth |
レポート ビューアー Web パーツのパラメーター領域の表示幅をピクセル単位で制御します。 既定値は、レポート ビューアー Web パーツの既定値と同じです。 値には、負以外の整数値を指定する必要があります。 |
AsyncRender |
レポートが非同期に表示されるかどうかを制御します。 既定値は true で、レポートが非同期に表示されることを示します。 この値には、true または false のブール値を指定する必要があります。 |
ParamMode |
レポート ビューアー Web パーツのパラメーター プロンプト領域を全体表示で表示する方法を制御します。 以下の値が有効です。
既定値は Full です。 SharePoint モードで、パラメーター プロンプト領域を折りたたむ例。 |
DocMapMode |
レポート ビューアー Web パーツのドキュメント マップ領域を全体表示で表示する方法を制御します。 以下の値が有効です。
既定値は Full です。 |
DockToolBar |
レポート ビューアー Web パーツのツール バーを上部にドッキングするか、下部にドッキングするかを制御します。 有効値は Top および Bottom です。 既定値は Top です。 SharePoint モードで、下部にツール バーをドッキングする例。 |
ToolBarItemsDisplayMode |
表示するツール バー項目を制御します。 これはビットごとの列挙値です。 ツール バー項目を含めるには、項目の値を合計値に加算します。 たとえば、[アクション] メニューが表示されない場合は、rv:ToolBarItemsDisplayMode=63 (または 0x3F) を使用します。これは 1+2+4+8+16+32 を表します。[アクション] メニュー項目のみを表示する場合は、rv:ToolBarItemsDisplayMode=960 (または 0x3C0) を使用します。 以下の値が有効です。
既定値は -1 です。すべてのツール バー項目を表示します。 SharePoint モードで、[戻る] ボタン、テキスト検索コントロール、ページ ナビゲーション コントロール、[更新] ボタンのみを表示する例。 |