Een lijst met bestanden uit een CSV-bestand migreren

Eén lijst, veel bronnen

Eén CSV-bestand kan bestanden uit SharePoint-sites, Teams, OneDrives en bestandsshares samen bevatten. Elk bestand wordt gelezen op de plek waar het staat.

Precies de bestanden die u hebt gekozen

Er wordt niets gescand: de job neemt de bestanden op de lijst één voor één en laat al het andere staan waar het staat.

Eén bestemming

Elk bestand komt terecht in de bestemming die u kiest, een Nextcloud Team Folder of de bestanden van een gebruiker, in de mappen die het bij de bron had.

Wanneer een lijst met bestanden de juiste bron is

De meeste jobs lezen één bronlocatie: een bibliotheek, een OneDrive of een share. Een File List CSV-job is bedoeld voor situaties waarin het om de selectie gaat en niet om de locatie:

Bestanden gekozen na Discovery. Discovery en de Power BI-rapporten laten zien wat er is. Filter de bestanden tot wat verplaatst moet worden, zoals een project, een klant, een bewaarklasse of alles wat sinds een bepaalde datum is gewijzigd, en migreer alleen die.
Bestanden verspreid over veel bronnen. Eén lijst brengt documenten uit meerdere sites, OneDrives en shares samen in één Team Folder, zonder een job per bron.
Een tweede ronde. Haal de bestanden over die een eerste migratie heeft overgeslagen, of de bestanden waar een business owner achteraf om heeft gevraagd, zonder de hele bron opnieuw te verwerken.
Een lijst uit een ander systeem. Elk systeem dat een CSV-bestand kan schrijven, zoals een archiefsysteem, een spreadsheet of een script, kan aangeven welke bestanden gemigreerd moeten worden.

De selectie staat in het CSV-bestand

De bestandsselectie wordt bepaald door de lijst en niet door één bronlocatie. De job heeft zelf geen Bron-URL van een bibliotheek, geen UNC-pad en geen OneDrive-gebruiker: elke regel van de lijst geeft aan waar het bestand staat.

Een lijst of een query

Een File List CSV is een selectie die vastligt op het moment van exporteren. Soms moet de selectie de documenten volgen, bijvoorbeeld de bestanden die vandaag aan een criterium voldoen, bij elke run van de job opnieuw. Een job van het type Dynamische BI-gegevensquery haalt de selectie dan rechtstreeks uit de BI-gegevens, zonder export en zonder rijlimiet. Deze functie is in ontwikkeling.

Zie Bestanden kiezen met een Power BI- of SQL-query

Hoe het werkt

Kies de bestanden en exporteer ze naar CSV
Beperk in het rapport Files in Power BI de tabel File details tot de bestanden die u wilt en exporteer deze naar een CSV-bestand. U kunt het CSV-bestand ook in een ander systeem aanmaken.
Zet het CSV-bestand in Nextcloud Files
Upload het naar een willekeurige map in Nextcloud Files. De app leest het bestand daar; er wordt niets naar de app zelf geüpload.
Maak een migratiejob aan met `Source Type` `File List CSV`
Kies in het jobvenster Testmigratie of Migratie als modus, zet Source Type op File List CSV en vul in File List Link de link naar het CSV-bestand in. Met Bestand kiezen selecteert of uploadt u het bestand.
Kies de bestemming
Een Nextcloud Team Folder of een Nextcloud-gebruiker, eventueel met een map daarbinnen, net als bij elke andere migratie.
Zet de job op Gereed
SMART Migration neemt de job op, leest de lijst uit de app en migreert elk bestand dat erop staat.

De kolommen van het CSV-bestand

De lijst is een CSV-bestand met komma's of puntkomma's tussen de kolommen. Het scheidingsteken dat het vaakst in de eerste regel voorkomt, wordt gebruikt, zodat een bestand dat een spreadsheet in welke taal dan ook heeft opgeslagen, ongewijzigd wordt gelezen. De eerste regel bevat de kolomkoppen. De job leest de kolommen aan de hand van hun koppen, in elke volgorde en ongeacht hoofdletters; een dubbele punt na een kop, zoals in Name:, wordt genegeerd. Alle andere kolommen blijven buiten beschouwing, zodat een export met veel kolommen ongewijzigd werkt.

Kolom	Vereist	Inhoud
`Name`	Altijd	De naam van het bestand, zoals `Budget 2026.xlsx`, of, op een regel zonder `Path`, het volledige adres van het bestand
`Path`	Optioneel	De map waarin het bestand staat: een SharePoint- of OneDrive-URL, of een UNC-pad of een station van de SMART Migration-server, zoals `\\FS01\Finance\2026`

Met een Path

Path en Name worden samengevoegd tot het adres van het bestand, met het scheidingsteken dat bij het soort adres hoort: / in een URL, \ in een UNC- of stationspad. Dat gebeurt ongeacht of Path al op dat teken eindigt. \\FS01\Finance\2026 en Budget 2026.xlsx worden \\FS01\Finance\2026\Budget 2026.xlsx

Met alleen Name

Name is de volledige URL, het UNC-pad of het stationspad van het bestand, zoals https://contoso.sharepoint.com/sites/Finance/Shared Documents/Budget 2026.xlsx, \\FS01\Finance\2026\Budget 2026.xlsx of c:\myfolder\my file.txt

Spaties voor en na een waarde worden genegeerd, net als lege regels. Een andere kolom mag tekst tussen aanhalingstekens over meerdere regels bevatten; die wordt als één cel gelezen. Een lijst met koppen maar zonder bestanden eronder is een lege lijst en geen fout.

Wat de controle afwijst

De controle wijst het volgende af. Een bestand zonder kop Name, of met kolommen die door iets anders dan komma's of puntkomma's worden gescheiden. Een regel zonder Name. Een Path dat geen map is. Een Name onder een Path die geen bestandsnaam is, bijvoorbeeld een volledig adres of een naam met een van de tekens : * ? " < > |. Een bestandsadres dat niet geldig is: een URL moet http:// of https://, een host, ten minste één map (de bibliotheek) en het bestand bevatten, dus een Path met alleen een host, zoals https://contoso, wordt afgewezen. Een UNC-pad moet een server, een share en het bestand bevatten, een stationspad een stationsletter en het bestand, zoals c:\myfolder\my file.txt. Geen van deze adressen mag een teken bevatten dat Windows in een naam weigert. Zolang het bestand niet is gecorrigeerd, wordt de job niet gevalideerd en kan deze niet op Gereed worden gezet.

Stap 1: de bestanden uit Power BI exporteren

Open het rapport Files in Power BI en beperk de tabel File details met de slicers en filters van de pagina tot precies de bestanden die u wilt. U kunt filteren op site, bibliotheek, eigenaar, bestandstype, grootte, ouderdom of elke andere kolom die het rapport biedt.

Exporteer die rijen vervolgens met de standaardexport van Power BI rechtsboven in de tabel: More options (…) → Export data → een CSV-bestand.

Tip: maximaal 30.000 bestanden per Power BI-export

Power BI exporteert maximaal 30.000 rijen naar één CSV-bestand, zowel in Power BI Desktop als in de Power BI-service, en laat de rest weg. Houd elke selectie daaronder, bijvoorbeeld één site, één bibliotheek of één eigenaar tegelijk, en geef elk deel een eigen File List CSV-job in dezelfde groep. Als het jobvenster Gevonden: … met 30000 bestanden meldt, is de lijst vrijwel zeker afgekapt.

Stap voor stap, in Power BI Desktop en in de Power BI-service, met manieren om de limiet te omzeilen: Een bestandslijst uit Power BI exporteren

Wat het geëxporteerde CSV-bestand bevat

Elke regel is één bestand, met de Name en het Path bij de bron tussen de overige kolommen van de tabel. Eén bestand kan bestanden uit SharePoint-, OneDrive- en bestandsshare-bronnen samen bevatten. Power BI exporteert met komma's tussen de kolommen; een bestand dat met puntkomma's is opgeslagen, wordt net zo goed gelezen.

Het rapport is opgebouwd uit wat Discovery en eerdere runs hebben gevonden. Staan de bestanden die u wilt nog niet in het rapport, voer dan eerst Discovery uit op de bronnen. Zie Discovery en Business intelligence met Power BI

Een lijst uit een ander systeem

Het CSV-bestand hoeft niet uit Power BI te komen. Elk systeem, zoals een archiefsysteem, een spreadsheet of een script, kan het aanmaken, zolang het bestand een kolom Name heeft, met een kolom Path of met volledige paden in Name, en komma's of puntkomma's tussen de kolommen. Een spreadsheet die is opgeslagen in een taal die decimalen met een komma schrijft, gebruikt puntkomma's als scheidingsteken; dat werkt zonder aanpassing.

Stap 2: het CSV-bestand in Nextcloud zetten en aan de job koppelen

Upload het CSV-bestand naar Nextcloud Files, in een willekeurige map in uw eigen bestanden of in een Team Folder. Ga daarna in het jobvenster naar de stap Bron:

Zet Source Type op File List CSV.
Klik op Bestand kiezen en selecteer het CSV-bestand, of upload het in hetzelfde venster vanaf uw computer met Bestand uploaden of door het erin te slepen. De interne link wordt in File List Link ingevuld
Of begin daar een nieuwe lijst: Hier nieuw CSV-bestand maken maakt FileList01.csv (of het eerstvolgende vrije nummer) aan in de map die op het scherm staat, met als enige kolomkop Name, en koppelt het aan de job. Open het met Bestand openen, voeg de bestanden één per regel toe als volledige URL, UNC-pad of stationspad, sla het op en klik op Voorbeeld vernieuwen.
Of plak de link zelf: open in Files het menu Delen van het bestand en kopieer de interne link, zoals https://cloud.example.com/f/12345

Het venster controleert het bestand en laat zien wat het heeft gevonden:

Het venster toont	Betekenis
Bestand: met de map en de bestandsnaam	Waar de link naartoe leidt in Nextcloud Files; klik op de map om deze te openen
Gevonden: … met n bestanden	Het bestand is een CSV-bestand en n regels onder de koppen bevatten elk een bestandsnaam
Voorbeeld: de eerste … regels	De eerste regels van het bestand zoals de controle ze heeft gelezen, eerst `Name` en `Path`, dan de overige kolommen; een cel die de controle afwijst, wordt gemarkeerd
Een melding in rood	Wat er mis is: geen bestand achter de link, een map, geen CSV-bestand, geen kolom `Name`, geen bestanden in de lijst, of de eerste regel met een ontbrekende `Name`, een `Name` die geen bestandsnaam is of een `Path` dat geen map is, met het aantal regels waarin een probleem zit; de foute cel wordt in het voorbeeld gemarkeerd

De lijst wijzigen

Bewerk het bestand of vervang het in Nextcloud Files onder dezelfde naam: de link blijft gelijk en de volgende run leest de nieuwe lijst. Bestand openen opent het bestand in een nieuw browsertabblad; nadat u het daar hebt opgeslagen, leest Voorbeeld vernieuwen het opnieuw in het venster.

In de tabel Jobs en op de samenvattingskaart van de job is de bron van de job de locatie van de lijst in Nextcloud Files, zoals /Reports/FileList01.csv, en niet de link. Zo ziet u welke lijst elke job leest. Een link die naar geen enkel bestand leidt, wordt ongewijzigd getoond.

Wat de job leest en wat hij negeert

Inclusief submappen en Lege mappen opnemen worden niet aangeboden: een lijst noemt elk bestand afzonderlijk, dus er zijn geen mappen om te doorlopen en geen lege mappen om opnieuw aan te maken.
Inclusief versiegeschiedenis en Bereik versiegeschiedenis gelden voor de bestanden die versies bijhouden, namelijk die uit SharePoint en OneDrive.
Een File List CSV-job is een Testmigratie, die de bestanden op de lijst controleert zonder iets te schrijven, of een Migratie, die ze kopieert. Voor Discovery wordt dit brontype niet aangeboden: de lijst is wat een Discovery u oplevert om uit te kiezen, niet iets om te ontdekken. Een Discovery-job toont deze keuze niet, en een File List CSV-job die achteraf naar Discovery wordt omgezet, wordt niet gevalideerd.

Zie Bronnen en Jobs en jobmodi

Hoe de mapstructuur in de bestemming opnieuw wordt opgebouwd

Als de lijst een kolom Relative Path heeft, worden de mappen van elk bestand in de bestemming daarmee opnieuw opgebouwd. Deze kolom bevat het pad van het bestand ten opzichte van het beginpunt van de bronscan die het bestand heeft gevonden; de export van File details uit Power BI bevat deze kolom. Bestanden behouden zo hun mapindeling in de bestemming, ook al zijn ze uit verschillende bronnen verzameld.

Bestanden met hetzelfde relatieve pad

Twee bestanden uit verschillende bronnen met dezelfde Relative Path en naam zouden op dezelfde plek in de bestemming terechtkomen. Controleer de lijst op zulke paren voordat de job wordt uitgevoerd, of splits de lijst in twee jobs met elk een eigen Destination Folder.

Zie Bestemmingen en Regels voor het toevoegen en overschrijven van bestanden

Wat er gebeurt wanneer de job wordt geclaimd

Wanneer SMART Migration een Bestandslijst-CSV-job claimt, leest de app de lijst opnieuw en controleert elke regel, zodat een fout die na het opslaan van de job is gemaakt, wordt gevonden voordat er iets wordt uitgevoerd.

De lijst wordt bewaard
Het CSV-bestand wordt gekopieerd naar de map van de run in SMART Migration Reports, zoals het op dat moment was. Jaren later toont de run nog steeds precies welke bestanden er gemigreerd moesten worden, ook als de lijst in Bestanden sindsdien is gewijzigd.
De lijst wordt gesplitst naar de locatie van de bestanden
Er worden twee bestanden naast geschreven: csv_url.csv met de SharePoint- en OneDrive-bestanden, en csv_unc.csv met de paden op bestandsshares en stations. Elk heeft één kolom, Name, met het volledige adres van elk bestand — Path en Name samengevoegd — met TAB als scheidingsteken, ongeacht wat de lijst gebruikte. Een bestand wordt alleen geschreven als de lijst bestanden van dat soort bevat.
SMART Migration krijgt de links
Bij de claim krijgt SMART Migration de job met de interne links van Nextcloud naar die twee bestanden, en SMART Migration migreert de bestanden die erin worden genoemd.

Een lijst met een fout beëindigt de run met Fout

Wanneer het bestand ontbreekt of de controle niet doorstaat, wordt de job niet aan SMART Migration overgedragen. De run eindigt direct met het resultaat Fout en een melding die aangeeft wat er mis is — de regel en de waarde, of de ontbrekende kolom — die Run-geschiedenis en de tooltip van de job tonen. Corrigeer het bestand in Bestanden en zet de job daarna weer op Gereed.

Zie Rapporten en runmappen in Nextcloud Files en Run-geschiedenis

SMART Migration kan de lijst ook zelf via de app lezen — GET /api/v1/jobs/{id}/file-list — zodat het account dat het gebruikt geen eigen toegang nodig heeft tot de map waarin het CSV-bestand staat.

Zie ook

Een bestandslijst uit Power BI exporteren
Bronnen
Een migratie plannen en uitvoeren, golf voor golf
Jobs importeren uit een CSV-bestand — een ander CSV-bestand: een dat aan te maken jobs opsomt, geen te migreren bestanden