BibliothekFallstudienWrycan / NAVSEA

Altova Partner verwendet XMLSpy, StyleVision und Authentic, damit die Schiffswerft Portsmouth elektronische technische Handbücher auf Basis der eigenen DTD bearbeiten und veröffentlichen kann.

Übersicht

Die Schiffswerft Portsmouth in Kittery im US-Bundesstaat Maine untersteht dem Naval Sea Systems Command (NAVSEA), der größten der fünf Kommandozentralen der US Navy. Die Schiffswerft beauftragte Wrycan, einen Altova-Partner, der sich hauptsächlich mit XML-Content befasst, einige ihrer technischen Handbücher aus älteren Datenformaten anhand der Navy ETM XML DTD ins XML-Format zu konvertieren und diese anschließend im PDF-Format auszugeben.

Die Schiffswerft hatte den Auftrag erhalten, Daten von nun an hauptsächlich in XML zu speichern, und benötigte nun eine günstige und verlässliche Publishing-Lösung, die auch intern problemlos gewartet werden konnte.

Wrycan hatte bereits mit dem Altova MissionKit für die XML-Entwicklung gearbeitet und verfügte zudem über umfangreiche Erfahrung mit XML-Technologien wie XML, XSL:FO und DTD. So entschied man sich XMLSpy, StyleVision und Authentic aufgrund ihrer intuitiven und benutzerfreundlichen Bedienung und des günstigen Preises als Entwicklungstools für diese Implementierung zu verwenden.

Aufgabenstellung

Die Schiffswerf Portsmouth musste etwa 10.000 Seiten Content aus Altdatenbeständen ins DTD-konforme XML-Format konvertieren. Die Daten mussten dabei automatisch konvertiert, manuell überprüft und bereinigt werden. Anschließend mussten die XML-Daten über ein Befehlszeilentool wieder im ursprünglichen PDF-Format dargestellt werden.

Wie bei allen größeren Aufgaben dieser Art, bei denen Daten konvertiert und dargestellt werden müssen, mussten die Daten nach der Konvertierung einer umfangreichen Überprüfung unterzogen werden, die von technisch nicht geschultem Personal durchgeführt werden konnte, vorausgesetzt es gab die Möglichkeit, die XML-Daten aufzurufen und zu interpretieren.

Aufgrund des relativ komplexen Formats der Dokumentation, die komplizierte Seitenlayoutelemente wie z.B. eine unterschiedliche Anzahl an Spalten pro Seite, unterschiedlich breite Seitenränder, Bildbeschriftungen, Abschnitte, Aufzählungslisten sowie viele große schematische Modelle - einige davon auf ausfaltbaren Seiten - aufwies, versprach die XSL:FO-Kodierung eine knifflige Aufgabe zu werden.

Lösung

Wrycan führte den größten Teil der Content-Konvertierung mittels benutzerdefinierter Scripts und einigem an manueller Nachbearbeitung und technischer Qualitätskontrolle intern durch.

Nachdem der Content konvertiert war, erstellte Wrycan mit Hilfe der Drag-and-Drop-Funktionen von StyleVision und unter Verwendung der Navy ETM XML DTD als Strukturkomponente elektronische Authentic-Formulare für die Bearbeitung. Um die Qualitätskontrolle und die manuelle Bearbeitung zu erleichtern, wurden komplexe Stylesheet-Funktionen wie z.B. bedingte Vorlagen und automatische Berechnungen eingefügt.

Nachdem der Content konvertiert war, implementierte Wrycan ein Tool für die Verarbeitung über die Befehlszeile, das automatisch die folgenden Schritte durchführte:

• Zusammenstellung des Bands aus Stücken von XML-Dateien
  Aus Gründen der höheren Flexibilität und Benutzerfreundlichkeit wurden die technischen Navy-Handbücher in Abschnitte wie Titelei, Kapitel, Anhänge und Bilddateien aufgeteilt. Dadurch konnte Wrycan bestimmte Teile dieser Dateien für die Wiederverwendung verfügbar machen. Identische Komponenten, die in den Handbüchern an mehreren Stellen vorkamen, konnten in Abschnitte unterteilt werden, so dass an einer Stelle vorgenommene Änderungen überall in der Dokumentation durchgeführt wurden.
• Konvertierung von XML in XSL-FO
  Wrycan verwendete XMLSpy, den umfangreichen XML Editor von Altova, um die für die Handbücher erforderliche hochkomplexe XSL:FO-Datei manuell zu erstellen. Wie komplex die XML- und die PDF-Ausgabe sind, sehen Sie in den folgenden Beispielen: Quelle Band, Quelle Titelei, Quelle Kapitel und Endgültiges Dokument (3,8 MB PDF).
• Benutzerdefinierte Seitenformatierung
  Dokumente enthielten bei diesem Projekt Seiten verschiedener Größe, z.B. eine Seite im Hochformat gefolgt von einer ausfaltbaren Seite im Querformat 11" x 17". Laut Vorgaben waren für unterschiedliche Seitenformate unterschiedliche Druckvorgaben definiert. So mussten ausfaltbare Seiten z.B. einseitig bedruckt werden, während andere Seiten doppelseitig bedruckt wurden.
• Nachbearbeitung
  Außerdem gab es Vorgaben zur Seitennummerierung. So musste etwa jedes Kapitel auf einer ungeraden Seite beginnen. Wenn es dadurch zu einer Leerseite kam, musste ein Hinweis auf der Seite eingefügt werden, dass die Seite absichtlich leer gelassen wurde. Diese Anforderungen werden automatisch vom Verarbeitungstool von Wrycan erfüllt.
• PDF-Erstellung
  Wrycan integrierte die Software XEP von Render in den Arbeitsablauf, um die XSL:FO-Ausgabe einschließlich aller Bilder und Inhalte in die PDF-Datei zu konvertieren.

Die Bearbeitung des Inhalts erfolgt über StyleVision mittels Authentic, das in seiner neuesten Version verbesserte Unterstützung von Tabellen bietet.

In der Abbildung unten sehen Sie ein Beispiel für ein elektronisches Authentic-Formular für die WYSIWYG XML-Bearbeitung, das anhand des StyleVision Stylesheet Designs für NAVSEA generiert wurde.

Ergebnis

Die Schiffswerft Portsmouth verfügt nun über eine XML Publishing-Lösung mit nativen XML-Bearbeitungsfunktionen. Sie kann ihre technischen Handbücher im PDF-Format reproduzieren, wobei XML als Quelle für den Inhalt verwendet wird. Die Werft ist nun bereit für den nächsten Schritt, nämlich die Implementierung eines kompletten Content Management Systems mit Funktionen zur Verwaltung des Arbeitsablaufs und benutzerdefinierten Darstellung.

Sehen Sie selbst, wie Sie Ihre Dokumentation mit Hilfe von Altova-Tools erstellen und veröffentlichen können.

 Downloaden Sie jetzt eine kostenlose Testversion des Altova MissionKit mit dem vollen Funktionsumfang.