Eine Liste von Dateien aus einer CSV-Datei migrieren

Eine Liste, viele Quellen

Eine einzige CSV-Datei kann Dateien aus SharePoint-Websites, Teams, OneDrives und Dateifreigaben gemeinsam aufführen. Jede Datei wird dort gelesen, wo sie liegt.

Genau die Dateien, die Sie ausgewählt haben

Es wird nichts durchsucht: Der Auftrag übernimmt die Dateien auf der Liste, eine nach der anderen, und lässt alles andere, wo es ist.

Ein Ziel

Jede Datei landet im gewählten Ziel – einem Nextcloud-Teamordner oder den Dateien eines Benutzers – in den Ordnern, in denen sie an der Quelle lag.

Wann eine Dateiliste die richtige Quelle ist

Die meisten Aufträge lesen einen einzigen Quellort: eine Bibliothek, ein OneDrive oder eine Freigabe. Ein Auftrag vom Typ Dateiliste (CSV) ist für die Fälle gedacht, in denen es auf die Auswahl ankommt, nicht auf den Ort:

Nach der Analyse ausgewählte Dateien. Die Analyse und die Power-BI-Berichte zeigen, was vorhanden ist; filtern Sie die Dateien auf das ein, was verschoben werden soll – ein Projekt, einen Kunden, eine Aufbewahrungsklasse, alles seit einem bestimmten Datum Geänderte – und migrieren Sie nur diese.
Über viele Quellen verteilte Dateien. Eine Liste fasst Dokumente aus mehreren Websites, OneDrives und Freigaben in einem Teamordner zusammen, ohne einen Auftrag pro Quelle.
Ein zweiter Durchgang. Übernehmen Sie die Dateien, die eine erste Migration ausgelassen hat, oder die, die ein Fachverantwortlicher nachträglich angefordert hat, ohne die gesamte Quelle erneut zu verarbeiten.
Eine Liste aus einem anderen System. Jedes System, das eine CSV-Datei schreiben kann – ein Schriftgutverwaltungssystem, eine Tabellenkalkulation, ein Skript –, kann festlegen, welche Dateien migriert werden.

Die Auswahl steht in der CSV-Datei

Die Dateiauswahl wird durch die Liste festgelegt, nicht durch einen einzelnen Quellort. Der Auftrag hat keine eigene Quell-URL einer Bibliothek, keinen UNC-Pfad und keinen OneDrive-Benutzer: Jede Zeile der Liste gibt an, wo ihre Datei liegt.

Eine Liste oder eine Abfrage

Eine Dateiliste (CSV) ist eine Auswahl, die beim Export festgeschrieben wird. Wo die Auswahl den Dokumenten folgen soll – den Dateien, die heute ein Kriterium erfüllen, bei jedem Lauf des Auftrags –, übernimmt ein Auftrag vom Typ Dynamische BI-Datenabfrage sie direkt aus den BI-Daten, ohne Export und ohne Zeilenbegrenzung. Diese Funktion befindet sich in Entwicklung.

Siehe Dateien mit einer Power-BI- oder SQL-Abfrage auswählen

So funktioniert es

Dateien auswählen und als CSV exportieren
Grenzen Sie im Bericht Dateien in Power BI die Tabelle File details auf die gewünschten Dateien ein und exportieren Sie sie in eine CSV-Datei. Alternativ können Sie die CSV-Datei auch in einem beliebigen anderen System erstellen.
CSV-Datei in Nextcloud Files ablegen
Laden Sie sie in einen beliebigen Ordner in Nextcloud Files hoch. Die App liest sie von dort; in die App selbst wird nichts hochgeladen.
Migrationsauftrag mit `Source Type` `File List CSV` anlegen
Wählen Sie im Auftragsdialog Testmigration oder Migration als Modus, setzen Sie Source Type auf File List CSV und geben Sie den Link der CSV-Datei in File List Link an. Mit Datei auswählen können Sie die Datei auswählen oder hochladen.
Ziel auswählen
Einen Nextcloud-Teamordner oder einen Nextcloud-Benutzer und optional einen Ordner darin, wie bei jeder Migration.
Auftrag auf Bereit setzen
SMART Migration übernimmt den Auftrag, liest die Liste aus der App und migriert jede darin aufgeführte Datei.

Die Spalten der CSV-Datei

Die Liste ist eine CSV-Datei mit Kommas oder Semikolons zwischen den Spalten – je nachdem, welches Zeichen in der ersten Zeile häufiger vorkommt, sodass eine von einer Tabellenkalkulation in beliebiger Sprache gespeicherte Datei unverändert gelesen wird. Die erste Zeile enthält die Spaltenüberschriften; der Auftrag liest die Spalten anhand ihrer Überschriften, in beliebiger Reihenfolge und unabhängig von Groß- und Kleinschreibung – ein Doppelpunkt nach einer Überschrift, wie in Name:, wird überlesen – und lässt alle anderen Spalten unberührt, sodass auch ein Export mit vielen Spalten unverändert funktioniert.

Spalte	Erforderlich	Inhalt
`Name`	Immer	Der Dateiname, etwa `Budget 2026.xlsx` – oder, in einer Zeile ohne `Path`, die vollständige Adresse der Datei
`Path`	Optional	Der Ordner, in dem die Datei liegt: eine SharePoint- oder OneDrive-URL oder ein UNC-Pfad oder ein Laufwerk des SMART Migration-Servers, etwa `\\FS01\Finance\2026`

Mit Path

Path und Name werden zur Adresse der Datei zusammengefügt, mit dem einen Trennzeichen, das zur jeweiligen Art gehört – / in einer URL, \ in einem UNC- oder Laufwerkspfad –, unabhängig davon, ob Path bereits damit endet. Aus \\FS01\Finance\2026 und Budget 2026.xlsx wird \\FS01\Finance\2026\Budget 2026.xlsx

Nur mit Name

Name ist die vollständige URL, der UNC-Pfad oder der Laufwerkspfad der Datei, etwa https://contoso.sharepoint.com/sites/Finance/Shared Documents/Budget 2026.xlsx, \\FS01\Finance\2026\Budget 2026.xlsx oder c:\myfolder\my file.txt

Leerzeichen vor und nach einem Wert werden ignoriert, ebenso leere Zeilen. Eine andere Spalte darf Text in Anführungszeichen über mehrere Zeilen enthalten; er wird als eine Zelle gelesen. Eine Liste mit Überschriften, aber ohne Dateien darunter, ist eine leere Liste und kein Fehler.

Was die Prüfung ablehnt

Eine Datei ohne Überschrift Name – oder deren Spalten durch etwas anderes als Kommas oder Semikolons getrennt sind –, eine Zeile ohne Name, ein Path, der kein Ordner ist, ein Name unter einem Path, der kein Dateiname ist (eine vollständige Adresse oder eines der Zeichen : * ? " < > | darin), und eine ungültige Dateiadresse: Eine URL braucht http:// oder https://, einen Host, mindestens einen Ordner – die Bibliothek – und die Datei, sodass ein Path, der nur aus einem Host besteht, wie https://contoso, abgelehnt wird; ein UNC-Pfad braucht einen Server, eine Freigabe und die Datei; ein Laufwerkspfad einen Laufwerksbuchstaben und die Datei, etwa c:\myfolder\my file.txt – und keiner von ihnen darf ein Zeichen enthalten, das Windows in einem Namen nicht zulässt. Der Auftrag wird nicht validiert und kann nicht auf Bereit gesetzt werden, bis die Datei korrigiert ist.

Schritt 1 – Dateien aus Power BI exportieren

Öffnen Sie in Power BI den Bericht „Dateien“ und grenzen Sie die Tabelle File details mit den Datenschnitten und Filtern der Seite genau auf die gewünschten Dateien ein: nach Website, Bibliothek, Besitzer, Dateityp, Größe, Alter oder einer anderen Spalte, die der Bericht anbietet.

Exportieren Sie diese Zeilen anschließend mit dem standardmäßigen Power-BI-Export oben rechts in der Tabelle: Weitere Optionen (…) → Daten exportieren → eine CSV-Datei.

Tipp: höchstens 30.000 Dateien pro Power-BI-Export

Power BI exportiert höchstens 30.000 Zeilen in eine CSV-Datei, in Power BI Desktop wie im Power-BI-Dienst, und lässt den Rest weg. Halten Sie jede Auswahl darunter – jeweils eine Website, eine Bibliothek oder einen Besitzer – und geben Sie jedem Teil einen eigenen Auftrag vom Typ Dateiliste (CSV) in derselben Gruppe. Zeigt der Auftragsdialog Gefunden: … mit 30000 aufgeführten Dateien, wurde die Liste mit ziemlicher Sicherheit abgeschnitten.

Schritt für Schritt, in Power BI Desktop und im Power-BI-Dienst, mit Wegen, die Begrenzung zu umgehen: Eine Dateiliste aus Power BI exportieren

Was die exportierte CSV-Datei enthält

Jede Zeile ist eine Datei, mit ihrem Name und ihrem Path an der Quelle neben den übrigen Spalten der Tabelle. Eine Datei kann Dateien aus SharePoint-, OneDrive- und Dateifreigabe-Quellen gemeinsam enthalten. Power BI exportiert mit Kommas zwischen den Spalten; eine mit Semikolons gespeicherte Datei wird ebenso gelesen.

Der Bericht beruht auf dem, was die Analyse und frühere Läufe gefunden haben; führen Sie daher zuerst eine Analyse der Quellen durch, wenn die gewünschten Dateien noch nicht im Bericht stehen. Siehe Analyse und Business Intelligence mit Power BI

Eine Liste aus einem anderen System

Die CSV-Datei muss nicht aus Power BI stammen. Jedes System – ein Schriftgutverwaltungssystem, eine Tabellenkalkulation, ein Skript – kann sie erstellen, sofern sie eine Spalte Name hat, dazu eine Spalte Path oder vollständige Pfade in Name, und Kommas oder Semikolons zwischen den Spalten. Eine Tabellenkalkulation in einer Sprache, die Dezimalzahlen mit Komma schreibt, speichert mit Semikolons: Das funktioniert unverändert.

Schritt 2 – CSV-Datei in Nextcloud ablegen und mit dem Auftrag verknüpfen

Laden Sie die CSV-Datei in Nextcloud Files hoch – in einen beliebigen Ordner, in Ihren eigenen Dateien oder in einem Teamordner. Gehen Sie dann im Schritt Quelle des Auftragsdialogs wie folgt vor:

Setzen Sie Source Type auf File List CSV.
Klicken Sie auf Datei auswählen und wählen Sie die CSV-Datei aus – oder laden Sie sie im selben Fenster von Ihrem Computer hoch, über Datei hochladen oder per Drag & Drop. Ihr interner Link wird in File List Link eingetragen
Oder legen Sie dort eine neue Liste an: Hier neue CSV-Datei erstellen erzeugt im angezeigten Ordner FileList01.csv – oder die nächste freie Nummer – mit der einzigen Spaltenüberschrift Name und verknüpft sie mit dem Auftrag. Öffnen Sie sie mit Datei öffnen, tragen Sie die Dateien zeilenweise als vollständige URL, UNC-Pfad oder Laufwerkspfad ein, speichern Sie und verwenden Sie Vorschau aktualisieren.
Oder fügen Sie den Link selbst ein: Öffnen Sie in Files das Menü Teilen der Datei und kopieren Sie ihren internen Link, etwa https://cloud.example.com/f/12345

Der Dialog prüft daraufhin die Datei und zeigt an, was er gefunden hat:

Der Dialog zeigt	Bedeutung
Datei: sowie Ordner und Dateiname	Wohin der Link in Nextcloud Files führt – klicken Sie auf den Ordner, um ihn zu öffnen
Gefunden: … mit n Dateien	Die Datei ist eine CSV-Datei, und n Zeilen unter ihren Überschriften benennen jeweils eine Datei
Vorschau: die ersten … Zeilen	Die ersten Zeilen der Datei, so wie die Prüfung sie gelesen hat, zuerst `Name` und `Path`, dann die übrigen Spalten – eine von der Prüfung abgelehnte Zelle ist markiert
Eine Meldung in Rot	Was falsch ist: keine Datei unter dem Link, ein Ordner, keine CSV-Datei, keine Spalte `Name`, keine Dateien aufgeführt, oder die erste Zeile mit fehlendem `Name`, einem `Name`, der kein Dateiname ist, oder einem `Path`, der kein Ordner ist, mit der Anzahl der fehlerhaften Zeilen – die betreffende Zelle ist in der Vorschau markiert

Liste ändern

Bearbeiten Sie die Datei oder ersetzen Sie sie in Nextcloud Files unter demselben Namen: Der Link bleibt gleich, und der nächste Lauf liest die neue Liste. Datei öffnen öffnet sie in einem neuen Browser-Tab; nachdem Sie sie dort gespeichert haben, liest Vorschau aktualisieren sie im Dialog erneut ein.

In der Tabelle Aufträge und auf der Übersichtskarte des Auftrags wird als Quelle des Auftrags der Speicherort der Liste in Nextcloud Files angezeigt, etwa /Reports/FileList01.csv – nicht ihr Link –, sodass Sie sehen, welche Liste jeder Auftrag liest. Ein Link, der zu keiner Datei führt, wird unverändert angezeigt.

Was der Auftrag liest und was er ignoriert

Unterordner einbeziehen und Leere Ordner einbeziehen werden nicht angeboten: Eine Liste nennt jede Datei einzeln, daher gibt es keine Ordner zu durchlaufen und keine, die leer neu angelegt werden müssten.
Versionsverlauf einbeziehen und Umfang des Versionsverlaufs gelten für die Dateien, die Versionen führen – die aus SharePoint und OneDrive.
Ein Auftrag vom Typ Dateiliste (CSV) ist eine Testmigration – die die aufgeführten Dateien prüft, ohne etwas zu schreiben – oder eine Migration, die sie kopiert. Für Analyse wird er nicht angeboten: Die Liste ist das, woraus Sie nach einer Analyse auswählen, nicht etwas, das analysiert werden muss. Ein Auftrag vom Typ Analyse bietet diese Auswahl nicht an, und ein Auftrag vom Typ Dateiliste (CSV), der nachträglich auf Analyse umgestellt wird, wird nicht validiert.

Siehe Quellen und Aufträge und Auftragsmodi

So wird die Ordnerstruktur am Ziel wiederhergestellt

Enthält die Liste eine Spalte Relative Path – beim Export von File details aus Power BI ist das der Fall: der Pfad der Datei relativ zum Startpunkt des Quellscans, der sie gefunden hat –, werden die Ordner jeder Datei am Ziel daraus neu aufgebaut. Die Dateien behalten so ihre Ordnerstruktur am Ziel, obwohl sie aus verschiedenen Quellen zusammengetragen wurden.

Dateien mit demselben relativen Pfad

Zwei Dateien aus verschiedenen Quellen mit demselben Relative Path und Namen würden am Ziel an derselben Stelle landen. Prüfen Sie die Liste vor dem Lauf des Auftrags auf solche Paare, oder teilen Sie sie auf zwei Aufträge mit jeweils eigenem Destination Folder auf.

Siehe Ziele und Regeln für das Hinzufügen und Überschreiben von Dateien

Was passiert, wenn der Auftrag übernommen wird

Wenn SMART Migration einen Auftrag vom Typ Dateiliste (CSV) übernimmt, liest die App die Liste erneut und prüft jede Zeile. So wird ein Fehler, der nach dem Speichern des Auftrags entstanden ist, gefunden, bevor etwas ausgeführt wird.

Die Liste wird aufbewahrt
Die CSV-Datei wird in dem Stand, den sie zu diesem Zeitpunkt hatte, in den Ordner des Laufs in SMART Migration Reports kopiert. Auch Jahre später zeigt der Lauf noch genau, welche Dateien er migrieren sollte, selbst wenn die Liste in Dateien inzwischen geändert wurde.
Die Liste wird nach dem Speicherort der Dateien aufgeteilt
Daneben werden zwei Dateien geschrieben: csv_url.csv mit den SharePoint- und OneDrive-Dateien und csv_unc.csv mit den Pfaden auf Dateifreigaben und Laufwerken. Jede hat eine Spalte, Name, die die vollständige Adresse jeder Datei enthält – Path und Name zusammengefügt – mit TAB als Trennzeichen, unabhängig davon, welches Trennzeichen die Liste verwendet hat. Eine Datei wird nur geschrieben, wenn die Liste Dateien der entsprechenden Art enthält.
SMART Migration erhält die Links
Mit der Übernahme erhält SMART Migration den Auftrag zusammen mit den internen Nextcloud-Links zu diesen beiden Dateien, und SMART Migration migriert die darin genannten Dateien.

Eine fehlerhafte Liste beendet den Lauf mit Fehler

Wenn die Datei fehlt oder die Prüfung nicht besteht, wird der Auftrag nicht an SMART Migration übergeben. Sein Lauf endet sofort mit dem Ergebnis Fehler und einer Meldung, die angibt, was falsch ist – die Zeile und den Wert oder die fehlende Spalte. Diese Meldung wird im Laufverlauf und im Tooltip des Auftrags angezeigt. Korrigieren Sie die Datei in Dateien und setzen Sie den Auftrag dann wieder auf Bereit.

Siehe Berichte und Laufordner in Nextcloud Dateien und Laufverlauf

SMART Migration kann die Liste auch selbst über die App lesen – GET /api/v1/jobs/{id}/file-list –, sodass das dafür verwendete Konto keinen eigenen Zugriff auf den Ordner benötigt, in dem die CSV-Datei liegt.

Siehe auch

Eine Dateiliste aus Power BI exportieren
Quellen
Eine Migration planen und durchführen, Welle für Welle
Aufträge aus einer CSV-Datei importieren – eine andere CSV-Datei: eine, die zu erstellende Aufträge auflistet, nicht zu migrierende Dateien