SharePoint リストの接続の種類 (SSRS)
適用対象:
SQL Server 2016 (13.x) Power BI Report Server SharePoint
Microsoft SharePoint リストのデータをレポートに含めるには、種類が Microsoft SharePoint リストのレポート データ ソースに基づいたデータセットを追加または作成する必要があります。 これは、Microsoft SQL Server Reporting Services SharePoint リストのデータ拡張機能に基づいたビルトイン データ ソースの種類です。 このデータ ソースの種類を使用して、SharePoint 2013 以降のリスト データに接続し、そのデータを取得します。
このトピックの情報を使用して、データ ソースを構築してください。 ステップ バイ ステップの手順については、「データ接続を追加および確認する (レポート ビルダーおよび SSRS)」を参照してください。
Connection String
SharePoint リストへの接続文字列は、SharePoint サイトまたはサブサイトの URL です ( https://MySharePointWeb/MySharePointSite や https://MySharePointWeb/MySharePointSite/Subsiteなど)。
クエリ デザイナーには、付与されている権限でアクセスできる SharePoint リストが表示されます。
接続文字列の例の詳細については、「データ接続文字列を作成する - レポート ビルダーおよび SSRS」を参照してください。
資格情報
クエリの実行、ローカルでのレポートのプレビュー、およびレポート サーバーからのレポートのプレビューには、資格情報が必要です。 レポートをパブリッシュした後、レポートをレポート サーバーで実行するときに、データを取得するための権限が有効な状態になるように、データ ソースの資格情報を変更する必要が生じる場合があります。 このデータ拡張機能で使用できる資格情報の種類は、データ ソースとして使用している SharePoint リストの SharePoint テクノロジの構成によって異なります。
次の表は、ローカル ファームの SharePoint リストおよびリモートの SharePoint リストに接続するときに SharePoint リスト拡張機能が実行する資格情報取得動作の概要を示しています。
表 1 は、レガシ Windows SharePoint サイトに配置されたレポートの場合です。 レガシ Windows サイトがサポートしているのは、Kerberos、NTLM、およびフォーム ベースの認証 (FBA) のみです。 表 2 は、要求ベースの SharePoint サイトに配置されたレポートの場合です。
表 1
| 取得の種類 | サポートされる資格情報 | クラシック モードの Windows 認証 | *要求認証 |
|---|---|---|---|
| ローカル ファームの SharePoint リスト | Windows 認証 (統合セキュリティ) または SharePoint ユーザー トークン | はい | はい |
| 保存、要求、なし (Windows 資格情報を使用) Windows 以外の資格情報を使用した場合、保存されている資格情報や資格情報の要求はサポートされません。 |
はい | いいえ | |
| リモートの SharePoint リスト | Windows 認証 (統合セキュリティ) または SharePoint ユーザー トークン | はい | いいえ フォーム ベース認証と要求認証は、リモートの SharePoint リストに対してはサポートされていません。 |
| 保存、要求、なし (Windows 資格情報を使用) Windows 以外の資格情報を使用した場合、保存されている資格情報や資格情報の要求はサポートされません。 |
はい | いいえ フォーム ベース認証と要求認証は、リモートの SharePoint リストに対してはサポートされていません。 |
*Windows 認証、フォーム ベース認証 (FBA)、セキュア アプリケーション マークアップ言語 (SAML) トークン、その他の ID プロバイダー、または上記の認証プロバイダーの組み合わせ。
表 2
| 取得の種類 | サポートされる資格情報 | クラシック モードの Windows 認証 | *要求認証 |
|---|---|---|---|
| ローカル ファームの SharePoint リスト | Windows 認証 (統合セキュリティ) または SharePoint ユーザー トークン | はい | はい |
| 保存、要求、なし (Windows 資格情報を使用) Windows 以外の資格情報を使用した場合、保存されている資格情報や資格情報の要求はサポートされません。 |
いいえ | いいえ | |
| リモートの SharePoint リスト | Windows 認証 (統合セキュリティ) または SharePoint ユーザー トークン | はい | いいえ フォーム ベース認証と要求認証は、リモートの SharePoint リストに対してはサポートされていません。 |
| 保存、要求、なし (Windows 資格情報を使用) Windows 以外の資格情報を使用した場合、保存されている資格情報や資格情報の要求はサポートされません。 |
いいえ | いいえ フォーム ベース認証と要求認証は、リモートの SharePoint リストに対してはサポートされていません。 |
*Windows 認証、フォーム ベース認証 (FBA)、セキュア アプリケーション マークアップ言語 (SAML) トークン、その他の ID プロバイダー、または上記の認証プロバイダーの組み合わせ。
[Windows 認証]
信頼済みアカウント モードのレポート サーバーと連携するように構成されている SharePoint テクノロジの場合、このオプションはサポートされません。 これは、SQL Server 2012 Reporting Services より前のリリースにのみ適用されます。
Windows 統合モードのレポート サーバーと連携するように構成されている SharePoint テクノロジの場合、このオプションは現在の Windows ユーザーと現在の SharePoint ユーザーの両方に適用されます。
レポート サーバー (ローカル モード) なしで動作するように構成されている SharePoint テクノロジの場合、このオプションはサポートされません。 ローカル モードの詳細については、「レポート ビューアーでのローカル モードと接続モードのレポート (Reporting Services の SharePoint モード)」を参照してください。
[資格情報は必要ありません]\([資格情報を使用しない])
このオプションを使用するには、レポート サーバーで自動実行アカウントを構成する必要があります。 詳細については、「自動実行アカウントの構成 (レポート サーバー構成マネージャー)」を参照してください。
詳細については、「データ接続文字列 - レポート ビルダーおよび SSRS」、「レポート データ ソースに関する資格情報と接続情報を指定する」、および「Reporting Services でサポートされるデータ ソース (SSRS)」を参照してください。
クエリ
クエリを設計するには、データ ソースから新規データセットを作成し、関連するクエリ デザイナーを開きます。 詳細については、「共有データセットまたは埋め込みデータセットの作成 (レポート ビルダーおよび SSRS)」を参照してください。
SharePoint リストのグラフィカル クエリ デザイナーには、次の 4 つのペインがあります。
SharePoint リスト このデータ ソースについて、サイト上のすべての SharePoint リストの一覧が表示されます。 リストを選択してから、クエリに使用するフィールドを選択します。 このペインの各フィールドの名前は、SharePoint 表示名です。 アイテムの上にマウス ポインターを移動すると、ツールヒントに次のプロパティが表示されます。
名前 フィールドの一意の名前です。
識別子 フィールドの一意の識別子です。
フィールドの種類 フィールドのデータ型。
非表示 SharePoint リスト ビューにフィールドを表示するかどうかを指定します。
複数のリストからフィールドを選択することはできません。 各リストのデータセットを作成し、各データセットからフィールドを選択できます。 リストに共通のフィールドが含まれている場合、一方のデータセットにバインドされている Tablix データ領域で Lookup 関数を使用し、データ領域にバインドされていない他方のデータセットから値を抽出することができます。 詳細については、「Lookup 関数 (レポート ビルダーおよび SSRS)」を参照してください。
選択されたフィールド 選択したフィールドが表示されます。 このペインのフィールドの名前は、SharePoint ユーザーが指定した表示名になります。 クエリ デザイナーを閉じると、レポート データ ペインのデータセット フィールド コレクションにこれらの名前が表示されます。 一意の名前と表示名の関係については、「[フィールド] ([データセットのプロパティ] ダイアログ ボックス) (レポート ビルダー)」を参照してください。
適用されたフィルター SharePoint リストから返されたデータがレポートに返される前に、このデータを制限します。 使用するフィールド名、演算子、および値を選択して、リストに取得されるデータを制限します。 演算子は、選択した値のデータ型によって異なります。
グラフィカル クエリ デザイナーでは、並べ替え順を変更したり、グループを指定したりすることはできません。 これらの手順を実行するには、レポート データセットの並べ替え式およびレポートのデータ領域のグループ式を設定します。 クエリ パラメーターはサポートされていません。 レポートでデータをフィルター処理するには、作成したレポート フィルターまたはレポート パラメーターを使用します。 詳細については、「データのフィルター、グループ化、および並べ替え (レポート ビルダーおよび SSRS)」および「レポート パラメーター (レポート ビルダーおよびレポート デザイナー)」を参照してください。
クエリ結果 クエリの実行時に返される行のサンプルが表示されます。 SharePoint リストの値が SharePoint サイトで頻繁に変更されると、クエリ結果ペインに表示される値とレポートの値が異なる場合があります。
選択されたフィールド 選択したフィールドが表示されます。 このペインのフィールドの名前は、SharePoint ユーザーが指定した表示名になります。 クエリ デザイナーを閉じると、レポート データ ペインのデータセット フィールド コレクションにこれらの名前が表示されます。 一意の名前と表示名の関係については、「[フィールド] ([データセットのプロパティ] ダイアログ ボックス) (レポート ビルダー)」を参照してください。
適用されたフィルター SharePoint リストから返されたデータがレポートに返される前に、このデータを制限します。 使用するフィールド名、演算子、および値を選択して、リストに取得されるデータを制限します。 演算子は、選択した値のデータ型によって異なります。
グラフィカル クエリ デザイナーでは、並べ替え順を変更したり、グループを指定したりすることはできません。 これらの手順を実行するには、レポート データセットの並べ替え式およびレポートのデータ領域のグループ式を設定します。 クエリ パラメーターはサポートされていません。 レポートでデータをフィルター処理するには、作成したレポート フィルターまたはレポート パラメーターを使用します。 詳細については、「データのフィルター、グループ化、および並べ替え (レポート ビルダーおよび SSRS)」および「レポート パラメーター (レポート ビルダーおよびレポート デザイナー)」を参照してください。
クエリ結果 クエリの実行時に返される行のサンプルが表示されます。 SharePoint リストの値が SharePoint サイトで頻繁に変更されると、クエリ結果ペインに表示される値とレポートの値が異なる場合があります。
詳細については、「SharePoint リストのクエリ デザイナー (レポート ビルダー)」を参照してください。
クエリ テキスト
グラフィカル クエリ デザイナーで生成されたクエリを表示するには、テキスト ベースのクエリ デザイナーに切り替えます。 このビューには、グラフィカル クエリ デザイナーで作成された XML が表示されます。 XML には要素として、リスト名、フィールド コレクション、およびフィルターも含まれます。
例 1. リストの指定フィールド
次の例は、整形式の SharePoint クエリを示しています。
<RSSharePointList>
<listName>MyList</listName>
<viewFields>
<FieldRef Name="Field1"/>
<FieldRef Name="Field4"/>
</viewFields>
<Query>
<Where>
<And>
<Gt>
<FieldRef Name="Field1"/>
<Value Type="Integer">1</Value>
</Gt>
<IsNotNull>
<FieldRef Name="Field2"/>
<Value Type="string"/>
</IsNotNull>
</And>
</Where>
</Query>
</RSSharePointList>
整形式の XML テキストという状態を崩さない限り、このビューのクエリを編集できます。
例 2. リストのすべてのフィールド
リストの名前のみを指定することもできます。非表示のフィールドを含むすべてのフィールドが返されます。 次の例では、Tasks という名前のリストからすべてのフィールドを取得します。
<RSSharePointList>
<listName>Tasks</listName>
</RSSharePointList>
リスト Tasks のすべてのフィールドがクエリ結果で返されます。
パラメーター
このデータ拡張機能では、パラメーターはサポートされていません。
操作方法に関するトピック
データ接続、データ ソース、およびデータセットを操作する手順について説明します。
データ接続を追加および確認する (レポート ビルダーおよび SSRS)
共有データセットまたは埋め込みデータセットの作成 (レポート ビルダーおよび SSRS)
データセットへのフィルターの追加 (レポート ビルダーおよび SSRS)
関連項目
次に示すセクションでは、レポート データの概念が詳細に説明されているほか、データに関連するレポートのパーツを定義し、カスタマイズし、使用する方法が説明されています。
レポート データセット (SSRS)
レポートのデータへのアクセスの概要について説明します。
データ接続文字列を作成する - レポート ビルダーおよび SSRS
データ接続とデータ ソースについて説明します。
レポート埋め込みデータセットと共有データセット (レポート ビルダーおよび SSRS)
埋め込みデータセットと共有データセットについて説明します。
データセット フィールド コレクション (レポート ビルダーおよび SSRS)
クエリによって生成されるデータセット フィールド コレクションについて説明します。
Reporting Services でサポートされるデータ ソース (SSRS)。
各データ拡張機能のプラットフォームおよびバージョン サポートに関する詳細な情報です。
参照
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示