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/Germanyinfo@communardo.de · 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

Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/Germanyinfo@communardo.de · www.communardo.de · Tel. +49 (351) 8 33 82-03

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

Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/Germanyinfo@communardo.de · www.communardo.de · Tel. +49 (351) 8 33 82-04

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

Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/Germanyinfo@communardo.de · www.communardo.de · Tel. +49 (351) 8 33 82-05

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

Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/Germanyinfo@communardo.de · www.communardo.de · Tel. +49 (351) 8 33 82-06

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

Manager-Komponenten

Fallstrick Uneinheitliche API

Content Import Plugin

Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/Germanyinfo@communardo.de · www.communardo.de · Tel. +49 (351) 8 33 82-07

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...

Communardo Software GmbH · Kleiststraße 10a · D-01129 Dresden/Germanyinfo@communardo.de · www.communardo.de · Tel. +49 (351) 8 33 82-08

11

Ihre Ansprechpartner

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

Tino WinklerCommunardo Software GmbH

Tino.Winkler@communardo.de www.xing.com/profile/tino_winklerhttp://twitter.com/ccf_teamTelefon: +49-351-8332-266

Claudia LutterCommunardo Software GmbH

Claudia.Lutter@communardo.de www.xing.com/profile/claudia_lutterhttp://Twitter.com/cluTelefon: +49-351-8332-242

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

Fragen?