Import Von Inhalten In Confluence (CCD'09)

Wie lässt sich ein vollständiger Import von Inhalten mit Metadaten nach Confluence realisieren?
Tino Winkler
Communardo Software GmbH
Confluence Community Day, 29.10.2009

Motivation
Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/Germany
info@communardo.de · www.communardo.de · Tel. +49 (351) 8 33 82-0
2
Einführung von Confluence: Was ist mit den Daten im Altsystem?
Migration nötig!
Übernahme großer Mengen von Daten
Import in bestehende Anwendung

HerausforderungFormat der Quelldaten
3
Abbildung auf Confluence Datenstrukturen
Bereiche, Seiten, News, Kommentare und Anhänge
Berücksichtigung von Metadaten
Datum, Ersteller, Bearbeiter, Schlagwörter
Referenzen zwischen Inhalten
Hierarchien, Verknüpfungen
Übernahme der Formatierung
Zeichenkodierung

Lösung
4
Austauschformat definieren
Abbildung der Quelldaten auf Datenstrukturen in Confluence
Definierte Zeichenkodierung
Metadaten zuordnen
Referenzen abbilden
Verwendung von XML-Dokumenten
Mit XML-Schema validierbar
Bibliotheken zum Generieren/Einlesen der Datenstrukturen vorhanden (z.B. JAXB)

HerausforderungSpezifika in Confluence
5
Validierung, Fehlerbehandlung
Verbotene Zeichen in Seitentiteln
Seitentitel müssen eindeutig sein
Zyklen in Hierarchie
Confluence speichert Inhalte in Wiki-Markup
Konvertierung der Inhalte des Quellsystems
Wahl der Importschnittstelle
UWC unterstützt keine Metadaten
API für XML-Import nicht dokumentiert und überschreibt vorhandene Bereiche
Direkter Import in Datenbank zu riskant

Lösung
6
Eigenimplementation basierend auf API für Inhaltsmanipulation
Entity pro Inhaltstyp
Persistierung mittels Manager-Komponenten
Fallstrick
Uneinheitliche API

Content Import Plugin
7
Quellsystem
Confluence-system
+
Transformierter XML-Export
Content Import Plugin
oder
Export mit
Export Script
Import,
Konvertierung
mit Content Import Plugin
Datenbank

Einfachheit vor
Komplexität.
(Maximal 3 Zeilen verwenden)

oder …
Unterstützt alle Inhaltstypen und beinahe alle Metainformationen
Durch Austauschformat auf beliebige Quellsysteme anwendbar
Import in bestehendes Confluence Wiki

Präsentation...
8

Herausforderungen API – Nutzer manipulieren
9
public void switchUser(SwitchUserCallback callback) {
// retrieve user to run callback for
User user = getUser();
// backup current user
User backup = AuthenticatedUserThreadLocal.getUser();
// switch user
AuthenticatedUserThreadLocal.setUser(user);
// run as switched user
callback.performAsSwitchedUser();
// restore current user
AuthenticatedUserThreadLocal.setUser(backup);
}
Nutzer steht in thread-local Variable
Wird kurzzeitig ausgetauscht
Auszuführender Code kann über Callback bereitgestellt werden

10
Dummy Eventhandler schreiben
In Manager Bean setzen
Achtung: nicht threadsafe -> Scheduler deaktivieren
HerausforderungenAPI – Eventsystem deaktivieren

Ihre Ansprechpartner
11
Tino Winkler
Tino.Winkler@communardo.de
www.xing.com/profile/tino_winkler
http://twitter.com/ccf_team
Telefon: +49-351-8332-266
Claudia Lutter
Claudia.Lutter@communardo.de
www.xing.com/profile/claudia_lutter
http://Twitter.com/clu
Telefon: +49-351-8332-242

12
Fragen?