SharePoint.Files

Sintaxe

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

Sobre nós

Devolve uma tabela contendo uma linha para cada ficheiro encontrado no site SharePoint especificado, url, incluindo ficheiros em subpastas. Ao contrário de SharePoint.Contents, esta função devolve uma tabela plana e não inclui linhas para pastas. O URL do site não pode conter uma string de consulta ou fragmento. Cada linha contém o conteúdo binário do ficheiro na Content coluna e os metadados do ficheiro nas Namecolunas , Extension, Date accessed, Date modified, Date created, Attributes, , e Folder Path nas colunas. O Folder Path valor é o URL absoluto da pasta que contém o ficheiro. options pode ser especificado para controlar as seguintes opções:

• ApiVersion: Um número (14 ou 15) ou o texto "Auto" que especifica a versão da API do SharePoint a ser usada para este site. Quando não especificado, a API versão 14 é usada. Quando Auto é especificado, a versão do servidor será descoberta automaticamente, se possível, caso contrário, a versão padrão é 14. Sites do SharePoint que não estejam em inglês exigem pelo menos a versão 15.

Exemplo 1

Liste o nome, extensão do ficheiro e URL da pasta para cada ficheiro no site SharePoint da Contoso usando a seleção automática da API.

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.

Exemplo 2

Devolva todos os ficheiros com a .xlsx extensão do site SharePoint da Contoso. Este exemplo utiliza a versão 15 da API, que funciona tanto com sites SharePoint em inglês como em não-inglês. A comparação de extensão é insensível a maiúsculas minúsculas, por isso também corresponde .XLSXa .

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.

Exemplo 3

Devolva apenas os ficheiros armazenados diretamente na Shared Documents/Reports pasta. Uma correspondência exata Folder Path exclui ficheiros em subpastas.

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.

Exemplo 4

Devolva o conteúdo binário de Budget.xlsx da pasta Documentos Partilhados/Relatórios.

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.