import von inhalten in confluence (ccd'09)

Wie lässt sich ein vollständiger Import von Inhalten mit Metadaten nach Confluence realisieren?

Confluence Community Day, 29.10.2009

Communardo Software GmbH

Tino Winkler

Motivation

Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/[email protected] · www.communardo.de · Tel. +49 (351) 8 33 82-02

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


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


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


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


Eigenimplementation basierend auf API für Inhaltsmanipulation Entity pro Inhaltstyp Persistierung mittels

Manager-Komponenten

Fallstrick Uneinheitliche API

Content Import Plugin


Unterstützt alle Inhaltstypen und beinahe alle Metainformationen

Durch Austauschformat auf beliebige Quellsysteme anwendbar

Import in bestehendes Confluence Wiki

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

Quellsystem

Datenbank

oder

+

Transformierter XML-Export

oder …Confluence-system

Export mitExport Script

Content Import Plugin

Import,Konvertierungmit Content Import Plugin

Präsentation...


11

Ihre Ansprechpartner


Tino WinklerCommunardo Software GmbH

[email protected] www.xing.com/profile/tino_winklerhttp://twitter.com/ccf_teamTelefon: +49-351-8332-266

Claudia LutterCommunardo Software GmbH

[email protected] www.xing.com/profile/claudia_lutterhttp://Twitter.com/cluTelefon: +49-351-8332-242

12 Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/[email protected] · www.communardo.de · Tel. +49 (351) 8 33 82-0

Fragen?

import von inhalten in confluence (ccd'09)

Technology