Bronnen

SharePoint-bibliotheek

SharePoint Online, de documentbibliotheken achter Microsoft Teams, en SharePoint on-premises. Opgegeven als de URL van de bibliotheek.

OneDrive

De OneDrive for Business van een gebruiker, opgegeven als de UPN van de gebruiker (diens aanmeldadres) en eventueel een map daarin.

Bestandsshare

Een map op een bestandsserver of op een lokaal station van de SMART Migration-server, opgegeven als UNC-pad of station.

Bestandslijst-CSV

Een CSV-bestand in Nextcloud Files met de te migreren bestanden, afkomstig uit een willekeurig aantal van de bovenstaande bronnen. Opgegeven als de link naar het bestand.

Dynamische BI-gegevensquery

De bestanden die een Power BI DAX-query of een SQL WHERE-component uit de BI-gegevens selecteert, over alle bronnen die Discovery heeft vastgelegd. In ontwikkeling.

Een volledige bron, of één map daarin

Elk soort bron kan in zijn geheel worden gelezen of vanaf één map: een job neemt een volledige documentbibliotheek, een volledige OneDrive of een volledige share mee, of alleen één map daarin, met de submappen van die map zolang Inclusief submappen is ingeschakeld.

Source Type	De volledige bron	Eén map daarin
SharePoint Library	De URL van de bibliotheek in Source URL: https://mytenant.sharepoint.com/sites/S1/LibA	De map na de bibliotheek: https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder
OneDrive	De UPN van de gebruiker in Source UPN, Source Folder leeg gelaten	De UPN, en de map in Source Folder: Documents/Archive
FileShare	Een share als UNC-pad in Source UNC, \\MyServer\MyShare, of een station van de SMART Migration-server, D:\	Een map op een van beide: \\MyServer\MyShare\MyFolder of D:\MyFolder

Door een grote bron op te splitsen in één job per map blijft elke run kort en het bijbehorende verslag overzichtelijk; met één job voor de volledige bron staat de bron op één plek in de structuren en in het Power BI-rapport.

Een zeer grote bibliotheek per map opsplitsen in jobs

Een documentbibliotheek met vele duizenden bestanden kan prima als één job worden gemigreerd. Bij honderdduizenden of miljoenen documenten is dat niet het geval: in één job verloopt de migratie traag en wordt deze mogelijk helemaal niet voltooid.

Migreer een enorme bibliotheek niet in één job

Het lezen van een bibliotheek met miljoenen bestanden in één run vergt zeer veel van de resources van SharePoint en SharePoint Online en van het geheugen van de SMART Migration-server. Microsoft 365 beperkt een lange, zware run steeds sterker naarmate deze langer duurt; de server houdt tijdens de voorbereiding van de job de volledige mapstructuur van de bibliotheek vast; en een run die tegen het einde wordt onderbroken, door throttling, een verbindingsverlies of een herstart, heeft dagen besteed aan werk dat opnieuw moet worden gecontroleerd.

Verdeel de bibliotheek daarom: één job per map, of per groep mappen, elk met een deel van de bibliotheek.

1. Voer eerst Discovery uit op de bibliotheek

   Voer een Discovery-job uit op de volledige bibliotheek. Deze verplaatst niets, en het Power BI-rapport laat vervolgens zien hoe de bestanden, de versies en het volume over de mappen zijn verdeeld.

2. Kies de mappen

   Geef elke grote map op het hoogste niveau een eigen job (de map na de bibliotheek in Source URL, zoals .../sites/S1/LibA/Projects) en bundel de kleine mappen in enkele extra jobs. Een map die nog steeds te groot is, splitst u opnieuw op, één niveau dieper.

3. Vergeet de bestanden op het hoogste niveau niet

   Bestanden die in de hoofdmap van de bibliotheek staan, buiten alle mappen, hebben ook een job nodig: de eigen URL van de bibliotheek met Inclusief submappen uitgeschakeld.

4. Houd de jobs bij elkaar

   Plaats de jobs van de bibliotheek in één groep, geef ze een tag zoals de naam van de bibliotheek, en zorg dat hun bestemmingen samen de indeling van de bibliotheek in Nextcloud vormen. Spreid de grote jobs over avonden en weekenden.

Het vergt enige planning, en dat is het waard

Het opsplitsen van een bibliotheek kost een of twee uur planning. In ruil daarvoor is elke job kort genoeg om in één nacht te worden voltooid, kost een onderbroken job alleen het eigen deel, is de voortgang van elk deel duidelijk zichtbaar op het Dashboard, en kunnen de eigenaren de bibliotheek map voor map controleren en goedkeuren.

Zie ook Kiezen welke bestanden een job meeneemt en Groepen en tags

Documentbibliotheken van SharePoint en Teams

Bij Source Type SharePoint Library is Source URL de URL van de documentbibliotheek, bijvoorbeeld https://mytenant.sharepoint.com/sites/T1/LibB

• Een submap: schrijf het pad ervan na de bibliotheek, bijvoorbeeld https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder of .../LibA/MyFolder/2024; de job leest dan alleen die map. U kunt ook de map in de browser openen en de adresbalk plakken: de app zet deze om naar dezelfde URL.
• Kopieer het adres uit de browser: zie hieronder.
• De URL wordt tijdens het typen gecontroleerd. Het moet een webadres zijn dat begint met https:// of http:// en een geldige servernaam bevat. SharePoint staat * : < > " | en ? niet toe in de naam van een site, bibliotheek of map, dus een URL met een van deze tekens in het pad, getypt of geschreven als %2A en dergelijke, wordt niet gevalideerd. Een deellink, zoals https://mytenant.sharepoint.com/:f:/s/S1/…, ook niet: die verwijst naar een gedeeld item, niet naar een locatie; kopieer in plaats daarvan de adresbalk.
• Een site is geen bibliotheek. Een adres dat eindigt bij de site, zoals https://mytenant.sharepoint.com/sites/S1, wordt niet gevalideerd: voeg de bibliotheek toe.
• Teams: de bestanden van een team en de kanalen ervan worden bewaard in een documentbibliotheek van de SharePoint-site van het team. Gebruik de URL van die bibliotheek.
• SharePoint on-premises: gebruik de URL van de bibliotheek op uw farm. SMART Migration meldt zich daarbij aan met NTLM-referenties in plaats van met de Microsoft 365-appregistratie.

Het adres rechtstreeks uit de browser kopiëren

De eenvoudigste manier om Source URL in te vullen, is de bibliotheek in de browser te openen (of een willekeurige map daarin, zo diep als u wilt), te kopiëren wat de adresbalk toont en dat te plakken.

Wat de browser toont, is zelden het eigen adres van de bibliotheek: het is een pagina van de bibliotheek, .../Forms/AllItems.aspx, met de map verborgen in een gecodeerde id=-parameter en daarna een weergave-id. De app verwijdert dat allemaal en behoudt het directe, leesbare adres van de bibliotheek of de map, zodra u het veld verlaat en opnieuw wanneer de job wordt opgeslagen:

Geplakt uit de adresbalk	Wordt
https://mytenant.sharepoint.com/sites/S1/LibA/Forms/AllItems.aspx?id=%2Fsites%2FS1%2FLibA%2FMyFolder&viewid=…	https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder
https://mytenant.sharepoint.com/sites/S1/Shared%20Documents/Forms/AllItems.aspx	https://mytenant.sharepoint.com/sites/S1/Shared Documents

Gecodeerde tekens worden teruggezet naar wat ze voorstellen (%20 naar een spatie, %C3%A6 naar æ), zodat het adres de namen weergeeft zoals SharePoint ze toont. Dezelfde opschoning geldt voor Destination URL en voor de Import SharePoint URL van een importjob. Dit gebeurt uitsluitend in de app; er wordt niets aan SharePoint gevraagd.

Om één job te maken voor elke bibliotheek van een site of een volledige tenant, scant u deze met een importjob. Zie Jobs importeren door SharePoint of OneDrive te scannen

OneDrive

Bij Source Type OneDrive is Source UPN de User Principal Name van de gebruiker van wie de OneDrive wordt gelezen, bijvoorbeeld user1@contoso.com. Een adres op het onmicrosoft.com-domein van de tenant, zoals user1@tenant.onmicrosoft.com, is ook geldig.

• Bronmap is een optioneel pad binnen de OneDrive, bijvoorbeeld Documents/Archive. Laat dit leeg om de volledige drive te lezen.
• Verwijst naar toont het OneDrive-adres dat de job zal lezen, afgeleid van de UPN en de domeintoewijzing op het tabblad Instellingen.

Een OneDrive-job heeft de domeintoewijzing nodig

Microsoft 365 bouwt het OneDrive-adres van een gebruiker op uit het eigen SharePoint-domein van de tenant, niet uit het domein in diens UPN. Zolang Map From en Map To niet zijn ingesteld op het tabblad Instellingen, kan een OneDrive-job niet bepalen welke OneDrive moet worden gelezen, en wordt een UPN waarvan het domein niet overeenkomt met Map From niet gevalideerd, tenzij het een onmicrosoft.com-adres is, dat zelf de tenant aangeeft.

Alle OneDrives van een tenant kunnen met één scan worden omgezet in jobs. Zie OneDrive naar Nextcloud

Bestandsshares

Bij Source Type FileShare is Source UNC het UNC-pad of station van de bestanden, bijvoorbeeld \\MyServer\MyShare\MyFolder of D:\MyFolder

Leesrechten op dat pad moeten worden verleend aan het Windows-account waaronder de SMART Migration-server draait: de server leest de bestanden, niet Nextcloud. Een bestandsshare heeft geen versiegeschiedenis en geen SharePoint-metadata, dus die instellingen worden er niet voor aangeboden. Zie Bestandsshares naar Nextcloud

Een lijst met bestanden uit meerdere bronnen

Bij Source Type File List CSV is File List Link de link naar een CSV-bestand in Nextcloud Files met de te migreren bestanden, één per regel, bijvoorbeeld geëxporteerd uit de tabel File details van het Power BI-rapport Files. De kolommen worden gescheiden door komma's of puntkomma's, met een kolom Name en een optionele kolom Path, in willekeurige volgorde tussen eventuele andere kolommen; zonder Path is elke Name de volledige URL, het UNC-pad of het stationspad van het bestand. De job neemt precies die bestanden mee, uit de SharePoint-bibliotheek, OneDrive of bestandsshare waarin elk bestand zich bevindt. Deze optie wordt aangeboden voor Testmigratie- en Migratie-jobs, niet voor Discovery, en Inclusief submappen wordt er niet voor aangeboden: de lijst noemt elk bestand afzonderlijk. Zie Een lijst met bestanden uit een CSV-bestand migreren

Een query op de BI-gegevens

Source Type Dynamic BI data query selecteert bestanden op basis van wat ze zijn in plaats van waar ze staan (meer dan 100 versies, een metadatakolom met een bepaalde waarde) over alle bibliotheken, OneDrives en bestandsshares die Discovery heeft vastgelegd. Deze optie is in ontwikkeling: de velden worden getoond in het jobdialoogvenster, maar een job die deze optie gebruikt, kan nog niet worden uitgevoerd.

• Twee manieren om de query te schrijven: een DAX-query die in Power BI is vastgelegd met Performance Analyzer en met Omzetten naar SQL is omgezet naar een SQL WHERE-component, of een met de hand geschreven WHERE-component.
• Bij elke run toegepast door SMART Migration: SMART Migration voegt de component toe aan de eigen selectie van bestanden op de BI-gegevens, zodat de selectie altijd actueel is en alleen bestanden kan selecteren.
• Actueel gehouden door incrementele Discovery: met Incrementeel (alleen bestanden die sinds de laatste geslaagde run zijn gewijzigd) ingeschakeld op de Discovery-jobs van de beschermde bibliotheken volgen de BI-gegevens de documenten elke nacht, en houdt een queryjob een kopie bij van precies de kritieke bestanden, ten behoeve van DORA.
• Geen back-up: een terugkerende kopie omvat geselecteerde bibliotheken; als vuistregel minder dan 20, nooit meer dan ongeveer 50.

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

Wat elk soort bron ondersteunt

	SharePoint Online en Teams	SharePoint on-premises	OneDrive	Bestandsshare
Versiegeschiedenis	Ja	Ja	Ja	Nee
SharePoint-metadata naar MetaVox	Ja	Ja	Ja	Nee
Het bronbestand vervangen door een .url-link	Ja	Nee	Ja	Nee
Meldt zich aan met	Appregistratie en certificaat	NTLM-referenties	Appregistratie en certificaat	Het Windows-account van de server

De bron beperken met filters

Een bron hoeft niet in zijn geheel te worden meegenomen. Onder de eigen velden van de bron bevat de stap Bron filters die bepalen welke bestanden de job meeneemt. Schakel Geavanceerde instellingen bovenaan de stap in om ze te tonen:

Veld	Neemt mee	Voorbeeld
From Date en To Date	Bestanden vanaf en tot een datum en tijd	Alleen de laatste twee jaar: From Date twee jaar terug
Size From en Size To	Bestanden van ten minste en ten hoogste een bepaalde grootte, in KB	Bestanden groter dan 2 GB weglaten: Size To 2097152
Source File Type	Bestanden met deze extensies, zonder punt, gescheiden door ; of één per regel	pdf;docx;xlsx

Een bestand wordt meegenomen wanneer het aan elk ingesteld filter voldoet. Eenmaal ingesteld blijven de filters van kracht wanneer Geavanceerde instellingen weer wordt uitgeschakeld; zolang de optie is uitgeschakeld, vermeldt de regel onder de schakelaar wat deze verbergt. Zie Kiezen welke bestanden een job meeneemt

Meer instellingen bij de stap Bron

• Inclusief submappen: ook de mappen onder de bron lezen, of alleen de bestanden op het hoogste niveau. Standaard ingeschakeld.
• Inclusief versiegeschiedenis en Bereik versiegeschiedenis: zie Versiegeschiedenis
• Vanaf datum, Tot datum, Grootte vanaf, Grootte tot en Bronbestandstype (Geavanceerde instellingen): zie Kiezen welke bestanden een job meeneemt
• Bestanden met metadatawaarschuwingen migreren (Geavanceerde instellingen): zie Metadata, MetaVox en SharePoint-weergaven
• SharePoint Online-bronitem in documentbibliotheek vervangen door een .url-link naar Nextcloud (Geavanceerde instellingen): zie Overstap: traditionele en uitgebreide migratie

Zie ook

• Bestemmingen
• Jobs en jobmodi