Immer wieder ereilen uns sowohl neue Anforderungen als auch Herausforderungen. So auch kürzlich. Die Aufgabenstellung: ein gesamtes SharePoint Wiki nach Confluence migrieren. Natürlich gibt es hierfür auch große, teure und aufwändige Lösungen. Allerdings ist das nicht wirklich immer notwendig! Wir veranschaulichen das im folgenden Beispiel.
Nach kurzer Recherche der erste Treffer. Es gibt ein sehr Hilfreiches Powershell Tool von AtlassianPS. Mit dem Modul ConfluencePS ist es ein Leichtes, Confluence Wiki-Seiten per Code anzulegen.
Powershell ist hierfür genau das richtige Mittel zum Zweck. Dies hat sich in der Vergangenheit bereits bei anderen Problemstellungen bewährt. Es können damit einfach automatisierte Lösungen erstellt werden.
Beispielsweise haben wir schon davon berichtet wie man die von O365 ShareGate erstellten Erstellt/Geändert Attribute bei der Migration auf einen FileShare ändert oder wie man Office Dokumente am SharePoint von .doc zu .docx konvertiert.
Weiters hat Powershell einige Vorteile, da der Code nicht kompiliert wird und leicht einsehbar und adaptierbar ist.
Was sind also die notwendigen Schritte, um ein SharePoint Wiki in ein Confluence Wiki zu transferieren? Zusammenfassen kann man dies auf 4 Stufen.
- SharePoint Wiki Seite auslesen.
- SharePoint Links mit Ziel Links ersetzen.
- Bilder von SharePoint nach Confluence kopieren.
- Confluence Wiki Seite anlegen.
Das automatisierte Anlegen von Confluence Wiki Seiten
Der erste oder in diesem Fall letzte Schritt ist somit getan. Dies ist mittels folgendem Code Snippet sehr simpel möglich:
New-ConfluencePage -Title 'MyNewWikiPage' -SpaceKey 'Wiki' -Body 'PageContents'
Und nun?
Natürlich ist es notwendig, die SharePoint Wiki-Seite zur Confluence Wiki-Seite zu transferieren.
Also, lesen wir den SharePoint-Seiteninhalt aus und übergeben diesen anschließend dem ConfluencePS Modul als Body-Text.
Glücklicherweise speichert SharePoint den gesamten Seiteninhalt einer Wiki Seite im Feld PublishingPageContent.
Das Format ist in HTML Tags abgebildet. Diese verwenden wir respektive zum Ersetzen der Hyperlinks und Kopieren eventuell vorhandener Bilder. Danach geht es direkt zum Anlegen der Confluence Wiki Seite.
- Zuerst greift man auf das SharePoint Element der Wiki Seite zu.
- Anschließend liest man das entsprechende Feld PublishingPageContent aus.
- Damit erstellt man letztlich die neue Confluence Wiki Seite.
$WikiBody = $PageItem["PublishingPageContent"] New-ConfluencePage -Title 'SharePoint Wiki Page' -SpaceKey 'TechWiki' -Body $WikiBody |Out-Null
Et voilà! Das Ergebnis unserer migrierten Seite
Links zu sehen ist die SharePoint Seite. Rechts danach unsere neue migrierte Confluence Wiki Seite.
So einfach ist es, eine SharePoint Wiki nach Confluence zu migrieren. Im Falle von zusätzlichen Fragen, stehen wir dir mit unserem Wissen natürlich jederzeit gerne zur Verfügung.