SharePoint.Files

Синтаксис

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

О нас

Возвращает таблицу, содержащую одну строку для каждого файла, найденного на указанном сайте SharePoint, urlвключая файлы в вложенных папках. В отличие от SharePoint.Contentsэтого, эта функция возвращает плоскую таблицу и не включает строки для папок. URL-адрес сайта не может содержать строку запроса или фрагмент. Каждая строка содержит двоичное содержимое файла в столбцах и метаданных файла в ContentDate modifiedNameDate accessedDate createdExtensionAttributesстолбцах , а также Folder Path столбцах. Это Folder Path значение является абсолютным URL-адресом папки, содержащей файл. options можно указать для управления следующими параметрами:

  • ApiVersion: число (14 или 15) или текст "Авто", указывающий версию API SharePoint, используемую для этого сайта. Если этот параметр не указан, используется API версии 14. При указании авто версия сервера будет автоматически обнаружена, если это возможно, в противном случае версия по умолчанию имеет значение 14. Для сайтов SharePoint, отличных от английского языка, требуется по крайней мере версия 15.

Пример 1

Выведите список имен, расширения файлов и URL-адреса папки для каждого файла на сайте contoso SharePoint с помощью автоматического выбора API.

Использование

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

Выходные данные

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

Пример 2

Возвращает каждый файл с расширением .xlsx сайта contoso SharePoint. В этом примере используется API версии 15, которая работает с сайтами SharePoint на английском и не английском языках. Сравнение расширений не учитывает регистр, поэтому он также соответствует .XLSX.

Использование

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

Выходные данные

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

Пример 3

Возвращает только файлы, хранящиеся непосредственно в папке Shared Documents/Reports . Folder Path Точное совпадение исключает файлы в вложенных папках.

Использование

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

Выходные данные

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

Пример 4

Возвращает двоичное содержимое Budget.xlsx из папки "Общие документы и отчеты".

Использование

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

Выходные данные

The binary content of Budget.xlsx.