README

Dieses Projekt enthält die Servicedefinitionen von OMDS 3 als WSDLs und XSDs. Ferner sind die Dokumentationen der Services als Word-Dateien enthalten.

Git-Workflow

Das Projekt folgt dem GitFlow-Workflow, welcher hier beschrieben ist.

Es gibt folgende Haupt-Branches:

• master - der Master repräsentiert seit dem 1.9.2019 die offizielle Hauptentwicklungslinie und enthält die Releases als Tags

• develop - der Branch für die laufende Entwicklung, der Development-Branch kann der Veröffentlichung um mehrere Versionen vorauseilen. Es können auch Services oder Objekte wieder verworfen werden.

• release/... - der aktuelle Release-Candidate für die kommende Version. Dieser enthält nur solche Services und Objekte, die mit hoher Wahrscheinlichkeit im neuen Release enthalten sind.

• feature/... - Feature-Branches, in denen eigene Features modelliert werden, die noch so früh in der Diskussion sind, dass sie nicht einmal in den Development-Branch aufgenommen wurden.

Daneben gibt es Feature und Release-Branches.

Projektaufbau

Die Inhalte des Projekts sind in den folgenden Verzeichnissen organisiert:

• doc - Die Dokumentation der Services als Word Files
• docEntw - Die Dokumentation von Services, die noch nicht für den Release vorgesehen sind.
• docGen - Die mittels XMLSPY generierte Dokumentation (nur in den Veröffentlichungen enthalten)
• src/main/java - beispielhaft mit CXF generierte Java-Klassen
• src/main/resources/bind - Binding Definitionen für Apache CXF Framework
• src/main/resources/def - XSD und WSDL-Files

Im Verzeichnis src/main/resources/def sind in Unterverzeichnisssen auch ältere Versionen von OMDS 3 Definitionen enthahlten, damit ein einfacher Vergleich zwischen Versionen möglich ist.

In der jeweiligen Version finden sich folgende Files:

• omds3Services.wsdl - ist das WSDL mit den OMDS 3 Webservices
• omds3_ON ... .xsd - ist ein XSD mit OMDS 3 Datentypen. Es Referenziert die OMDS 2.x Datentypen
• omds...-00.xsd - ist ein XSD mit OMDS 2.x Datentypen