gestern, heute, morgengestern, heute, morgen simon drees (kosit) und oliver hofrichter (tzi) 07....
TRANSCRIPT
![Page 1: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/1.jpg)
Dokumentation eines XÖV-Standards gestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV-Anwenderkonferenz| Bremen
![Page 2: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/2.jpg)
Inhalt
• Begrüßung
• Gestern
• Heute
• Heute in der Praxis
• Pause
• Morgen
• Diskussion
Koordinierungsstelle für IT-Standards 2
![Page 3: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/3.jpg)
Gestern
• Warum eine Dokumentationen? – Wissen vermitteln – Wissen nutzbar machen – Ein gemeinsames Verständnis erreichen
Koordinierungsstelle für IT-Standards 3 Quelle: posterforyou.com
![Page 4: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/4.jpg)
Gestern
• Für wen ist die Dokumentation? – Interne Dokumentation
• z. B. Kommentare im Programmquelltext • Unterstützung der Wartung und Weiterentwicklung
– Externe Dokumentation
• z. B. Anleitungen
Koordinierungsstelle für IT-Standards 4
![Page 5: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/5.jpg)
Gestern
• Problem: Aktualität und Verständlichkeit
– Entspricht die Dokumentation noch der Realität und
– Versteht der Interessent was ausgedrückt werden soll
Koordinierungsstelle für IT-Standards 5
![Page 6: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/6.jpg)
Gestern
• Aktualität – losgelöste Dokumentation
Koordinierungsstelle für IT-Standards 6
Technische Dokumentation
![Page 7: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/7.jpg)
Gestern
• Aktualität – losgelöste Dokumentation
Koordinierungsstelle für IT-Standards 7
Technische Dokumentation
![Page 8: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/8.jpg)
Gestern
• Aktualität – Dokumentation am gleichen Ort
Koordinierungsstelle für IT-Standards 8
Quelle: Harke (Own work) [GFDL or CC-BY-SA-3.0-2.5-2.0-1.0 via Wikimedia Commons
![Page 9: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/9.jpg)
Gestern
• Aktualität – Dokumentation am gleichen Ort
Koordinierungsstelle für IT-Standards 9
![Page 10: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/10.jpg)
Gestern
• Aktualität – Dokumentation am gleichen Ort
Koordinierungsstelle für IT-Standards 10
![Page 11: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/11.jpg)
Gestern
• Entwicklung durch Beschreibung (UML)
Koordinierungsstelle für IT-Standards 11
Quelle: Gubaer at the German language Wikipedia [GFDL or CC-BY-SA-3.0], from Wikimedia Commons
![Page 12: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/12.jpg)
Inhalt - Heute
• XPfleger light – Vom Modell zur Dokumentation
• Produktionszubehör • Produktionskette
• Dokumentations-Generierung – XGenerator-Steuerung
• Textschablonen (Templates) • Modellabfragen (Sprache: OCL)
– Transformation • DocBook FO PDF (Sprache: XSLT)
Koordinierungsstelle für IT-Standards 12
![Page 13: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/13.jpg)
Heute – XPfleger light
Koordinierungsstelle für IT-Standards 13
Idee: Fachliche Inhalte in Technik überführen
Fachliche Inhalte
XÖV-Standard
Überführung in
Fachlichkeit: komplexe Anforderung
elektronisch verarbeitbar
![Page 14: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/14.jpg)
Heute – XPfleger light
Koordinierungsstelle für IT-Standards 14
Mit technischen Informationen anreichern und überführen
Fachliche Inhalte
XÖV-Standard
UML-Fachmodell (ohne technische Details)
UML-Fachmodell (mit technischen Details)
Überführung in
Modellierung im
Überführung in
Transformation in
![Page 15: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/15.jpg)
Heute – XPfleger light
Koordinierungsstelle für IT-Standards 15
UML-Werkzeug
Validierung Modellierung Generierung + zusätzliche Validierung
der Produkte Setzen
XÖV-Werkzeug (XGenerator) Ausgabewerkzeug
XÖV-Zubehör DocBook-Zubehör
![Page 16: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/16.jpg)
XÖV-Invarianten
XGenerator
XÖV-DocBook-Templates
XÖV-DocBook-Operationen
XÖV-XSD-Templates
XÖV-XSD-Operationen
UML- Fachmodell
UML-Werkzeug
DocBook-Werkzeug
XÖV-Standard
Dokumentation
XML-Schemata XML-Schemata XML-Schemata bearbeitet
verarbeitet
nutzen
nutzen
DocBook-Fragmente
generiert
Erzeugung
Erzeugung
Prüfung (Validierung)
verarbeitet
Handgeschriebene DocBook-Dateien
verarbeitet
verarbeitet
DocBook-Zubehör
nutzt
XÖV-UML-Stereotypen
wendet an
Koordinierungsstelle für IT-Standards 16
Heute – XPfleger light
erzeugt
![Page 17: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/17.jpg)
Koordinierungsstelle für IT-Standards 17
spezifikation.xml
einleitung.xml
informationsmodell.xml
prozesse.xml
...
baukasten.xml
hauptgruppe_Hamsterzuchtregister.xml
Hamster.xml
hzr.hamstergeburtsmeldung.0101.xml
bindet ein
...
manuell geschrieben
automatisch generiert
Heute – XPfleger light
![Page 18: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/18.jpg)
Inhalt - Heute
• XPfleger light – Vom Modell zur Dokumentation
• Produktionszubehör • Produktionskette
• Dokumentations-Generierung – XGenerator-Steuerung
• Textschablonen (Templates) • Modellabfragen (Sprache: OCL)
– Transformation • DocBook FO PDF (Sprache: XSLT)
Koordinierungsstelle für IT-Standards 18
![Page 19: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/19.jpg)
Dokumentation generieren
![Page 20: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/20.jpg)
Koordinierungsstelle für IT-Standards 20
Dokumentation generieren
Formatting Objects (FO)
XSL-Prozessor (DocBook XSL- Stylesheets)
FO-Prozessor
XGenerator (Velocity und OCL)
UML- Fachmodell
DocBook-Fragmente
XÖV-Standard
PDF-Dokument
XML-Schemata XML-Schemata XML-Schemata
Handgeschriebene DocBook-Dateien
![Page 21: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/21.jpg)
• XGenerator nutzt Template-Dateien – Textschablonen für Elemente des Modells
• Template enthält 3 Sprachen: – Velocity-Anweisungen – DocBook – OCL (Abfrage des Modells)
Koordinierungsstelle für IT-Standards 21
Dokumentation generieren XGenerator (Velocity und OCL)
<section> <title> $ocl.eval("let title = extension_xsdTitled.title.isDefined in if title.isDefined() then title else c.name") </title> #if($ocl.eval("c.isAbstract")) <subtitle>(abstrakt)</subtitle> #end </section>
![Page 22: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/22.jpg)
Dokumentation generieren SVG-Generierung
Koordinierungsstelle für IT-Standards 22
![Page 23: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/23.jpg)
• DocBook
• Prüfung von XML-Dokumenten
• Transformation von XML-Dokumenten
Koordinierungsstelle für IT-Standards 23
Dokumentation generieren Einige Grundlagen
![Page 24: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/24.jpg)
Koordinierungsstelle für IT-Standards 24
Dokumentation generieren DocBook
Quelle: „XML Standards“, entwickler.press, 2010
![Page 25: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/25.jpg)
• offener Standard für technische Dokumentationen
• gepflegt von OASIS (Organization for the Advancement of Structured Information Standards)
• basiert auf XML
• darstellungsneutral
• 1991 von den Firmen O'Reilly & Associates und HaL Computer Systems entwickelt
• aktuell: DocBook V5
Koordinierungsstelle für IT-Standards 25
Dokumentation generieren DocBook
![Page 26: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/26.jpg)
• Strukturelle Elemente – Dokumenttypen: u.a. Bücher, Artikel – Teile, Kapitel, Abschnitte etc.
• Auszeichnung von Textblöcken – Absätze, Listen etc.
• Auszeichnung von logischen Informationen innerhalb von Textblöcken – Hervorhebungen (important) – Wiedergabe wörtlicher Rede (quote) – Links (verschiedene Typen: link, ulink, olink, xref)
• Keine Formatierungsinformationen
Koordinierungsstelle für IT-Standards 26
Dokumentation generieren DocBook
![Page 27: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/27.jpg)
• Wohlgeformtheit – Korrekter Einsatz der Syntax
• Gültigkeit – Validierung
• Einhaltung der Regeln einer Schemasprache
Grammatikbasierte Schemasprachen: • DTD (Document Type Definition) • XML Schema (vom W3C herausgegeben) • RelaxNG (ISO-zertifiziert)
Strukturregeln: Vorkommen, Häufigkeit, Reihenfolge von Elementen
Koordinierungsstelle für IT-Standards 27
Dokumentation generieren Prüfung von DocBook-Dokumenten
![Page 28: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/28.jpg)
• Hauptvorteil von RelaxNG gegenüber DTD – mehr Prüfmöglichkeiten
Koordinierungsstelle für IT-Standards 28
Dokumentation generieren Prüfung von DocBook-Dokumenten: RelaxNG
![Page 29: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/29.jpg)
• Schematron – Schemasprache – zur kontextbezogenen Validierung – erste Version im Jahre 1999 – ISO-Standard
Koordinierungsstelle für IT-Standards 29
Dokumentation generieren Prüfung von DocBook-Dokumenten: Schematron
![Page 30: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/30.jpg)
Dokumentation generieren Prüfung von DocBook-Dokumenten: Wohlgeformtheit
<book xmlns="http://docbook.org/ns/docbook" xml:lang="de" version="5.0"> <chapter> <title>Dokumentation von XÖV-Standards</title> <para> In diesem Workshop geht es um die Dokumentation von <firstterm linkend="xoevStandard">XÖV-Standards</firstterm>. </para> <glossary> <glossentry xml:id="xoevStandard"> <glossterm>XÖV-Standard</glossterm> <glossdef> <para>Ein Standard, dessen XÖV-Konformität die XÖV-Koordination bestätigt hat</para> </glossdef> </glossentry> </glossary> </chapter> </book>
Koordinierungsstelle für IT-Standards 30
![Page 31: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/31.jpg)
Dokumentation generieren Prüfung von DocBook-Dokumenten: Wohlgeformtheit
<book version="5.0"> <book version=5.0">
Koordinierungsstelle für IT-Standards 31
![Page 32: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/32.jpg)
Dokumentation generieren Prüfung von DocBook-Dokumenten: Gültigkeit
<glossentry xml:id="xoevStandard"> <glossterm>XÖV-Standard</glossterm> <glossdef>Definition</glossdef> </glossentry> <glossentry xml:id="xoevStandard"> <glossterm>XÖV-Standard</glossterm> </glossentry>
Koordinierungsstelle für IT-Standards 32
![Page 33: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/33.jpg)
Dokumentation generieren Prüfung von DocBook-Dokumenten: Schematron
<para> In diesem Workshop geht es um die Dokumentation von <firstterm linkend="xoevStandard">XÖV-Standards</firstterm>. </para>
Koordinierungsstelle für IT-Standards 33
![Page 34: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/34.jpg)
Koordinierungsstelle für IT-Standards 34
Dokumentation generieren DocBook: Formatierung
![Page 35: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/35.jpg)
• Extensible Stylesheet Language – XSL Transformations (XSLT)
• XPath (zur Adressierung) – XSL-Formatting Objects (XSL-FO)
Koordinierungsstelle für IT-Standards 35
Dokumentation generieren XSL
![Page 36: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/36.jpg)
• W3C eXtensible Stylesheet Language Transformation – Transformation von XML-Dokumenten
• W3C XML Path Language
– Adressierung innerhalb von XML-Dokumenten
• XSLT-Prozessor
– Eingabe: XML-Dokument XSLT-Stylesheet
– Ausgabe: transformiertes Dokument
Koordinierungsstelle für IT-Standards 36
Dokumentation generieren XSLT / Xpath / XSLT-Prozessor
![Page 37: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/37.jpg)
• W3C eXtensible Stylesheet Language Formatting Objects – Medienunabhängige Dokumentaufbereitung
• FO-Prozessor
– z.B. Apache FOP
– Eingabe: XSL-FO-Datei
– Ausgabe: Print-Medien (z.B. PDF)
Koordinierungsstelle für IT-Standards 37
Dokumentation generieren XSL-FO / FO-Prozessor
![Page 38: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/38.jpg)
Koordinierungsstelle für IT-Standards 38
Dokumentation generieren Verarbeitungsprozess
![Page 39: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/39.jpg)
Koordinierungsstelle für IT-Standards 39
Dokumentation generieren Verarbeitungsprozess: Beispiel (Eingabe / Ausgabe)
![Page 40: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/40.jpg)
Koordinierungsstelle für IT-Standards 40
Dokumentation generieren Verarbeitungsprozess: Beispiel (FO-Datei)
![Page 41: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/41.jpg)
Koordinierungsstelle für IT-Standards 41
Dokumentation generieren Verarbeitungsprozess: Beispiel (XSL-Stylesheets)
FO-Ausgabe:
![Page 42: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/42.jpg)
• DocBook-XSLT-Stylesheets können an Bedürfnisse eines Projektes angepasst werden
Koordinierungsstelle für IT-Standards 42
Dokumentation generieren Verarbeitungsprozess: Customization
DocBook XSL-Stylesheets
XÖV-Anpassungen
anpassen Projekt-Anpassungen
anpassen
![Page 43: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/43.jpg)
• DocBook: The Definitive Guide Norman Walsh, und Leonard Muellner. O'Reilly, Sebastopol, CA, (1999) http://www.docbook.org/tdg/en/html/docbook.html
• DocBook XSL: The Complete Guide Bob Stayton. Sagehill Enterprises, (2007) http://www.sagehill.net/docbookxsl/
Koordinierungsstelle für IT-Standards 43
Dokumentation generieren Literatur: DocBook
![Page 44: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/44.jpg)
• Apache Velocity User Guide Apache Software Foundation. (2010) http://velocity.apache.org/engine/releases/velocity-1.7/user-guide.html
• Object Constraint Language (OCL) 2.3.1 Object Management Group (OMG). (2012) http://www.omg.org/spec/OCL/2.3.1/PDF/
Koordinierungsstelle für IT-Standards 44
Dokumentation generieren Literatur: Velocity & OCL
![Page 45: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/45.jpg)
Inhalt
• Begrüßung
• Gestern
• Heute
• Heute in der Praxis
• Pause
• Morgen
• Diskussion
Koordinierungsstelle für IT-Standards 45
![Page 46: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/46.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 46
![Page 47: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/47.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 47
• Das Projekt
![Page 48: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/48.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 48
• Eine Bespielnachricht
![Page 49: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/49.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 49
• Die Dokumentation direkt am Objekt
![Page 50: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/50.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 50
• Exportieren damit der XGenerator es verarbeiten kann (ist auch ein
Standard
![Page 51: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/51.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 51
• Den XGenerator das Modell transformieren lassen
![Page 52: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/52.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 52
• Die Dokumentation in einem XML-Tool
![Page 53: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/53.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 53
• Generierungsprozess
![Page 54: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/54.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 54
• Schritte der Generierung
![Page 55: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/55.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 55
• Das Ergebnis:
![Page 56: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/56.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 56
• Ein paar Details was möglich ist
![Page 57: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/57.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 57
• Ein paar Details was möglich ist
![Page 58: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/58.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 58
• Ein paar Details was möglich ist
![Page 59: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/59.jpg)
Heute in der Praxis
Koordinierungsstelle für IT-Standards 59
• Ein paar Details was möglich ist
![Page 60: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/60.jpg)
Inhalt
• Begrüßung
• Gestern
• Heute
• Heute in der Praxis
• Pause
• Morgen
• Diskussion
Koordinierungsstelle für IT-Standards 61
![Page 61: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/61.jpg)
Morgen
Koordinierungsstelle für IT-Standards 62
• Generierung von Use Case-Dokumentation
• Generierung von Prozess-Dokumentation
• Dokumentation im HTML-Format
• Zentrale Dokumentation im UML-Fachmodell
• Zusätzliche Zielformate
![Page 62: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/62.jpg)
Morgen Generierung von Use Case-Dokumentation
• Anwendungsfall (Use Case)-Diagramm – UML-Verhaltensdiagramm – Beschreibung des funktionalen Verhaltens eines Systems von
außen gesehen
– Anwendungsfälle – Akteure – Beziehungen zwischen Akteur und
Anwendungsfall – Beziehungen zwischen Anwendungsfällen – Hinter einem Anwendungsfall steht ein Ablauf
• Beschreibung mit UML-Aktivitätsdiagramm
Koordinierungsstelle für IT-Standards 63
![Page 63: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/63.jpg)
• Pilotprojekt XTA • MagicDraw-Plugin
– Export aller Use Case-Diagramme im SVG-Format
• XGenerator-Templates – Generierung von DocBook-Fragmenten
Koordinierungsstelle für IT-Standards 64
Morgen Generierung von Use Case-Dokumentation
• XMI – XML Metadata Interchange – Standard der OMG (Object Management Group) – Austausch von MOF-basierten Modellen – Layoutinformationen werden nicht behandelt
• Ausschließlich Strukturinformationen / Elementdaten
![Page 64: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/64.jpg)
Koordinierungsstelle für IT-Standards 65
Morgen Generierung von Use Case-Dokumentation (Screenshot I)
![Page 65: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/65.jpg)
Koordinierungsstelle für IT-Standards 66
Morgen Generierung von Use Case-Dokumentation (Screenshot II)
![Page 66: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/66.jpg)
Koordinierungsstelle für IT-Standards 67
Morgen Generierung von Use Case-Dokumentation (Screenshot III)
![Page 67: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/67.jpg)
Morgen Generierung von Prozess-Dokumentation
• Aktivitäts (Activity)-Diagramm – UML-Verhaltensdiagramm – Ablauf eines Anwendungsfalls
• Verfeinerung des Use Case- Diagramms
– Aktivitäten – Aktionen – Kontrollfluss – Objektfluss etc.
Koordinierungsstelle für IT-Standards 68
![Page 68: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/68.jpg)
Morgen Generierung von Prozess-Dokumentation
Koordinierungsstelle für IT-Standards 69
![Page 69: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/69.jpg)
Koordinierungsstelle für IT-Standards 70
Morgen Dokumentation im HTML-Format
• XGenerator-Erweiterung um HTML-2-DocBook-Konvertierung – herold – http://www.dbdoclet.org/projects/herold/index.html
• Nutzung in Velocity-Templates: – $template.convertToDocBook(“HTML-Zeichenkette“)
DocBook
![Page 70: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/70.jpg)
Koordinierungsstelle für IT-Standards 71
spezifikation.xml
einleitung.xml
informationsmodell.xml
prozesse.xml
...
baukasten.xml
hauptgruppe_Hamsterzuchtregister.xml
Hamster.xml
hzr.hamstergeburtsmeldung.0101.xml
bindet ein
...
manuell geschrieben
automatisch generiert
Morgen Zentrale Dokumentation im UML-Fachmodell
![Page 71: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/71.jpg)
Morgen Zentrale Dokumentation im UML-Fachmodell
• Keine manuell geschriebenen DocBook-Dateien mehr • Verlagerung der gesamten Dokumentation in das UML-
Modell – Abbildung auf Modellelemente – Z.B. Paket Kapitel – Unterpaket Abschnitt
Koordinierungsstelle für IT-Standards 72
UML-Fachmodell
![Page 72: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/72.jpg)
• DocBook unterstützt durch die DocBook-Stylesheets bereits eine Vielzahl an Zielformaten – EPUB – HTML – Webhelp
Koordinierungsstelle für IT-Standards 73
Morgen Zusätzliche Zielformate?
![Page 73: gestern, heute, morgengestern, heute, morgen Simon Drees (KoSIT) und Oliver Hofrichter (TZI) 07. November 2013| 6. XÖV- Anwenderkonferenz| Bremen Inhalt • Begrüßung • Gestern](https://reader034.vdocuments.net/reader034/viewer/2022042811/5fa897475210c023cc5d1591/html5/thumbnails/73.jpg)
Vielen Dank für Ihre Aufmerksamkeit! Simon Drees (KoSIT) und Oliver Hofrichter (TZI)