Quellen

SharePoint-Bibliothek

SharePoint Online, die Dokumentbibliotheken hinter Microsoft Teams sowie SharePoint on-premises. Angegeben als URL der Bibliothek.

OneDrive

Das OneDrive for Business eines Benutzers, angegeben als UPN des Benutzers – seine Anmeldeadresse – und optional ein Ordner darin.

Dateifreigabe

Ein Ordner auf einem Dateiserver oder einem lokalen Laufwerk des SMART Migration-Servers, angegeben als UNC-Pfad oder Laufwerk.

Dateiliste (CSV)

Eine CSV-Datei in Nextcloud Files, die die zu migrierenden Dateien aus beliebig vielen der oben genannten Quellen auflistet. Angegeben als Link zu der Datei.

Dynamische BI-Datenabfrage

Die Dateien, die eine Power BI-DAX-Abfrage oder eine SQL-WHERE-Klausel aus den BI-Daten auswählt, über alle Quellen hinweg, die die Analyse erfasst hat. In Entwicklung.

Eine ganze Quelle oder ein Ordner darin

Jede Art von Quelle kann vollständig oder ab einem Ordner abwärts gelesen werden: Ein Auftrag übernimmt eine ganze Dokumentbibliothek, ein ganzes OneDrive oder eine ganze Freigabe oder nur einen Ordner darin – samt dessen Unterordnern, solange Unterordner einbeziehen aktiviert ist.

Source Type	Die ganze Quelle	Ein Ordner darin
SharePoint Library	Die URL der Bibliothek in Source URL: https://mytenant.sharepoint.com/sites/S1/LibA	Der Ordner nach der Bibliothek: https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder
OneDrive	Der UPN des Benutzers in Source UPN, Source Folder bleibt leer	Der UPN und der Ordner in Source Folder: Documents/Archive
FileShare	Eine Freigabe als UNC-Pfad in Source UNC, \\MyServer\MyShare, oder ein Laufwerk des SMART Migration-Servers, D:\	Ein Ordner auf einem der beiden: \\MyServer\MyShare\MyFolder oder D:\MyFolder

Wird eine große Quelle in einen Auftrag pro Ordner aufgeteilt, bleibt jeder Lauf kurz und sein Protokoll leicht lesbar; ein einziger Auftrag für die ganze Quelle hält die Quelle an einer Stelle in den Bäumen und im Power-BI-Bericht.

Eine sehr große Bibliothek nach Ordnern in Aufträge aufteilen

Eine Dokumentbibliothek mit vielen Tausend Dateien ist als ein Auftrag kein Problem. Eine mit Hunderttausenden oder Millionen von Dokumenten dagegen schon: In einem Auftrag migriert, ist sie langsam und wird womöglich gar nicht fertig.

Migrieren Sie eine riesige Bibliothek nicht in einem Auftrag

Das Lesen einer Bibliothek mit Millionen von Dateien in einem Lauf beansprucht sehr viele Ressourcen von SharePoint und SharePoint Online sowie viel Arbeitsspeicher des SMART Migration-Servers. Microsoft 365 drosselt einen langen, schweren Lauf umso stärker, je länger er dauert; der Server hält den gesamten Ordnerbaum der Bibliothek im Speicher, während der Auftrag vorbereitet wird; und ein Lauf, der kurz vor dem Ende abbricht – durch Drosselung, einen Verbindungsabbruch oder einen Neustart –, hat Tage mit Arbeit verbracht, die erneut geprüft werden muss.

Partitionieren Sie die Bibliothek stattdessen: ein Auftrag pro Ordner oder pro Gruppe von Ordnern, jeweils mit einem Teil der Bibliothek.

1. Bibliothek zuerst analysieren

   Führen Sie einen Analyse-Auftrag für die ganze Bibliothek aus. Er verschiebt nichts, und der Power-BI-Bericht zeigt anschließend, wie sich die Dateien, die Versionen und das Volumen auf ihre Ordner verteilen.

2. Ordner auswählen

   Geben Sie jedem großen Ordner der obersten Ebene einen eigenen Auftrag – den Ordner nach der Bibliothek in Source URL, etwa .../sites/S1/LibA/Projects – und fassen Sie die kleinen in einigen weiteren zusammen. Ein Ordner, der immer noch zu groß ist, wird eine Ebene tiefer erneut aufgeteilt.

3. Die Dateien auf oberster Ebene nicht vergessen

   Dateien, die im Stamm der Bibliothek außerhalb aller Ordner liegen, benötigen ebenfalls einen Auftrag: die eigene URL der Bibliothek mit deaktiviertem Unterordner einbeziehen.

4. Aufträge zusammenhalten

   Legen Sie die Aufträge der Bibliothek in eine Gruppe, versehen Sie sie mit einem Tag wie dem Namen der Bibliothek und sorgen Sie dafür, dass ihre Ziele zusammen die Struktur der Bibliothek in Nextcloud ergeben. Verteilen Sie die großen Aufträge auf Abende und Wochenenden.

Es erfordert etwas Planung – und es lohnt sich

Das Aufteilen einer Bibliothek kostet ein bis zwei Stunden Planung. Dafür ist jeder Auftrag kurz genug, um in einer Nacht fertig zu werden, ein abgebrochener Auftrag kostet nur seinen eigenen Teil, der Fortschritt jedes Teils ist in der Übersicht klar erkennbar, und die Verantwortlichen können die Bibliothek Ordner für Ordner prüfen und abnehmen.

Siehe auch Auswählen, welche Dateien ein Auftrag übernimmt und Gruppen und Tags

SharePoint- und Teams-Dokumentbibliotheken

Für Source Type SharePoint Library ist Source URL die URL der Dokumentbibliothek, zum Beispiel https://mytenant.sharepoint.com/sites/T1/LibB

• Ein Unterordner: Schreiben Sie seinen Pfad hinter die Bibliothek, zum Beispiel https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder oder .../LibA/MyFolder/2024 – der Auftrag liest dann nur diesen Ordner. Oder öffnen Sie den Ordner im Browser und fügen Sie den Inhalt der Adressleiste ein: Die App wandelt ihn in genau diese URL um.
• Adresse aus dem Browser kopieren – siehe unten.
• Die URL wird bei der Eingabe geprüft. Sie muss eine Webadresse sein, die mit https:// oder http:// beginnt, und einen gültigen Servernamen enthalten. SharePoint erlaubt * : < > " | und ? nicht in Website-, Bibliotheks- oder Ordnernamen, daher wird eine URL mit einem dieser Zeichen im Pfad – eingetippt oder als %2A o. Ä. geschrieben – nicht als gültig erkannt. Ein Freigabelink wie https://mytenant.sharepoint.com/:f:/s/S1/… ebenfalls nicht: Er bezeichnet eine Freigabe, keinen Ort; kopieren Sie stattdessen die Adressleiste.
• Eine Website ist keine Bibliothek. Eine Adresse, die bei der Website endet, etwa https://mytenant.sharepoint.com/sites/S1, wird nicht als gültig erkannt: Ergänzen Sie die Bibliothek.
• Teams: Die Dateien eines Teams und seiner Kanäle liegen in einer Dokumentbibliothek der SharePoint-Website des Teams. Verwenden Sie die URL dieser Bibliothek.
• SharePoint on-premises: Verwenden Sie die URL der Bibliothek in Ihrer Farm. SMART Migration meldet sich dort mit NTLM-Anmeldedaten statt mit der Microsoft 365-App-Registrierung an.

Adresse direkt aus dem Browser kopieren

Am einfachsten füllen Sie Source URL aus, indem Sie die Bibliothek im Browser öffnen – oder einen beliebigen, beliebig tief liegenden Ordner darin –, den Inhalt der Adressleiste kopieren und einfügen.

Was der Browser anzeigt, ist selten die eigentliche Adresse der Bibliothek: Es ist eine Seite der Bibliothek, .../Forms/AllItems.aspx, bei der der Ordner in einem codierten id=-Parameter steckt und dahinter eine Ansichts-ID folgt. Die App entfernt all das und behält die direkte, lesbare Adresse der Bibliothek oder des Ordners – sobald Sie das Feld verlassen und erneut beim Speichern des Auftrags:

Aus der Adressleiste eingefügt	Wird zu
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

Codierte Zeichen werden in das zurückverwandelt, wofür sie stehen – %20 in ein Leerzeichen, %C3%A6 in æ –, sodass sich die Adresse so liest, wie SharePoint die Namen anzeigt. Dieselbe Bereinigung gilt für Destination URL und für die Import SharePoint URL eines Importauftrags. Sie erfolgt allein in der App; SharePoint wird dabei nicht abgefragt.

Um für jede Bibliothek einer Website oder eines ganzen Tenants einen Auftrag zu erstellen, scannen Sie sie mit einem Importauftrag. Siehe Aufträge durch Scannen von SharePoint oder OneDrive importieren

OneDrive

Für Source Type OneDrive ist Source UPN der User Principal Name des Benutzers, dessen OneDrive gelesen wird, zum Beispiel user1@contoso.com. Eine Adresse in der onmicrosoft.com-Domäne des Tenants, etwa user1@tenant.onmicrosoft.com, ist ebenfalls gültig.

• Quellordner ist ein optionaler Pfad innerhalb des OneDrive, zum Beispiel Documents/Archive. Lassen Sie ihn leer, um das gesamte Laufwerk zu lesen.
• Wird aufgelöst zu zeigt die OneDrive-Adresse, die der Auftrag lesen wird, ermittelt aus dem UPN und der Domänenzuordnung auf der Registerkarte Einstellungen.

Ein OneDrive-Auftrag benötigt die Domänenzuordnung

Microsoft 365 bildet die OneDrive-Adresse eines Benutzers aus der eigenen SharePoint-Domäne des Tenants, nicht aus der Domäne in seinem UPN. Solange Map From und Map To auf der Registerkarte Einstellungen nicht festgelegt sind, kann ein OneDrive-Auftrag nicht ermitteln, welches OneDrive er lesen soll, und ein UPN, dessen Domäne nicht mit Map From übereinstimmt, wird nicht als gültig erkannt – es sei denn, es handelt sich um eine onmicrosoft.com-Adresse, die ihren Tenant selbst benennt.

Alle OneDrives eines Tenants lassen sich mit einem einzigen Scan in Aufträge umwandeln. Siehe OneDrive nach Nextcloud

Dateifreigaben

Für Source Type FileShare ist Source UNC der UNC-Pfad oder das Laufwerk der Dateien, zum Beispiel \\MyServer\MyShare\MyFolder oder D:\MyFolder

Das Windows-Konto, unter dem der SMART Migration-Server läuft, muss Leserechte für diesen Pfad haben: Es ist der Server, der die Dateien liest, nicht Nextcloud. Eine Dateifreigabe hat keinen Versionsverlauf und keine SharePoint-Metadaten, daher werden diese Einstellungen für sie nicht angeboten. Siehe Dateifreigaben nach Nextcloud

Eine Liste von Dateien aus vielen Quellen

Für Source Type File List CSV ist File List Link der Link zu einer CSV-Datei in Nextcloud Files, die die zu migrierenden Dateien auflistet, eine pro Zeile – zum Beispiel exportiert aus der Tabelle File details des Power-BI-Berichts „Files“. Die Spalten sind durch Kommas oder Semikolons getrennt, mit einer Spalte Name und einer optionalen Spalte Path, in beliebiger Reihenfolge zwischen beliebigen anderen; ohne Path ist jeder Name die vollständige URL, der UNC-Pfad oder der Laufwerkspfad der Datei. Der Auftrag übernimmt genau diese Dateien, aus welcher SharePoint-Bibliothek, welchem OneDrive oder welcher Dateifreigabe sie jeweils stammen. Dieser Quelltyp wird für Testmigration- und Migration-Aufträge angeboten, nicht für Analyse, und Unterordner einbeziehen wird dafür nicht angeboten: Die Liste benennt jede Datei selbst. Siehe Eine Liste von Dateien aus einer CSV-Datei migrieren

Eine Abfrage auf die BI-Daten

Source Type Dynamic BI data query wählt Dateien danach aus, was sie sind, statt danach, wo sie liegen – mehr als 100 Versionen, eine Metadatenspalte mit einem bestimmten Wert –, über alle Bibliotheken, OneDrives und Dateifreigaben hinweg, die die Analyse erfasst hat. Dieser Quelltyp befindet sich in Entwicklung: Seine Felder werden im Auftragsdialog angezeigt, ein Auftrag damit kann aber noch nicht ausgeführt werden.

• Zwei Möglichkeiten, sie zu formulieren: eine in Power BI mit der Leistungsanalyse aufgezeichnete DAX-Abfrage, die mit In SQL umwandeln in eine SQL-WHERE-Klausel umgewandelt wird, oder die von Hand geschriebene WHERE-Klausel.
• Von SMART Migration bei jedem Lauf angewendet: Es fügt die Klausel seiner eigenen Dateiauswahl auf den BI-Daten hinzu, sodass die Auswahl stets aktuell ist und nur Dateien auswählen kann.
• Durch inkrementelle Analyse aktuell gehalten: Mit Inkrementell (nur seit dem letzten erfolgreichen Lauf geänderte Dateien) bei den Analyseaufträgen der geschützten Bibliotheken folgen die BI-Daten jede Nacht den Dokumenten – und ein Abfrageauftrag hält eine Kopie genau der kritischen Dateien vor, für DORA.
• Keine Sicherung: Eine wiederkehrende Kopie deckt ausgewählte Bibliotheken ab – als Faustregel weniger als 20, nie mehr als etwa 50.

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

Was jede Art von Quelle unterstützt

	SharePoint Online und Teams	SharePoint on-premises	OneDrive	Dateifreigabe
Versionsverlauf	Ja	Ja	Ja	Nein
SharePoint-Metadaten in MetaVox	Ja	Ja	Ja	Nein
Quelldatei durch einen .url-Link ersetzen	Ja	Nein	Ja	Nein
Anmeldung mit	App-Registrierung und Zertifikat	NTLM-Anmeldedaten	App-Registrierung und Zertifikat	Windows-Konto des Servers

Die Quelle mit Filtern eingrenzen

Eine Quelle muss nicht vollständig übernommen werden. Unter den eigenen Feldern der Quelle bietet der Schritt Quelle Filter, die festlegen, welche ihrer Dateien der Auftrag übernimmt. Aktivieren Sie oben im Schritt Erweiterte Einstellungen, um sie anzuzeigen:

Feld	Übernimmt	Beispiel
From Date und To Date	Dateien ab und bis zu einem Datum und einer Uhrzeit	Nur die letzten zwei Jahre: From Date zwei Jahre zurück
Size From und Size To	Dateien mit einer Mindest- und Höchstgröße, in KB	Dateien über 2 GB auslassen: Size To 2097152
Source File Type	Dateien mit diesen Erweiterungen, ohne Punkt, getrennt durch ; oder eine pro Zeile	pdf;docx;xlsx

Eine Datei wird übernommen, wenn sie jeden gesetzten Filter erfüllt. Einmal gesetzt, bleiben die Filter wirksam, auch wenn Erweiterte Einstellungen wieder deaktiviert wird; solange die Option deaktiviert ist, nennt die Zeile unter dem Schalter, was sie ausblendet. Siehe Auswählen, welche Dateien ein Auftrag übernimmt

Weitere Einstellungen im Schritt „Quelle“

• Unterordner einbeziehen – auch die Ordner unterhalb der Quelle lesen oder nur die Dateien auf ihrer obersten Ebene. Standardmäßig aktiviert.
• Versionsverlauf einbeziehen und Umfang des Versionsverlaufs – siehe Versionsverlauf
• Von Datum, Bis Datum, Größe ab, Größe bis und Quell-Dateityp (Erweiterte Einstellungen) – siehe Auswählen, welche Dateien ein Auftrag übernimmt
• Dateien mit Metadaten-Warnungen migrieren (Erweiterte Einstellungen) – siehe Metadaten, MetaVox und SharePoint-Ansichten
• Element der SharePoint Online-Quelldokumentbibliothek durch einen .url-Link zu Nextcloud ersetzen (Erweiterte Einstellungen) – siehe Umstellung: traditionelle und erweiterte Migration

Siehe auch

• Ziele
• Aufträge und Auftragsmodi