XML の接続の種類 (SSRS)
XML データ ソースのデータをレポートに含めるには、種類が XML のレポート データ ソースに基づいたデータセットが必要です。 このビルトイン データ ソースの種類は、XML データ拡張機能に基づいています。 このデータ ソースの種類を使用して、XML ドキュメント、Web サービス、またはクエリに埋め込まれた XML に接続し、データを取得します。
このデータ拡張機能は、接続文字列とは別に管理される資格情報およびパラメーターをサポートしています。
このトピックの情報を使用して、データ ソースを構築してください。 ステップ バイ ステップの手順については、「データ接続を追加および確認する (レポート ビルダーおよび SSRS)」を参照してください。
Connection String
接続文字列を、HTTP 経由でアクセス可能な Web サービス、Web ベース アプリケーション、または XML ドキュメントを指す URL に設定する必要があります。 XML ドキュメントの拡張子は XML にする必要があります。 データセット クエリに埋め込まれた XML データに対し、空の接続文字列を使用することもできます。
次の例に、それぞれ Web サービスと XML ドキュメントに対する接続文字列の構文を示します。 file:// プロトコルはサポートされません。
| XML ドキュメントの種類 | 接続文字列の例 |
|---|---|
| Web サービス | https://adventure-works.com/results.aspx |
| XML ドキュメント | https://localhost/XML/Customers.xml |
| 埋め込み XML ドキュメント | 空 |
接続文字列の例について詳しくは、「 レポート ビルダーでのデータ接続、データ ソース、および接続文字列」をご覧ください。
資格情報
クエリの実行、ローカルでのレポートのプレビュー、およびレポート サーバーからのレポートのプレビューには、資格情報が必要です。
レポートをパブリッシュした後、レポートをレポート サーバーで実行するときに、データを取得するための権限が有効な状態になるように、データ ソースの資格情報を変更する必要が生じる場合があります。
レポート作成クライアントから、次のオプションを使用して資格情報を指定します。
現在の Windows ユーザー (統合セキュリティとも呼ばれます)。
資格情報を必要としない。 資格情報を選択しない場合には、匿名アクセスが使用されます。 レポート サーバーが外部データ ソースに接続するための自動実行アカウントが定義済みであることを確認してください。 XML データ処理拡張機能は、対象 URL または Web サービスに資格情報を渡しません。したがって、自動実行アカウントが定義されていないと接続に失敗します。 詳細については、「自動実行アカウントの構成 (レポート サーバー構成マネージャー)」を参照してください。
保存された資格情報や要求された資格情報はサポートされていません。 Windows 統合セキュリティが無効になっていると、データの取得に Windows 統合セキュリティを使用できないので注意してください。 保存された資格情報や要求された資格情報を指定すると、実行時にエラーが発生します。
詳細については、「データ接続文字列を作成する - レポート ビルダーおよび SSRS」または「レポート データ ソースに関する資格情報と接続情報を指定する」を参照してください。
クエリ
クエリでは、レポート データセット用に取得するデータを指定します。 クエリの結果セットの列には、データセットのフィールド コレクションが設定されます。 レポートによって処理されるのは、クエリから取得された最初の結果セットだけです。
クエリを作成するにはテキスト ベースのクエリ デザイナーを使用する必要があります。 クエリでは XML データを返す必要があります。
テキスト ベースのクエリ デザイナーについては、「テキストベースのクエリ デザイナーのユーザー インターフェイス (レポート ビルダー)」を参照してください。
XML データ ソースに対して使用できるデータセット クエリの値を以下に示します。
空
既定の結果セットを作成するには、空のクエリを使用します。 既定のクエリは、データ ソースを読み取り、最初のリーフ コレクションまで XML ノード階層をたどることによって作成されます。 結果セットには、テキスト値を持つすべてのノード、および、そのパス上に存在するすべてのノード属性が格納されます。 結果セットの列は、データセットのフィールドにマップされます。
要素パス
データ ソースから XML データを取得するときに使用するノードのシーケンスを指定します。
XML Query 要素
XML Query の必須の要素および省略可能な要素を次に示します。
XML データ ソースが Web サービス
必須の XML 要素:
<Method Namespace=""名前空間""Name="MethodName" />-- or --<SoapAction>"soap アクション"</SoapAction>省略可能な XML 要素:
<ElementPath>"要素パス"</ElementPath><Method Namespace=""名前空間""Name="MethodName" />-- or --<SoapAction>"soap アクション"</SoapAction>XML データ ソースが XML ドキュメント
必須の XML 要素:なし
省略可能な XML 要素:
<ElementPath>"要素パス"</ElementPath>XML データ ソースが埋め込みの XML ドキュメント
必須の XML 要素:
<XmlData>内部 XML</XmlData>省略可能な XML 要素:
<ElementPath>"要素パス"</ElementPath>-- or --<ElementPath IgnoreNamespaces="true">"要素パス"</ElementPath>
クエリ構文の詳細については、「XML レポート データの XML クエリ構文 (SSRS)」を参照してください。
例については、「Reporting Services:XML および Web サービス データ ソースを使用する」を参照してください。
XML Web サービスのデータを取得するための要件
これらは XML データ処理拡張機能では検出されません。 そのため、必要なデータを取得する SOAP メソッドを検索するための、なんらかの手段が必要です。 また、Web サービスがそのデータに対して使用するアドレス指定スキームや名前空間を把握しておく必要もあります。
Web サービスの場合、<Query> 要素を使用して、呼び出すメソッドや SOAP アクションを指定できます。 XML データ ソースが、レポートに必要なデータを取得できるような階層構造になっていれば、クエリを空にして、既定のクエリを使用することもできます。 クエリの実行時に取得される XML 要素ノードの値および属性は、レポートに使用されているデータセットのフィールドにマップされます。
XML ドキュメントのデータを取得するための要件
サーバーから HTTP プロトコルを使って XML データを取得するか、XML データを XML Query 要素に埋め込む必要があります。 XML ドキュメントを HTTP プロトコルを使って直接参照する場合、拡張子を .xml にする必要があります。
必要なすべてのデータを取得するための XML クエリの作成方法を理解しておく必要があります。 要素パスを指定しない場合、XML ドキュメントを解析するときの既定の動作では、XML ドキュメントのリーフノード コレクションへの使用可能な最初のパスが選択されます。 XML ドキュメントに他の兄弟リーフノード コレクションへのパスが含まれている場合、クエリでパスを指定しない限り、それらのノードは無視されます。
XQuery と似た XML 構文を使って要素パスを指定できます。
詳細については、「XML レポート データの要素パス構文 (SSRS)」を参照してください。
パラメーター
クエリの解析時にパラメーターは識別されません。
パラメーターを追加するには、 [データセットのプロパティ] ダイアログ ボックスの [パラメーター] ページを使用して手動で作成する必要があります。
解説
XML データ拡張機能は、階層構造でない表形式の XML データからのレポート作成をサポートしています。 詳細については、「外部データ ソースのデータを追加する (SSRS)」を参照してください。
SQL Server データベースから XML ドキュメントを取得するためのサポートは組み込まれていません。
操作方法に関するトピック
データ接続、データ ソース、およびデータセットを操作する手順について説明します。
データ接続を追加および確認する (レポート ビルダーおよび SSRS)
共有データセットまたは埋め込みデータセットの作成 (レポート ビルダーおよび SSRS)
データセットへのフィルターの追加 (レポート ビルダーおよび SSRS)
関連項目
次に示すセクションでは、レポート データの概念が詳細に説明されているほか、データに関連するレポートのパーツを定義し、カスタマイズし、使用する方法が説明されています。
レポート データセット (SSRS)
レポートのデータへのアクセスの概要について説明します。
データ接続文字列を作成する - レポート ビルダーおよび SSRS
データ接続とデータ ソースについて説明します。
レポート埋め込みデータセットと共有データセット (レポート ビルダーおよび SSRS)
埋め込みデータセットと共有データセットについて説明します。
データセット フィールド コレクション (レポート ビルダーおよび SSRS)
クエリによって生成されるデータセット フィールド コレクションについて説明します。
Reporting Services でサポートされるデータ ソース (SSRS)。
各データ拡張機能のプラットフォームおよびバージョン サポートに関する詳細な情報です。
参照
レポート パラメーター (レポート ビルダーおよびレポート デザイナー)
データのフィルター、グループ化、および並べ替え (レポート ビルダーおよび SSRS)
式 (レポート ビルダーおよび SSRS)
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示