構文
SharePoint.Contents(url as text, optional options as nullable record) as table
バージョン情報
指定したSharePoint サイトにあるフォルダーとファイルを含む階層テーブルurl返します。 次の表は、現在のレベルの項目を示しており、サイト内のすべてのファイルを再帰的に返すわけではありません。 フォルダーの場合、 Content 列には、フォルダーの内容に移動するために使用できる入れ子になったテーブルが含まれています。 ファイルの場合、 Content 列にはバイナリ値としてファイルの内容が含まれます。 サイトとそのサブフォルダー内のすべてのファイルのフラット テーブルを取得するには、 SharePoint.Filesを使用します。 各行には、 Name、 Extension、 Date accessed、 Date modified、 Date created、 Attributes、および Folder Path 列も含まれます。 フォルダー行には空の Extension 値があります。
Date accessed は、フォルダーとファイルの両方に対して null されます。
Folder Path値は、アイテムを含むフォルダーの絶対 URL です。 サイト URL にクエリ文字列またはフラグメントを含めることはできません。 options を指定して、次のオプションを制御できます:
ApiVersion: このサイトで使用する SharePoint API のバージョンを指定する数値 (14 または 15) またはテキスト "Auto"。 指定しない場合、API バージョン 14 が使用されます。 Auto を指定すると、可能な場合にサーバー バージョンが自動検出されます。検出されない場合は、既定の 14 がバージョンに使用されます。 SharePoint サイトに必要な最小バージョンは、英語以外で 15 です。-
Implementation: 省略可能。 使用する SharePoint コネクタのバージョンを指定します。 使用できる値は "2.0" または null です。 値が "2.0" の場合は、SharePoint コネクタの 2.0 実装が使用されます。 値が null の場合は、SharePoint コネクタの元の実装が使用されます。
SharePoint.Contentsの場合、元の実装では、ApiVersion値 14、15、および"Auto"がサポートされます。
ApiVersionが指定されていない場合は、バージョン 14 が使用されます。 実装 2.0 では、API バージョン 15 が自動的に使用されるため、 ApiVersion を指定する必要はありません。 API バージョン 14 は、実装 2.0 ではサポートされていません。
例 1
元の実装を使用して、最上位レベルのSharePointコンテンツを返します。 オプションが指定されていないため、API バージョン 14 が使用されます。
使用方法
SharePoint.Contents("https://contoso.sharepoint.com/sites/Contoso")
アウトプット
A hierarchical table containing the top-level folders and files in the site.
例 2
元の実装と API の自動選択を使用して、共有ドキュメント ライブラリ内のすべての .xlsx ファイルを返します。 拡張機能の比較では、大文字と小文字が区別されません。
使用方法
let
Source = SharePoint.Contents(
"https://contoso.sharepoint.com/sites/Contoso",
[ApiVersion = "Auto"]
),
SharedDocuments = Source{[Name = "Shared Documents"]}[Content],
ExcelWorkbooks = Table.SelectRows(
SharedDocuments,
each Comparer.OrdinalIgnoreCase([Extension], ".xlsx") = 0
)
in
ExcelWorkbooks
アウトプット
A table containing only the files in the Shared Documents library whose Extension value is .xlsx.
例 3
実装 2.0 を使用して、共有ドキュメント ライブラリのレポート フォルダーの直ちにコンテンツを返します。 実装 2.0 では、既定で API バージョン 15 が使用されます。
使用方法
let
Source = SharePoint.Contents(
"https://contoso.sharepoint.com/sites/Contoso",
[Implementation = "2.0"]
),
SharedDocuments = Source{[Name = "Shared Documents"]}[Content],
Reports = SharedDocuments{[Name = "Reports"]}[Content]
in
Reports
アウトプット
A hierarchical table containing the immediate folders and files in the Reports folder.
例 4
サイトの階層コンテンツ内を移動して、Budget.xlsx のバイナリ コンテンツを返します。
使用方法
let
Source = SharePoint.Contents(
"https://contoso.sharepoint.com/sites/Contoso",
[Implementation = "2.0"]
),
SharedDocuments = Source{[Name = "Shared Documents"]}[Content],
Reports = SharedDocuments{[Name = "Reports"]}[Content],
Budget = Reports{[Name = "Budget.xlsx"]}[Content]
in
Budget
アウトプット
The binary content of Budget.xlsx.