Migrer une liste de fichiers depuis un fichier CSV

Une liste, de nombreuses sources

Un seul fichier CSV peut désigner à la fois des fichiers provenant de sites SharePoint, de Teams, d'espaces OneDrive et de partages de fichiers. Chaque fichier est lu à l'endroit où il se trouve.

Exactement les fichiers que vous avez choisis

Rien n'est analysé : la tâche prend les fichiers de la liste, un par un, et laisse tout le reste en place.

Une seule destination

Chaque fichier arrive dans la destination que vous choisissez, un Dossier d'équipe Nextcloud ou les fichiers d'un utilisateur, dans les dossiers qu'il occupait à la source.

Quand une liste de fichiers est la bonne source

La plupart des tâches lisent un seul emplacement source : une bibliothèque, un espace OneDrive ou un partage. Une tâche Liste de fichiers CSV est destinée aux cas où c'est la sélection, et non l'emplacement, qui compte :

Des fichiers choisis après l'analyse. L'Analyse et les Rapports Power BI montrent ce qui existe ; filtrez les fichiers jusqu'à ne garder que ce qui doit être déplacé (un projet, un client, une catégorie de conservation, tout ce qui a été modifié depuis une date) et migrez uniquement ceux-là.
Des fichiers répartis sur de nombreuses sources. Une seule liste rassemble des documents de plusieurs sites, espaces OneDrive et partages dans un seul Dossier d'équipe, sans une tâche par source.
Un second passage. Récupérez les fichiers qu'une première migration a laissés de côté, ou ceux qu'un responsable métier a demandés par la suite, sans réexécuter toute la source.
Une liste provenant d'un autre système. Tout système capable d'écrire un fichier CSV (un système d'archivage, un tableur, un script) peut indiquer quels fichiers migrer.

La sélection se trouve dans le fichier CSV

La sélection des fichiers est définie par la liste, et non par un emplacement source unique. La tâche n'a ni URL source de bibliothèque, ni chemin UNC, ni utilisateur OneDrive qui lui soit propre : chaque ligne de la liste indique où se trouve son fichier.

Une liste, ou une requête

Une Liste de fichiers CSV est une sélection figée au moment de son export. Lorsque la sélection doit suivre les documents, c'est-à-dire les fichiers qui répondent à un critère aujourd'hui, à chaque exécution de la tâche, une tâche Requête dynamique sur les données BI la prend directement dans les données BI, sans export ni limite de lignes. Elle est en cours de développement.

Voir Sélectionner des fichiers avec une requête Power BI ou SQL

Fonctionnement

Sélectionnez les fichiers et exportez-les au format CSV
Dans le rapport Fichiers de Power BI, réduisez la table File details aux fichiers souhaités, puis exportez-la vers un fichier CSV, ou rédigez le fichier CSV dans tout autre système.
Placez le fichier CSV dans Nextcloud Files
Téléversez-le dans n'importe quel dossier de Nextcloud Files. L'application le lit à cet endroit ; rien n'est téléversé dans l'application elle-même.
Créez une tâche de migration avec `Source Type` `File List CSV`
Dans la boîte de dialogue de la tâche, choisissez Migration de test ou Migration comme mode, réglez Source Type sur File List CSV et indiquez le lien du fichier CSV dans File List Link ; Choisir un fichier le sélectionne, ou le téléverse, pour vous.
Choisissez la destination
Un Dossier d'équipe Nextcloud ou un utilisateur Nextcloud, et éventuellement un dossier à l'intérieur, comme pour toute migration.
Passez la tâche à l'état Prêt
SMART Migration prend en charge la tâche, lit la liste depuis l'application et migre chacun des fichiers qui y figurent.

Les colonnes du fichier CSV

La liste est un fichier CSV dont les colonnes sont séparées par des virgules ou des points-virgules, selon le séparateur le plus fréquent sur sa première ligne : un fichier enregistré par un tableur dans n'importe quelle langue est donc lu tel quel. Sa première ligne contient les en-têtes de colonnes ; la tâche lit les colonnes d'après leurs en-têtes, dans n'importe quel ordre et quelle que soit la casse (un deux-points après un en-tête, comme dans Name:, est ignoré), et laisse de côté toutes les autres colonnes : un export comportant de nombreuses colonnes fonctionne donc tel quel.

Colonne	Requise	Contenu
`Name`	Toujours	Le nom du fichier, par exemple `Budget 2026.xlsx`, ou, sur une ligne sans `Path`, l'adresse complète du fichier
`Path`	Facultative	Le dossier où se trouve le fichier : une URL SharePoint ou OneDrive, ou un chemin UNC ou un lecteur du serveur SMART Migration, par exemple `\\FS01\Finance\2026`

Avec un Path

Path et Name sont assemblés pour former l'adresse du fichier, avec le séparateur propre à son type (/ dans une URL, \ dans un chemin UNC ou de lecteur), que Path se termine ou non par celui-ci. \\FS01\Finance\2026 et Budget 2026.xlsx donnent \\FS01\Finance\2026\Budget 2026.xlsx

Avec Name seul

Name est l'URL complète, le chemin UNC ou le chemin de lecteur du fichier, par exemple https://contoso.sharepoint.com/sites/Finance/Shared Documents/Budget 2026.xlsx, \\FS01\Finance\2026\Budget 2026.xlsx ou c:\myfolder\my file.txt

Les espaces avant et après une valeur sont ignorés, de même que les lignes vides. Une autre colonne peut contenir du texte entre guillemets sur plusieurs lignes ; il est lu comme une seule cellule. Une liste comportant des en-têtes mais aucun fichier en dessous est une liste vide, et non une erreur.

Ce que la vérification refuse

Un fichier sans en-tête Name, ou dont les colonnes sont séparées par autre chose que des virgules ou des points-virgules ; une ligne sans Name ; un Path qui n'est pas un dossier ; un Name placé sous un Path qui n'est pas un nom de fichier (une adresse complète, ou contenant l'un des caractères : * ? " < > |) ; et une adresse de fichier non valide : une URL exige http:// ou https://, un hôte, au moins un dossier (la bibliothèque) et le fichier, de sorte qu'un Path réduit à un hôte, comme https://contoso, est refusé ; un chemin UNC exige un serveur, un partage et le fichier ; un chemin de lecteur exige une lettre de lecteur et le fichier, par exemple c:\myfolder\my file.txt, et aucun d'eux ne doit contenir un caractère que Windows refuse dans un nom. La tâche n'est pas validée et ne peut pas passer à l'état Prêt tant que le fichier n'a pas été corrigé.

Étape 1 — Exporter les fichiers depuis Power BI

Ouvrez le rapport Fichiers dans Power BI et réduisez la table File details exactement aux fichiers souhaités, à l'aide des segments et des filtres de la page : par site, bibliothèque, propriétaire, type de fichier, taille, ancienneté ou toute autre colonne proposée par le rapport.

Exportez ensuite ces lignes avec la fonction d'export standard de Power BI, dans l'angle supérieur droit de la table : Plus d'options (…) → Exporter des données → un fichier CSV.

Astuce : 30 000 fichiers au maximum par export Power BI

Power BI exporte au maximum 30 000 lignes dans un fichier CSV, dans Power BI Desktop comme dans le service Power BI, et ignore le reste. Maintenez chaque sélection en dessous de ce seuil (un site, une bibliothèque ou un propriétaire à la fois) et attribuez à chaque partie sa propre tâche Liste de fichiers CSV, dans le même groupe. Lorsque la boîte de dialogue de la tâche affiche Trouvé : … répertoriant 30000 fichiers, la liste a presque certainement été tronquée.

Pas à pas, dans Power BI Desktop et dans le service Power BI, avec les moyens de contourner la limite : Exporter une liste de fichiers depuis Power BI

Contenu du fichier CSV exporté

Chaque ligne correspond à un fichier, avec son Name et son Path à la source parmi les autres colonnes de la table. Un même fichier peut contenir à la fois des fichiers issus de sources SharePoint, OneDrive et de partages de fichiers. Power BI exporte avec des virgules entre les colonnes ; un fichier enregistré avec des points-virgules est lu tout aussi bien.

Le rapport est construit à partir de ce que l'Analyse et les exécutions précédentes ont trouvé : lancez donc d'abord l'Analyse sur les sources si les fichiers souhaités ne figurent pas encore dans le rapport. Voir Analyse et Informatique décisionnelle avec Power BI

Une liste provenant d'un autre système

Le fichier CSV ne doit pas nécessairement provenir de Power BI. Tout système (un système d'archivage, un tableur, un script) peut l'écrire, à condition qu'il comporte une colonne Name, avec une colonne Path ou des chemins complets dans Name, et des virgules ou des points-virgules entre les colonnes. Un tableur configuré dans une langue qui utilise la virgule comme séparateur décimal enregistre avec des points-virgules : cela fonctionne tel quel.

Étape 2 — Placer le fichier CSV dans Nextcloud et le lier à la tâche

Téléversez le fichier CSV dans Nextcloud Files, dans n'importe quel dossier, parmi vos propres fichiers ou dans un Dossier d'équipe. Ensuite, à l'étape Source de la boîte de dialogue de la tâche :

Réglez Source Type sur File List CSV.
Cliquez sur Choisir un fichier et sélectionnez le fichier CSV, ou téléversez-le depuis votre ordinateur dans la même fenêtre, avec Téléverser un fichier ou en le déposant à cet endroit. Son lien interne est inscrit dans File List Link
Ou commencez une nouvelle liste à cet endroit : Créer un nouveau fichier CSV ici crée FileList01.csv (ou le numéro libre suivant) dans le dossier affiché, avec le seul en-tête de colonne Name, et le lie à la tâche. Ouvrez-le avec Ouvrir le fichier, ajoutez les fichiers un par ligne sous forme d'URL complète, de chemin UNC ou de chemin de lecteur, enregistrez, puis utilisez Actualiser l'aperçu.
Ou collez le lien vous-même : ouvrez le menu Partager du fichier dans Fichiers et copiez son lien interne, par exemple https://cloud.example.com/f/12345

La boîte de dialogue vérifie alors le fichier et affiche ce qu'elle a trouvé :

La boîte de dialogue affiche	Signification
Fichier : suivi du dossier et du nom de fichier	L'emplacement vers lequel pointe le lien dans Nextcloud Files ; cliquez sur le dossier pour l'ouvrir
Trouvé : … répertoriant n fichiers	Le fichier est un fichier CSV, et n lignes sous ses en-têtes désignent chacune un fichier
Aperçu : les … premières lignes	Les premières lignes du fichier telles que la vérification les a lues, `Name` et `Path` en premier, puis les autres colonnes ; une cellule refusée par la vérification est signalée
Un message en rouge	Le problème : aucun fichier à l'adresse du lien, un dossier, pas un fichier CSV, pas de colonne `Name`, aucun fichier répertorié, ou bien la première ligne présentant un `Name` manquant, un `Name` qui n'est pas un nom de fichier ou un `Path` qui n'est pas un dossier, avec le nombre de lignes posant problème ; la cellule fautive est signalée dans l'aperçu

Modifier la liste

Modifiez le fichier, ou remplacez-le dans Nextcloud Files sous le même nom : le lien reste identique et la prochaine exécution lit la nouvelle liste. Ouvrir le fichier l'ouvre dans un nouvel onglet du navigateur ; après l'avoir enregistré à cet endroit, Actualiser l'aperçu le relit dans la boîte de dialogue.

Dans le tableau Tâches et sur la carte récapitulative de la tâche, la source de la tâche est l'emplacement de la liste dans Nextcloud Files, par exemple /Reports/FileList01.csv, et non son lien : vous voyez ainsi quelle liste chaque tâche lit. Un lien qui ne mène à aucun fichier est affiché tel quel.

Ce que la tâche lit et ce qu'elle ignore

Inclure les sous-dossiers et Inclure les dossiers vides ne sont pas proposés : une liste désigne chaque fichier individuellement, il n'y a donc aucun dossier à parcourir ni aucun dossier vide à recréer.
Inclure l'historique des versions et Portée de l'historique des versions s'appliquent aux fichiers qui conservent des versions, c'est-à-dire ceux provenant de SharePoint et de OneDrive.
Une tâche Liste de fichiers CSV est une Migration de test, qui vérifie les fichiers répertoriés sans rien écrire, ou une Migration, qui les copie. Elle n'est pas proposée pour l'Analyse : la liste est ce qu'une analyse vous donne pour faire votre choix, et non quelque chose à analyser. Une tâche d'Analyse n'affiche pas ce choix, et une tâche Liste de fichiers CSV basculée ensuite en Analyse n'est pas validée.

Voir Sources et Les tâches et leurs modes

Comment l'arborescence des dossiers est recréée à la destination

Lorsque la liste comporte une colonne Relative Path (c'est le cas de l'export de la table File details de Power BI : le chemin du fichier relatif au point de départ de l'analyse de la source qui l'a trouvé), les dossiers de chaque fichier à la destination sont reconstruits à partir de celle-ci. Les fichiers conservent alors leur organisation de dossiers à la destination, même s'ils ont été rassemblés depuis des sources différentes.

Fichiers ayant le même chemin relatif

Deux fichiers provenant de sources différentes et ayant le même Relative Path et le même nom arriveraient au même endroit à la destination. Recherchez de telles paires dans la liste avant l'exécution de la tâche, ou scindez-la en deux tâches dotées chacune d'un Destination Folder.

Voir Destinations et Règles d'ajout et d'écrasement des fichiers

Ce qui se passe lorsque la tâche est prise en charge

Lorsque SMART Migration prend en charge une tâche Liste de fichiers CSV, l'application relit la liste et vérifie chaque ligne. Une erreur introduite après l'enregistrement de la tâche est ainsi détectée avant toute exécution.

La liste est conservée
Le fichier CSV est copié dans le dossier de l'exécution, dans SMART Migration Reports, tel qu'il était à ce moment-là. Des années plus tard, l'exécution indique toujours exactement quels fichiers elle devait migrer, même si la liste dans Fichiers a été modifiée depuis.
La liste est répartie selon l'emplacement des fichiers
Deux fichiers sont écrits à côté : csv_url.csv avec les fichiers SharePoint et OneDrive, et csv_unc.csv avec les chemins de partages de fichiers et de lecteurs. Chacun comporte une seule colonne, Name, qui contient l'adresse complète de chaque fichier, soit Path et Name réunis. Le séparateur est la tabulation, quel que soit celui de la liste. Un fichier n'est écrit que si la liste contient des fichiers de ce type.
SMART Migration reçoit les liens
La prise en charge transmet à SMART Migration la tâche avec les liens internes de Nextcloud vers ces deux fichiers, et SMART Migration migre les fichiers qu'ils désignent.

Une liste comportant une erreur termine l'exécution en Erreur

Si le fichier a disparu ou ne passe pas la vérification, la tâche n'est pas transmise à SMART Migration. Son exécution se termine immédiatement avec le résultat Erreur et un message qui indique le problème : la ligne et la valeur, ou la colonne manquante. Ce message s'affiche dans Historique d'exécution et dans l'infobulle de la tâche. Corrigez le fichier dans Fichiers, puis repassez la tâche à Prêt.

Voir Rapports et dossiers d'exécution dans Fichiers Nextcloud et Historique d'exécution

SMART Migration peut aussi lire la liste lui-même via l'application, avec GET /api/v1/jobs/{id}/file-list. Le compte qu'il utilise n'a donc besoin d'aucun accès propre au dossier qui contient le fichier CSV.

Voir aussi

Exporter une liste de fichiers depuis Power BI
Sources
Planifier et mener une migration, vague par vague
Importer des tâches depuis un fichier CSV — un autre fichier CSV : il liste les tâches à créer, et non les fichiers à migrer