Unterstützte Confluence-Makros bei der Migration nach SharePoint
Confluence-Seiten bestehen selten nur aus Text. Inhaltsverzeichnisse, Hinweisboxen, eingebundene Auszüge, Diagramme, Statusanzeigen und Berichte werden über Makros erzeugt – und genau diese Elemente gehen bei einem einfachen Export verloren.
Unser Migrationswerkzeug erkennt und übersetzt über 70 Confluence-Makros in native SharePoint-Elemente. Diese Seite zeigt vollständig, welche das sind und was in SharePoint daraus wird.
Wie die Makro-Migration technisch funktioniert
Wir arbeiten nicht mit HTML-Exporten, sondern lesen das Confluence Storage Format direkt aus. Jedes Makro wird als strukturiertes Element erkannt, mit seinen Parametern interpretiert und in das passende SharePoint-Gegenstück überführt.
Dabei gibt es drei Ergebnistypen:
- Native Entsprechung – Das Makro wird zu einem echten SharePoint-Element mit gleicher Funktion, zum Beispiel Inhaltsverzeichnis, Seitenliste, Highlight-Box oder Datei-Vorschau.
- Inhaltserhalt mit angepasster Darstellung – Die Funktion existiert in SharePoint nicht eins zu eins, der Inhalt bleibt aber vollständig erhalten und wird sinnvoll dargestellt, zum Beispiel Registerkarten und aufklappbare Bereiche als reguläre Abschnitte.
- Externe Integration – Das Makro verweist auf ein Fremdsystem und bleibt funktional verlinkt beziehungsweise eingebettet, zum Beispiel Jira-Vorgänge, draw.io-Diagramme oder Videos.
Vor der Migration erhalten Sie eine Auswertung Ihres tatsächlichen Bestands: Welche Makros werden wie oft verwendet, welche Abdeckung erreichen wir automatisiert, welche Seiten benötigen Nacharbeit.
Struktur und Navigation
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Inhaltsverzeichnis (toc, toc-zone) | Native Inhaltsverzeichnis-Navigation der SharePoint-Seite |
| Untergeordnete Seiten (children) | Dynamische Liste der Unterseiten |
| Seitenbaum (pagetree) | Hierarchische Seitennavigation |
| Anker (anchor) | Sprungmarke innerhalb der Seite |
| Live-Suche (livesearch) | SharePoint-Suchfeld mit vorkonfiguriertem Suchbereich |
| Navigationskarte (navmap) | Kachelnavigation über die verschlagworteten Seiten |
| Aus Vorlage erstellen (create-from-template) | Verweis auf die entsprechende SharePoint-Seitenvorlage |
Layout und Textgestaltung
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Abschnitt und Spalte (section, column) | Mehrspaltiges SharePoint-Seitenlayout |
| Panel (panel) | Abgesetzter Inhaltsbereich |
| Aufklappbarer Bereich (expand, ui-expand) | Inhalt bleibt vollständig erhalten und wird als eigener Abschnitt dargestellt |
| Registerkarten (ui-tabs, ui-tab, tabs-group, tab-pane) | Tab-Inhalte werden als aufeinanderfolgende Abschnitte übernommen |
| Schrittanleitungen (ui-steps, ui-step) | Nummerierte Handlungsschritte |
| Hinweisboxen (info, warning, note, tip, hinweis) | Farbig hervorgehobene Hinweis-, Warn- und Tipp-Boxen |
| Textbox (ui-text-box) | Hervorgehobener Textbereich |
| Button (ui-button) | Gestalteter Handlungsaufruf |
| Statusanzeige (status) | Farbige Status-Kennzeichnung |
| Codeblock (code) | Formatierter Codeblock mit Syntaxhervorhebung |
| Unformatierter Text (noformat) | Vorformatierter Textblock |
| Markdown (markdown) | In formatierten SharePoint-Inhalt umgewandelt |
| Bildunterschrift | Bildbeschriftung unterhalb der Grafik |
Inhalte wiederverwenden
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Auszug (excerpt) | Wiederverwendbarer Inhaltsbaustein |
| Auszug einbinden (excerpt-include, excerpt-includeplus) | Der eingebundene Inhalt wird an der Zielstelle übernommen |
| Seite einbinden (include) | Inhalt der Quellseite wird integriert |
| Tabellenauszug (table-excerpt, table-excerpt-include) | Tabelleninhalt wird an der Zielstelle übernommen |
| Scroll Ignore (scroll-ignore) | Inhalt wird gemäß der Exportlogik behandelt |
Metadaten, Berichte und Seiteneigenschaften
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Seiteneigenschaften (details) | Strukturierte Metadaten der SharePoint-Seite |
| Seiteneigenschaftenbericht (detailssummary) | Gefilterte Übersichtsliste über die Metadaten mehrerer Seiten |
| Metadaten-Liste und -Bericht (metadata-list, metadata-report) | Metadatenübersicht als SharePoint-Ansicht |
| Inhaltsbericht-Tabelle (content-report-table) | Tabellarische Seitenübersicht |
| Inhalte nach Label (contentbylabel) | Dynamische Liste aller Seiten mit dem entsprechenden Schlagwort |
| Kürzlich aktualisiert (recently-updated) | Aktivitätsübersicht der zuletzt geänderten Seiten |
| Änderungshistorie (change-history) | Verweis auf die SharePoint-Versionshistorie |
| Benutzerprofil (profile) | Personenkarte mit Verknüpfung zum Microsoft-365-Profil |
Dateien, Bilder und Medien
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Dateiliste (attachments) | Dokumentbibliothek beziehungsweise Dateiliste der Seite |
| Office- und PDF-Vorschau (view-file, viewdoc, viewpdf, viewppt, viewxls) | Eingebettete Dokumentvorschau mit dem Microsoft-365-Renderer |
| Multimedia (multimedia) | Eingebetteter Video- oder Audioplayer |
| Galerie (gallery) | SharePoint-Bildergalerie |
| Widget Connector (widget) | Eingebetteter externer Inhalt |
| Videoeinbettung (YouTube) | Eingebettetes Video |
| Bilder, Emoticons und Layoutbereiche | Native Übernahme inklusive Bildgrößen und Ausrichtung |
Diagramme und Systemintegrationen
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| draw.io (drawio, drawio-sketch, inc-drawio) | Diagramm wird übernommen und bleibt in SharePoint bearbeitbar |
| Jira-Vorgänge (jira, jiraissues) | Verlinkte beziehungsweise eingebettete Jira-Darstellung – Einzelvorgang wie Filterergebnis |
| SAP DVS (sapdvs_link) | Funktionierender Verweis auf das SAP-Dokument |
Tabellen
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Table Filter (table-filter) | Tabelleninhalt bleibt vollständig erhalten |
| Table Enhancer (tableenhancer) | Formatierte SharePoint-Tabelle |
| Spaltenformatierung | Spaltenbreiten, Kopfzeilen und Ausrichtung werden übernommen |
Mehrsprachigkeit
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Sprachmakros (Deutsch, Englisch, Französisch, Spanisch, Italienisch, Portugiesisch, Russisch, Chinesisch, Japanisch, Koreanisch) | Sprachvarianten werden getrennt übernommen und den jeweiligen Sprachseiten zugeordnet |
| Scroll Translations (sv-translation) | Übersetzte Inhalte werden je Sprache separiert |
App- und kundenspezifische Makros
| Confluence-Makro | Ergebnis in SharePoint |
|---|---|
| Linchpin und Refined (linchpin-layout-box, linchpin-teaser) | Layout- und Teaserinhalte werden in SharePoint-Abschnitte überführt |
| Kundenspezifische Makros aus Eigenentwicklungen | Werden projektbezogen ergänzt – in bisherigen Projekten unter anderem Bildunterschriften und Metadatenmakros aus firmeneigenen Plugins |
Weitere Confluence-Elemente
Über Makros hinaus übernehmen wir die vollständige Seitenstruktur:
- Aufgabenlisten mit Erledigt-Status
- Interne Seitenverweise, die auf die neue SharePoint-Struktur umgeschrieben werden
- Anhänge, Bilder und Dateiverweise inklusive korrigierter Pfade
- Überschriftenhierarchie, Tabellen und Listen
- Emoticons, Datumsangaben und Inline-Kommentar-Markierungen
- Layoutbereiche und mehrspaltige Confluence-Layouts
Was passiert mit Makros, die nicht unterstützt werden?
Kein Migrationswerkzeug deckt jedes Makro jedes Marketplace-Plugins ab – und wir behaupten das auch nicht.
Trifft die Migration auf ein unbekanntes Makro, geht der Inhalt nicht verloren: Die Stelle wird in SharePoint sichtbar gekennzeichnet, inklusive Makroname und Herkunftsseite. Sie erhalten eine Liste aller betroffenen Seiten und können gezielt entscheiden, was nachbearbeitet, ersetzt oder bewusst nicht übernommen wird.
In der Praxis betrifft das eine kleine Restmenge, und sie ist im Voraus bekannt: Die Makro-Analyse vor Projektstart zeigt Ihnen exakt, welche Makros in Ihrem Bestand vorkommen und wie hoch die automatisierte Abdeckung ist. Kommt ein bislang nicht unterstütztes Makro häufig vor, ergänzen wir die Unterstützung in der Regel im Projekt – unsere Makro-Bibliothek ist genau so gewachsen.
Ihr nächster Schritt
Sie wissen nicht, welche Makros in Ihrem Confluence tatsächlich im Einsatz sind?
Wir analysieren Ihre Instanz und liefern Ihnen eine Auswertung mit allen verwendeten Makros, ihrer Häufigkeit und der erwarteten Migrationsabdeckung – als belastbare Grundlage für Ihre Entscheidung.
Kostenlose Erstberatung vereinbaren
Nehmen Sie Kontakt mit uns auf:
Rocketta GmbH
Kahlenbergstraße 2
45481 Mülheim an der Ruhr
0208 444-61343
kontakt@rocketta.de