SharePoint.Files

Syntax

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

About

Gibt eine Tabelle zurück, die eine Zeile für jede Datei enthält, die auf der angegebenen SharePoint-Website gefunden wird, urleinschließlich Dateien in Unterordnern. Im Gegensatz dazu SharePoint.Contentsgibt diese Funktion eine flache Tabelle zurück und enthält keine Zeilen für Ordner. Die Website-URL kann keine Abfragezeichenfolge oder ein Fragment enthalten. Jede Zeile enthält den binären Inhalt der Datei in den Content Spalten- und Dateimetadaten in den NameSpalten , Extension, , Date accessed, Date modified, Date created, und AttributesFolder Path Spalten. Der Folder Path Wert ist die absolute URL des Ordners, der die Datei enthält. options kann angegeben werden, um die folgenden Optionen zu steuern:

  • ApiVersion: Eine Zahl (14 oder 15) oder der Text "Auto", der die SharePoint-API-Version angibt, die für diese Website verwendet werden soll. Wenn nicht angegeben, wird API Version 14 verwendet. Wenn "Auto" angegeben wird, wird die Serverversion nach Möglichkeit automatisch ermittelt, andernfalls wird die Version standardmäßig auf 14 festgelegt. Nicht englische SharePoint-Websites erfordern mindestens Version 15.

Beispiel 1

Listen Sie den Namen, die Dateierweiterung und die Ordner-URL für jede Datei auf der Contoso-SharePoint-Website mithilfe der automatischen API-Auswahl auf.

Usage

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.

Beispiel 2

Gibt jede Datei mit der .xlsx Erweiterung von contoso SharePoint-Website zurück. In diesem Beispiel wird api Version 15 verwendet, die sowohl mit englischen als auch mit nicht englischen SharePoint Websites funktioniert. Bei dem Erweiterungsvergleich wird die Groß-/Kleinschreibung nicht beachtet, sodass sie auch übereinstimmen .XLSX.

Usage

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.

Beispiel 3

Gibt nur die Dateien zurück, die Shared Documents/Reports direkt im Ordner gespeichert sind. Eine genaue Folder Path Übereinstimmung schließt Dateien in Unterordnern aus.

Usage

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.

Beispiel 4

Gibt den binären Inhalt Budget.xlsx aus dem Ordner "Freigegebene Dokumente/Berichte" zurück.

Usage

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.