ReplaceMagic und SharePoint Online — Native Massenreparatur von Links

SharePoint Online ist Microsofts cloudbasierte Plattform für Dokumentenverwaltung und Zusammenarbeit, die Teil von Microsoft 365 ist. Organisationen weltweit nutzen sie, um Word-, Excel-, PowerPoint-, Visio- und Project-Dateien in strukturierten Dokumentbibliotheken zu speichern. Wenn diese Organisationen von Dateiservern, lokalen SharePoint-Farmen oder einem anderen Microsoft 365-Mandanten migrieren, werden alle Hyperlinks, OLE-Objektverweise und eingebetteten Pfade, die auf einen alten Speicherort verwiesen haben, defekt. ReplaceMagic wurde speziell entwickelt, um dieses Problem zu lösen — in großem Maßstab, ohne dass Sie ein einziges Dokument manuell öffnen müssen.

Native Verbindung — Keine Laufwerkszuordnung erforderlich

ReplaceMagic stellt eine direkte Verbindung zu SharePoint Online über die Microsoft SharePoint REST API und CSOM (Client-Side Object Model) her. Das bedeutet, dass Sie SharePoint nicht als Netzlaufwerk einbinden oder WebDAV konfigurieren müssen. Die native API-Verbindung ist schneller, zuverlässiger und gibt ReplaceMagic Zugriff auf SharePoint-Metadaten, die ein zugeordnetes Laufwerk einfach nicht bereitstellen kann. Nach der Verbindung kann ReplaceMagic Dokumentbibliotheken aufzählen, Dateien zur Verarbeitung herunterladen, Ersetzungen anwenden und die korrigierten Dateien hochladen — alles ohne die ReplaceMagic-Oberfläche zu verlassen.

Unterstützte Authentifizierungsmethoden

ReplaceMagic unterstützt mehrere Authentifizierungsmethoden für SharePoint Online, um verschiedene Mandanten-Sicherheitskonfigurationen zu berücksichtigen:

• SharePoint Online (Benutzername/Kennwort) — Standard-Microsoft 365-Anmeldeinformationen. Geeignet für Mandanten, bei denen die Legacy-Authentifizierung noch zulässig ist.
• MFA mit App-Kennwort — Für Konten, die durch Multi-Faktor-Authentifizierung geschützt sind. Generieren Sie ein App-Kennwort in den Sicherheitseinstellungen Ihres Microsoft 365-Kontos und verwenden Sie es anstelle Ihres regulären Kennworts.
• Nur-App-Authentifizierung — Registrieren Sie eine Azure AD-Anwendung, erteilen Sie ihr die erforderlichen SharePoint-Berechtigungen und verwenden Sie die Client-ID und den geheimen Clientschlüssel. Diese Methode ist ideal für automatisierte, unbeaufsichtigte oder geplante Workflows, bei denen keine interaktive Anmeldung möglich ist.

Was ReplaceMagic in SharePoint Online beibehält

Eines der wichtigsten Anliegen bei der Massenverarbeitung von Dokumenten ist die Integrität der Metadaten. ReplaceMagic ist darauf ausgelegt, die folgenden SharePoint Online-Eigenschaften nach der Änderung einer Datei beizubehalten:

• Datum der letzten Änderung und Autor der letzten Änderung
• Status der Inhaltsgenehmigung (Genehmigt, Abgelehnt, Ausstehend)
• Versionsverlauf — Änderungen werden als neue Version eingecheckt, anstatt die Versionskette zu überschreiben
• Ein- und Auscheckstatus — Dokumente, die vor der Verarbeitung ausgecheckt waren, werden in denselben Zustand zurückgegeben

Die Beibehaltung des Datums der letzten Änderung und des Autors erfordert Websiteadministratorrechte für die Zielwebsitesammlung. Beitragsberechtigungen allein reichen für diesen Vorgang nicht aus.

SharePoint Online-Drosselung (HTTP 429)

SharePoint Online erzwingt Ratenbeschränkungen für API-Anforderungen. Wenn zu viele Anforderungen in einem kurzen Zeitfenster eintreffen, gibt der Dienst eine HTTP 429- (Zu viele Anforderungen) oder HTTP 503-Antwort zurück. ReplaceMagic behandelt die Drosselung automatisch: Es erkennt die 429-Antwort, liest den Retry-After-Header, pausiert den betroffenen Thread für die angegebene Dauer und wiederholt dann die Anforderung. Es ist kein manueller Eingriff erforderlich.

Um den Drosselungsdruck zu minimieren, wird die empfohlene Einstellung für die parallele Verarbeitung für SharePoint Online auf 3 bis 5 Threads festgelegt. Höhere Parallelität löst häufiger Drosselung aus und kann den Gesamtdurchsatz tatsächlich verringern. Sie können die Thread-Anzahl im Verarbeitungseinstellungsfeld von ReplaceMagic anpassen.

Unterstützte Bibliotheks- und Seitentypen

Über seine native Integration kann ReplaceMagic die folgenden Inhaltstypen in SharePoint Online verarbeiten:

• Standard-Dokumentbibliotheken (Word, Excel, PowerPoint, Visio, PDF und andere Dateitypen)
• Wiki-Seiten (Enterprise Wiki-Inhalt, der als ASPX gespeichert ist)
• Canvas-Seiten (Moderne SharePoint-Seiten)

Einschränkung bei Sonderzeichen

Dateien, deren Namen eines der folgenden Zeichen enthalten, können ihre freigegebenen Link-Token oder organisationsbezogenen Link-Informationen nicht über die SharePoint API abrufen: ~ # % & * { } \ : <> ? / + | ". Diese Dateien werden trotzdem heruntergeladen, auf defekte Links verarbeitet und erneut hochgeladen — aber alle freigegebenen Link-URLs, die auf sie verweisen, können nicht über den Token-Mechanismus repariert werden.

Typische Migrationsszenarien

• Dateiserver → SharePoint Online: UNC-Pfade (\\Server\Freigabe\Datei.xlsx) werden zu HTTPS-Dokumentbibliotheks-URLs.
• SharePoint lokal → SharePoint Online: Intranet-URLs (http://intranet/sites/...) ändern sich zu Cloud-URLs (https://unternehmen.sharepoint.com/sites/...).
• Mandant-zu-Mandant-Migration: Sowohl die Basis-URL als auch die internen SharePoint-Element-IDs ändern sich; ID-basierte Links müssen in das absolute URL-Format konvertiert werden.

Schritt-für-Schritt-Verarbeitungsübersicht

Die Verwendung von ReplaceMagic mit SharePoint Online folgt einem unkomplizierten Workflow: Wählen Sie SharePoint Online als Ziel → authentifizieren Sie sich mit Ihrer bevorzugten Methode → wählen Sie die Website und Dokumentbibliothek → führen Sie einen Scan durch, um alle Links zu identifizieren → konfigurieren Sie Suchen-und-Ersetzen-Regeln → zeigen Sie Änderungen im Ergebnisraster in der Vorschau an → führen Sie Ersetzungen aus. Der gesamte Prozess wird protokolliert und ist über den integrierten Versionsverlauf von SharePoint umkehrbar.