Kommunikationswege & Meldungsfluss

Grundsätzlich wird zwischen zwei Kommunikationswegen unterschieden. Jeder Meldungstyp kann genau einem Kommunikationsweg zugeordnet werden. Der Eingang (Incoming) und Ausgang (Outgoing) von Meldungen ist hierbei eine Frage der Perspektive.

Formate

Die Meldungen werden im xml-Format übermittelt. Die Struktur einer Meldung ist wie folgt dokumentiert:

• als Schema-Diagramm (pdf)

• in Tabellenform (xlsx)

• als xsd (zwecks Validierung der einzelnen Meldung im xml-Format)

• als xml (Beispiel)

xsd Prinzipien

xsd Konventionen

Die xsd Schemata können zwei verschiedenen Gruppen zugewiesen werden.

Datenstruktur der xsd

Die folgende Auflistung zeigt die Abhängigkeiten der einzelnen Schemata auf, die nachfolgend detailliert erläutert werden.

Bereich	Schemata	Filename	Beschreibung

Bereich	Schemata	Filename	Beschreibung
Passar	Simple Types	stypes_ch.xsd	Datenfelder: Enthält die Definition zum Typ, Format und Musterdefinition
	Common Complex Types	ctypes_ch.xsd	Datengruppen: Enthält die Definition zu den Datengruppen. Datengruppen die in mehreren Meldungen vorhanden sind, werden lediglich in einer Definition aufgeführt. In beiden Fällen gibt es Informationen zu welche Datenfelder sind enthalten, die Angaben zu Pflichtfeldern, maximale Wiederholungen, Regeln & Bedingungen und Codelisten.
	Header Types	htypes_ch.xsd	Enthält die Definitionen der Datenfelder und -gruppen für das technische Kopfelement und kommt in allen Meldungen vor.
	Technical Codelist	tcl_ch.xsd	Gibt den Typ von Datenfeldern an inkl. einer Aufzählung der möglichen Werte.
Chartera Ouput	All Types	Open

Um die Schemata miteinander zu verknüpfen, wird das XML-Element <import> verwendet.

Beispiel xsd Beschränkung

Open

xml Struktur 

Eine Meldung besteht aus Datengruppen und Attributen. 

Datengruppen (Data Group)

Eine Datengruppe besteht aus einer oder mehreren Daten(Unter)gruppen (Verschachtelung) und/oder aus einem oder mehreren Attribute.

Namenskonventionen xml-Tag

Wenn es ein Acronym ist, dann alles Gross, sonst PascalCase Format. Beispiele:

• GNSS → GNSS

• Goods Shipment → GoodsShipment

• Transport Equipment → TransportEquipment

• Additional Supply Chain Actor → AdditionalSupplyChainActor

Datentyp

Eine Datengruppe ist keinem Datentyp zugewiesen.

Art der Erforderlichkeit

Folgende Ausprägungen sind möglich:

• R (required): muss immer/in jedem Fall angegeben werden

• O (optional): ist optional - sind Daten vorhanden, sollten diese der Vollständigkeit halber angegeben werden

• D (dependent): kann entweder R, O oder N sein - ist abhängig von den Regeln und Bedingungen und wechselt entsprechend den Zustand

• N (nicht anwendbar): darf nicht vorhanden sein

Hinweise

• In der Spezifikation einer Meldung ist eine Datengruppe hellblau markiert.

• Die Namen der Datengruppen sind nicht einzigartig und können in unterschiedlichen Meldungen vorkommen. Deren Inhalt kann sich aber von Meldung zu Meldung unterscheiden und muss inhaltlich nicht übereinstimmen.

• Die übergeordnete Datengruppe ist jeweils anzugeben, wenn eine untergeordnete ausgefüllt wird.

• Einer Datengruppe werden keine, eine oder mehrere Rules & Conditions zugewiesen.

Attribut (Data Item)

Ein Datenfeld enthält die eigentliche Information.

Namenskonventionen xml-Tag

Wenn es ein Acronym ist, dann alles Gross, sonst camelCase Format. Beispiele:

• Declaration date → declarationDate

• MRN → MRN

• Presentation notification rejection date → presentationNotificationRejectionDate

Datentyp & Länge

Jedes Datenfeld hat ein zugewiesenes Format und eine bestimmte Länge:

• numerisch

• alphanumerisch

• dezimal

• Zeit

• Datum

• Zeitdatum

Generelles zur Längenangabe

• Zwischen dem Typ und der Längenangabe können zwei Punkte stehen. Dies bedeutet, dass die Anzahl Zeichen flexibel ist, aber maximal.

• Ein Komma bei der Längenangabe gibt an wie viele Zeichen vor und nach dem Komma stehen dürfen (sofern notwendig). Dies ebenfalls in Verbindung mit der flexiblen Anzahl (sofern 2 Punkte vorhanden sind) und dem Maximum.

Numerische Felder

• Die Inhalte sind positive Ganzzahlen oder positive Dezimalzahlen, sofern durch die CodelistenPreview oder eine Regel nicht weiter spezifiziert.

• Für die Dezimalzahlen ist der Punkt (.) zu verwenden. Weitere Zeichen sind nicht erlaubt.

• Die Zahl Null (0) darf den Ganzzahlen nicht vorangestellt werden.

• Dezimalzahlen sind nur zu verwenden, wenn die Präzisierung notwendig ist. Vor und nach dem Punkt ist mindestens eine Zahl anzugeben.

Beispiele für die Angabe “n..11,3”

Textfelder

• Führende oder nachfolgende Leerzeichen sind nicht erlaubt.

• Zeilenvorschübe (Tabulator) dürfen nicht verwendet werden.

• Aufgrund des xml-Formates sind gewisse Zeichen nicht erlaubt, da diese als Steuerzeichen verwendet werden und es zu Fehlern kommen kann. Diese sind wie folgt umzuwandeln:

&amp; wird nicht als 5 Zeichen gewertet, sondern als 1 Zeichen. Dies gilt auch für die anderen.

Datum & Zeit Felder

Für die DateTime und Time Felder ist die UTC Zeit zu verwenden. Das Datum ist analog der UTC Zeit anzugeben, siehe folgendes Beispiel.

• Zeit in der Schweiz: 27. Oktober 2021 7:48 (UTC+1)

• Folgende Zeit ist zu übermitteln: 27. Oktober 2021 6:48 (UTC)

Der Separator ‘T’ weist darauf hin, dass nach dem Datum noch eine Zeitangabe folgt. Ganze Sekunden ist die kleinste erlaubte Einheit.

Art der Erforderlichkeit

Folgende Ausprägungen sind möglich:

• R (required): muss immer/in jedem Fall angegeben werden

• O (optional): ist optional - sind Daten vorhanden, sollten diese der Vollständigkeit halber angegeben werden

• D (dependent): kann entweder R, O oder N sein - ist abhängig von den Regeln und Bedingungen und wechselt entsprechend den Zustand

• N (nicht anwendbar): darf nicht vorhanden sein

Hinweise

• In der Spezifikation einer Meldung ist eine Datengruppe grau markiert.

• In einzelnen Fällen ist der Wert vorgegeben. Die vorgegeben Werte sind in der jeweiligen Codeliste definiert.

• Die Felder sind sprachunabhängig, da sie UTF-8 codiert sind.

• Einem Attribut werden keine, eine oder mehrere Rules & Conditions zugewiesen.

xml Message Header

Folgende Informationen müssen pro Meldung im Message Header übermittelt werden:

Anfrage und Antwort Header Beispiel

Zu jeder Meldung des System Gegenüber wird von Passar eine Antwort Meldung erstellt. Die Message Header Informationen diesen dazu die Meldungen zu korrelieren.

Q&A