SharePoint.Files

Składnia

SharePoint.Files(url as text, optional options as nullable record) as table

Informacje

Zwraca tabelę zawierającą jeden wiersz dla każdego pliku znalezionego w określonej lokacji SharePoint, urlw tym pliki w podfolderach. W przeciwieństwie do SharePoint.Contentsfunkcji ta funkcja zwraca płaską tabelę i nie zawiera wierszy dla folderów. Adres URL witryny nie może zawierać ciągu zapytania ani fragmentu. Każdy wiersz zawiera zawartość binarną pliku w Content kolumnie i metadanych pliku w Namekolumnach , , Date modifiedDate createdAttributesExtensionDate accessedi .Folder Path Wartość Folder Path jest bezwzględnym adresem URL folderu zawierającego plik. options można określić w celu kontrolowania następujących opcji:

• ApiVersion: liczba (14 lub 15) lub tekst "Auto", który określa wersję interfejsu API programu SharePoint do użycia dla tej witryny. Jeśli nie określono wersji, używana jest wersja 14 API. Po określeniu opcji Auto wersja serwera zostanie automatycznie odnaleziona, jeśli to możliwe, w przeciwnym razie zostanie ustawiona domyślna wersja na 14. Witryny programu SharePoint inne niż angielskie wymagają co najmniej wersji 15.

Przykład 1

Wyświetl nazwę, rozszerzenie pliku i adres URL folderu dla każdego pliku w witrynie firmy Contoso SharePoint przy użyciu automatycznego wyboru interfejsu API.

Użycie

let
    Source = SharePoint.Files(
        "https://contoso.sharepoint.com/sites/Contoso",
        [ApiVersion = "Auto"]
    ),
    SelectedColumns = Table.SelectColumns(
        Source,
        {"Name", "Extension", "Folder Path"}
    )
in
    SelectedColumns

Output

A table containing the name, extension, and absolute folder URL for each file in the site and its subfolders.

Przykład 2

Zwróć każdy plik z .xlsx rozszerzeniem z witryny contoso SharePoint. W tym przykładzie użyto interfejsu API w wersji 15, która współpracuje z witrynami SharePoint w języku angielskim i nieanglojęzycznym. Porównanie rozszerzeń jest niewrażliwe na wielkość liter, więc jest również zgodne z parametrem .XLSX.

Użycie

let
    Source = SharePoint.Files(
        "https://contoso.sharepoint.com/sites/Contoso",
        [ApiVersion = 15]
    ),
    ExcelWorkbooks = Table.SelectRows(
      Source,
      each Comparer.OrdinalIgnoreCase([Extension], ".xlsx") = 0
    )
  in
    ExcelWorkbooks

Output

A table containing every .xlsx file in the site and its subfolders.

Przykład 3

Zwróć tylko pliki przechowywane bezpośrednio w folderze Shared Documents/Reports . Dokładne Folder Path dopasowanie wyklucza pliki w podfolderach.

Użycie

let
    Source = SharePoint.Files("https://contoso.sharepoint.com/sites/Contoso"),
    ReportsFiles = Table.SelectRows(
        Source,
        each [Folder Path] = "https://contoso.sharepoint.com/sites/Contoso/Shared Documents/Reports/"
    )
in
    ReportsFiles

Output

A table containing only the files stored directly in the Reports folder.

Przykład 4

Zwróć zawartość binarną Budget.xlsx z folderu Dokumenty udostępnione/raporty.

Użycie

let
    Source = SharePoint.Files("https://contoso.sharepoint.com/sites/Contoso"),
    Budget = Source{
      [
        Name = "Budget.xlsx",
        #"Folder Path" = "https://contoso.sharepoint.com/sites/Contoso/Shared Documents/Reports/"
      ]
    }[Content]
  in
    Budget

Output

The binary content of Budget.xlsx.