SharePoint.Files

Syntaxe

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

À propos

Retourne une table contenant une ligne pour chaque fichier trouvé sur le site SharePoint spécifié, urly compris les fichiers dans les sous-dossiers. Contrairement SharePoint.Contentsà , cette fonction retourne une table plate et n'inclut pas de lignes pour les dossiers. L’URL du site ne peut pas contenir de chaîne ou de fragment de requête. Chaque ligne contient le contenu binaire du fichier dans la Content colonne et les métadonnées de fichier dans les Namecolonnes , , , Date accessedDate modifiedExtension, Date createdAttributeset Folder Path les colonnes. La Folder Path valeur est l’URL absolue du dossier qui contient le fichier. options peut être spécifiée pour contrôler les options suivantes :

  • ApiVersion: nombre (14 ou 15) ou texte « Auto » qui spécifie la version de l’API SharePoint à utiliser pour ce site. Lorsqu’elle n’est pas spécifiée, l’API version 14 est utilisée. Lorsque l’option Auto est spécifiée, la version du serveur est automatiquement découverte si possible, sinon la version est définie sur 14. Les sites SharePoint non anglais nécessitent au moins la version 15.

Exemple 1 :

Répertoriez le nom, l’extension de fichier et l’URL du dossier pour chaque fichier du site SharePoint Contoso à l’aide de la sélection automatique de l’API.

Usage

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

Sortie

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

Exemple 2

Retournez chaque fichier avec l’extension .xlsx à partir du site SharePoint Contoso. Cet exemple utilise l’API version 15, qui fonctionne avec les sites SharePoint anglais et non anglais. La comparaison d’extensions ne respecte pas la casse. Elle correspond .XLSXdonc également.

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

Sortie

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

Exemple 3

Retournez uniquement les fichiers stockés directement dans le Shared Documents/Reports dossier. Une correspondance exacte Folder Path exclut les fichiers dans les sous-dossiers.

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

Sortie

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

Exemple 4

Retournez le contenu binaire de Budget.xlsx à partir du dossier Documents/Rapports partagés.

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

Sortie

The binary content of Budget.xlsx.