SharePoint-Migrationsszenarien — Wie ReplaceMagic fehlerhafte Links repariert

Fehlerhafte Links sind ein fast unvermeidliches Nebenprodukt von SharePoint-Migrationen. Sobald eine Datei an eine neue URL verschoben wird, funktioniert jeder Hyperlink, jede OLE-Objektreferenz und jeder eingebettete Pfad in jedem Dokument, das auf den alten Speicherort verwiesen hat, nicht mehr. ReplaceMagic bewältigt fünf verschiedene SharePoint-Migrationsszenarien, jedes mit seinem eigenen Muster der Linkunterbrechnungen und seiner eigenen Reparaturstrategie.

Szenario 1: Dateiserver zu SharePoint Online

Was passiert: Eine Organisation migriert Dokumente von einem Windows-Dateiserver zu SharePoint Online. Dateien, die zuvor unter UNC-Pfaden wie \\FileServer\Shared\Reports\Q4.xlsx verfügbar waren, sind nun über HTTPS-URLs wie https://company.sharepoint.com/sites/finance/Shared%20Documents/Reports/Q4.xlsx erreichbar.

Was dabei defekt wird: Jedes Dokument, das einen Hyperlink oder eine OLE-Referenz auf einen UNC-Pfad des alten Dateiservers enthielt, hat nun einen fehlerhaften Link, der auf einen Speicherort zeigt, der die Datei nicht mehr enthält.

Wie ReplaceMagic das repariert: Sie definieren eine Ersetzungsregel, die den alten UNC-Stammpfad (\\FileServer\Shared) der neuen SharePoint Online-Basis-URL zuordnet. ReplaceMagic wendet diese Regel auf alle Dokumente in der Zielbibliothek an und aktualisiert alle übereinstimmenden Links in einem einzigen Durchgang. Microsoft Teams-Dateien und OneDrive for Business-Dateien sind durch dieselbe native SharePoint-Integration abgedeckt, sodass für diese Speicherorte kein gesonderter Verarbeitungsschritt erforderlich ist.

Szenario 2: SharePoint On-Premises zu SharePoint Online

Was passiert: Eine Organisation hebt ihre lokale SharePoint-Farm auf Microsoft 365. Die Basis-URL jeder Website wechselt von einem Intranet-Format (http://intranet/sites/team) zu einem Cloud-Format (https://company.sharepoint.com/sites/team).

Was dabei defekt wird: Dokumente, die auf der neuen SharePoint Online-Website gespeichert sind, enthalten noch immer Links, die mit der alten Intranet-URL formatiert sind. Diese Links verweisen auf einen Server, der entweder stillgelegt wurde oder die Dateien nicht mehr enthält.

Wie ReplaceMagic das repariert: ReplaceMagic stellt eine native Verbindung zum SharePoint Online-Ziel her, verarbeitet jedes Dokument und ersetzt alle Vorkommen der alten Intranet-Basis-URL durch die neue Cloud-URL. Metadaten — Datum der letzten Änderung, Autor, Inhaltsgenehmigungsstatus und Versionsverlauf — bleiben dabei erhalten. Teams-Kanal-Dateien und OneDrive for Business-Dateien, die aus derselben lokalen Quelle migriert wurden, werden über dieselbe SharePoint-API-Verbindung verarbeitet.

Szenario 3: SharePoint Tenant-zu-Tenant-Migration

Was passiert: Zwei Organisationen fusionieren oder ein Unternehmen restrukturiert seinen Microsoft 365-Mandanten. Dokumente werden von einem Mandanten (company-a.sharepoint.com) zu einem anderen (company-b.sharepoint.com) migriert.

Was dabei defekt wird: Nicht nur die Basis-URL ändert sich, sondern auch die internen Element-IDs von SharePoint — die in Organisations- und freigegebenen Links verwendet werden — werden im neuen Mandanten neu vergeben. ID-basierte Links, die im Quell-Mandanten einwandfrei funktionierten, sind im Ziel-Mandanten dauerhaft defekt, da die IDs nicht mehr denselben Dokumenten entsprechen.

Wie ReplaceMagic das repariert: ReplaceMagic konvertiert zunächst ID-basierte SharePoint-Links in ein absolutes URL-Format, das über Mandantengrenzen hinweg stabil ist. Anschließend wird die Basis-URL-Ersetzungsregel angewendet. Dieser zweistufige Ansatz stellt sicher, dass auch Organisations-Links, die in Dokumenten eingebettet sind, nach einer Tenant-zu-Tenant-Verschiebung korrekt repariert werden.

Szenario 4: SharePoint Farm-zu-Farm-Migration (On-Premises zu On-Premises)

Was passiert: Eine Organisation migriert von einer lokalen SharePoint-Farm zu einer anderen — aufgrund einer Hardware-Erneuerung, einer Rechenzentrumskonsolidierung oder der Aktivierung einer Notfallwiederherstellung. Die Webanwendungs-URL oder der Server-Hostname ändert sich.

Was dabei defekt wird: Alle Dokumente, die Links zur alten Farm-URL enthalten, einschließlich dokumenteninterner Cross-Site-Links, haben defekte Referenzen. Wiki-Seiten und Navigationselemente, die auf den alten Server verweisen, sind ebenfalls betroffen.

Wie ReplaceMagic das repariert: ReplaceMagic stellt eine direkte Verbindung zur neuen Farm her und wendet Suchen-und-Ersetzen-Regeln an, die auf den alten Farm-Hostnamen oder die Basis-URL abzielen. Die Verarbeitung läuft ohne Drosselungsbeschränkungen und ermöglicht so eine höhere Parallelität und einen schnelleren Abschluss als eine cloudbasierte Migration. URLs der Schnellstartleiste und der oberen Navigationsleiste können ebenfalls im selben Verarbeitungsdurchgang aktualisiert werden.

Szenario 5: Restrukturierung der SharePoint Online-Bibliothek

Was passiert: Dokumente werden innerhalb von SharePoint Online neu organisiert — zwischen Websitesammlungen, zwischen Dokumentbibliotheken oder in neue Ordnerhierarchien verschoben. Dies kann im Rahmen einer Governance-Initiative oder zur Ausrichtung auf eine neue Informationsarchitektur erfolgen.

Was dabei defekt wird: Sowohl relative als auch absolute Pfade, die in Dokumenten eingebettet sind, ändern sich, wenn eine Datei in eine andere Bibliothek oder Websitesammlung verschoben wird. Dokumentenübergreifende Links, OLE-Referenzen und Hyperlinks werden gleichzeitig defekt.

Wie ReplaceMagic das repariert: ReplaceMagic durchsucht die betroffenen Bibliotheken und erstellt Ersetzungsregeln, die die neue Pfadstruktur widerspiegeln. Da die Dateien direkt über die native API verarbeitet werden, ist es nicht notwendig, die gesamte Bibliothek manuell herunterzuladen und erneut hochzuladen. Microsoft Teams- und OneDrive for Business-Dateien, die in restrukturierten SharePoint-Bibliotheken gehostet werden, werden automatisch abgedeckt.

Komplexe Projekte: Replacements Preparation Package

Für Migrationen, die mehrere gleichzeitige Szenarien umfassen — zum Beispiel eine Tenant-zu-Tenant-Verschiebung kombiniert mit einer Bibliotheksrestrukturierung — bietet ReplaceMagic einen professionellen Replacements Preparation Package-Service an. Unser Team analysiert Ihre Quell- und Zielumgebungen, ordnet alte Pfade neuen Pfaden zu und liefert einen sofort einsetzbaren Ersetzungsregelsatz, den Sie direkt in ReplaceMagic importieren können. Dadurch entfällt der manuelle Aufwand für die Erstellung komplexer Mehrregel-Konfigurationen und das Fehlerrisiko bei großen, anspruchsvollen Migrationsprojekten wird reduziert.