URL アクセス (SSRS)

  • [アーティクル]

SQL Server Reporting Services (SSRS) のレポート サーバーの URL アクセスにより、URL 要求を使用してレポート サーバーにコマンドを送信できます。 この機能を使用すると、ネイティブ モードのレポート サーバーまたは SharePoint ライブラリでレポートを表示する方法をカスタマイズできます。 たとえば、特定のレポート パラメーター値のセットを使用してレポートを表示したり、レポートの関心のある特定ページを表示したりできます。 定義済みの URL アクセス パラメーターを使用して、URL でこれらのパラメーターを定義できます。

表示形式またはレポート ビューアーの外観を指定するパラメーターを含めることで、レポート サーバーによるレポートの処理方法をカスタマイズできます。 その後、この URL を他のユーザーに送信して、ブラウザーで同じ方法でレポートにアクセスできるようにします。

URL アクセスを使用して実行できる他のアクションは次のとおりです。

URL アクセスの概念

レポート サーバーは、レポート サーバーに対する URL 要求に含まれるパラメーターを処理します。 レポート サーバーが URL 要求を処理する方法は、URL に含まれるパラメーター、パラメーター プレフィックス、アイテムの種類によって異なります。 レポート サーバーの URL は、World Wide Web コンソーシアム W3C/IETF 共同規格原案で提案されている URL フォーマット ガイドラインに準拠します。 Reporting Services の URL 機能は、標準的な URL アドレス指定をサポートするほとんどのインターネット ブラウザーやアプリケーションと互換性があります。

URL アクセスの構文

URL 要求には、任意の順序で一覧表示される複数のパラメーターを含めることができます。 パラメーターをアンパサンド (&) を使用して区切り、名前と値の組は等号 (=) で区切ります。

SSRS レポート サーバーにコマンドを効果的に送信するには、URL アクセス文字列のさまざまなコンポーネントについて理解することが不可欠です。 URL アクセス文字列には、次のものが含まれます。

  • https://[rswebserviceurl]: レポート サーバーの Web サービスの URL。
  • ?: パラメーターを含むクエリ文字列の先頭を示します。
  • [pathinfo]: サーバー上のレポートまたはアイテムへのパス。
  • [&prefix:param=value]: レポートの表示または動作をカスタマイズする省略可能なプレフィックスを持つ 1 つ以上のパラメーター。
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

構文の説明

次のセクションでは、URL アクセス文字列で使用されるパラメーターの詳細について説明します。 完全な一覧については、「URL アクセス パラメーター リファレンス」を参照してください。

rswebserviceurl

レポート サーバーの Web サービスの URL。

  • ネイティブ モードの場合は、Reporting Services Configuration Manager で構成された Web サービス レポート サーバー インスタンスの Web サービス URL です。 詳細については、「レポート サーバー URL の構成 (レポート サーバー構成マネージャー)」を参照してください。

    次に例を示します。

    https://myrshost/reportserver
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE

  • SharePoint 統合モードでは、Reporting Services に統合された SharePoint サイトの Reporting Services プロキシの URL です。

    次に例を示します。

    https://myspsite/subsite/_vti_bin/reportserver

    ヒント

    SharePoint および _vti_bin HTTP プロキシ経由で要求をルーティングする Reporting Services プロキシ構文を URL に含めることは重要です。 プロキシによって、HTTP 要求にいくつかのコンテキストが追加されます。これは、SharePoint モード レポート サーバーに対してレポートを適切に実行するために必要なコンテキストです。

pathinfo

ネイティブ モードのレポート サーバー データベース内のアイテムの相対パス名、または SharePoint カタログ内のアイテムの完全修飾 URL。

カタログ アイテムのパス。 ネイティブ モードでは、スラッシュ (/) から始まるレポート サーバー データベース内のアイテムの相対パスです。 次に例を示します。

/AdventureWorks2022/Employee_Sales_Summary_2022

SharePoint 統合モードでは、アイテムの拡張子を含む、SharePoint ライブラリ内のアイテムの完全修飾 URL です。 次に例を示します。

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl

&prefix:param=value

URL アクセス文字列では、パラメーターとそれに対応する値を追加して、レポートの表示または動作をカスタマイズします。 名前と値の組でパラメーターを作成するには、アンパサンド (&) で区切られた構文 param=value を使用します。

rs: や rc: などの省略可能なプレフィックスを使用して、レポート サーバー内の特定のプロセスをターゲットにします。

Note

URL アクセス パラメーターにプレフィックスが含まれていない場合は、レポート サーバーによってパラメーターがレポート パラメーターとして処理されます。 レポート パラメーターではパラメーター プレフィックスが使用されず、大文字と小文字が区別されます。

次の例は、この記事で説明されている完全な URL を示しています。

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

関連するコンテンツ