URL アクセス パラメータの使用
次のパラメータを URL の一部として使用すると、レポートの表示形式を構成できます。ここでは、最も一般的なパラメータについて説明します。パラメータは大文字と小文字が区別されます。レポート サーバーに出力する場合は rs:、HTML ビューアに出力する場合は rc: をパラメータの先頭に追加します。デバイスや表示拡張機能に固有のパラメータを指定することもできます。デバイス固有のパラメータの詳細については、「URL でのデバイス情報設定の指定」を参照してください。
HTML ビューアのコマンド
次の表は、先頭に rc: を付けて HTML ビューアをターゲットとするために使用する URL アクセス パラメータを示しています。
パラメータ |
動作 |
|---|---|
Toolbar |
ツール バーの表示と非表示を切り替えます。このパラメータの値が false の場合、残りのオプションすべてが無視されます。このパラメータを省略すると、サポートされている表示形式でツール バーが自動的に表示されます。このパラメータの既定値は true です。 |
Parameters |
ツール バーのパラメータ領域の表示と非表示を切り替えます。このパラメータを true に設定すると、ツール バーのパラメータ領域が表示されます。このパラメータを false に設定すると、パラメータ領域は表示されません。ユーザーが表示することもできません。このパラメータの値を Collapsed に設定すると、パラメータ領域は表示されませんが、エンド ユーザーが表示と非表示を切り替えることができます。このパラメータの既定値は true です。 |
Zoom |
レポート ズーム値を整数のパーセンテージまたは文字列定数として設定します。標準的な文字列値には Page Width と Whole Page などがあります。Internet Explorer 5.0 よりも前の Microsoft Internet Explorer および Microsoft 以外のすべてのブラウザでは、このパラメータが無視されます。このパラメータの既定値は 100 です。 |
Section |
表示するレポートのページを設定します。レポートのページ数よりも大きい値を設定すると、最後のページが表示されます。0 よりも小さい値を設定すると、レポートの 1 ページが表示されます。このパラメータの既定値は 1 です。 |
StartFind |
検索する最後のセクションを指定します。このパラメータの既定値は、レポートの最終ページです。 |
EndFind |
検索に使用する最終ページの番号を設定します。たとえば、5 の値は、検索する最後のページがレポートの 5 ページであることを示します。既定値は現在のページ番号です。このパラメータは、StartFind パラメータと一緒に使用します。 |
FallbackPage |
検索または見出しマップの選択が失敗した場合に表示するページ番号を設定します。既定値は現在のページ番号です。 |
GetImage |
HTML ビューア ユーザー インターフェイス用の特定のアイコンを取得します。 |
Icon |
特定の表示拡張機能のアイコンを取得します。 |
Stylesheet |
HTML ビューアに適用するスタイル シートを指定します。 |
HTML 表示を出力するために、URL で追加パラメータを渡すことができます。詳細については、「HTML デバイス情報設定」を参照してください。
レポート サーバー コマンド
次の表は、先頭に rs: を付けてレポート サーバーをターゲットとするために使用する URL アクセス パラメータを示しています。
パラメータ |
動作 |
|---|---|
Command |
検索する最後のセクションを指定します。このパラメータの既定値は、レポートの最終ページです。 |
Format |
レポートを表示する形式を指定します。一般的な値には、HTML3.2、HTML4.0、MHTML、IMAGE、EXCEL、WORD、CSV、PDF、XML、NULL があります。詳細については、「URL での表示形式の指定」を参照してください。 |
ParameterLanguage |
ブラウザの言語とは関係なく、URL で渡されるパラメータの言語を指定します。既定値は、ブラウザの言語です。値は、en-us や de-de. などのカルチャ値に設定できます。 |
Snapshot |
レポート履歴スナップショットに基づいたレポートを表示します。詳細については、「URL アクセスを使用したレポート履歴スナップショットの表示」を参照してください。 |
PersistStream |
1 つの永続化されたストリームでレポートを表示します。このパラメータは画像レンダラによって使用され、表示レポートをチャンク単位で送信します。このパラメータを URL アクセス文字列に使用したら、PersistStream パラメータを GetNextStream パラメータに置き換え、同じ URL アクセス文字列を使用して、永続化されたストリーム内の次のチャンクを取得します。この URL コマンドは最終的に 0 バイトのストリームを返し、永続化されたストリームの終わりを示します。既定値は false です。 |
GetNextStream |
PersistStream パラメータを使用してアクセスされる永続化されたストリーム内の次のデータ チャンクを取得します。詳細については、「PersistStream」の説明を参照してください。既定値は false です。 |
レポート ビューア Web パーツのコマンド
次の表では、Reporting Services を Windows SharePoint Services (WSS) 3.0 または MicrosoftOffice SharePoint Server (MOSS) 2007 と統合するときにレポート ビューア Web パーツをターゲットとするために使用する、SQL Server 2008 の新しい予約済みのレポート パラメータ名について説明します。これらのパラメータ名の先頭には rv: が付いています。レポート ビューア Web パーツでは、rs:ParameterLanguage パラメータも受け取ります。
パラメータ |
動作 |
|---|---|
Toolbar |
レポート ビューア Web パーツのツール バーの表示を制御します。既定値は Full です。値は次のとおりです。
|
HeaderArea |
レポート ビューア Web パーツのヘッダーの表示を制御します。既定値は Full です。値は次のとおりです。
|
DocMapAreaWidth |
レポート ビューア Web パーツのパラメータ領域の表示幅をピクセル単位で制御します。既定値は、レポート ビューア Web パーツの既定値と同じです。値には、負以外の整数値を指定する必要があります。 |
AsyncRender |
レポートが非同期に表示されるかどうかを制御します。既定値は true で、レポートが非同期に表示されることを示します。この値には、true または false のブール値を指定する必要があります。 |
例
次の例では、rc:Toolbar パラメータ値を false 設定することによって HTML ビューアのツール バーを非表示にします。
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false
次の例では、ハードコードされたパラメータを渡し、ユーザーが指定するパラメータの入力フィールドを非表示にします。
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002
次の例では、rc:Zoom パラメータを使用してレポートのズーム プロパティを Page Width に設定します。
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width
次の例では、レポートのセクション 13 の表示と非表示を切り替えます。
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13