Norm 250 – Fehlerhandling - BiPRO

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Norm 250 – Fehlerhandling
Release und Version
Release 1, Version 1.0, vom 19. Juni 2007
Status
Offizielle Norm
Editor
Jörg Treiner, IDEAL Gruppe
Autoren
Markus Heussen, RheinLand Gruppe (markus.heussen@creditlife.net)
Marc Pellmann, inubit AG (marc.pellmann@inubit.com)
Sascha Klose, VHV Versicherung (sklose@vhv.de)
Dr. Dieter Ackermann, VOLKSWOHL BUND (dieter.ackermann@volkswohl-bund.de)
Dr. Thomas Kippenberg, Nürnberger (thomas.kippenberg@nuernberger.de)
Dr. Torsten Schmale, inubit AG (ts@inubit.com)
Jörg Treiner, IDEAL Gruppe (treiner@ideal-versicherung.de)
Stefan Hauptmann, VDV Klaus Reimer GmbH (stefan.hauptmann@v-d-v.de)
John Bodenstein, AssFiNET AG (john.bodenstein@assfinet.de)
Sören Chittka, VOLKSWOHL BUND, (soeren.chittka@volkswohl-bund.de)
Thomas Belting, RheinLand Gruppe, (thomas.belting@rheinland-versicherungen.de)
Gegenstand der Norm
Die Norm 250 definiert wie mögliche Fehler bei der Kommunikation zwischen einem BiPRO-
konformen Service Provider und Service Consumer gehandhabt werden. Hierbei werden alle
relevanten Fehlertypen berücksichtigt.
Voraussetzung
Norm 220, Release 1 Version 1
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 1 von 8 -

28
29
30
31
32
33
34
35
36
37
Hinweis zur Veröffentlichung
Die anliegend überreichte Norm ist urheberrechtlich für die BiPRO geschützt. Das Dokument
wird Ihnen im Rahmen Ihrer Mitgliedschaft bei der BiPRO und damit als Mitglied dieses
geschlossenen Empfängerkreises überlassen. Dementsprechend stellt die Überlassung an
Sie keine Erstveröffentlichung der Norm dar. Zur Erstveröffentlichung gegenüber Dritten bleibt
somit die BiPRO alleine berechtigt. Die Veröffentlichung erfolgt gemäß Norm100. Aufgrund
der besonderen Wertigkeit der Normen für die Mitglieder sind wir gehalten, Verstöße
gerichtlich zu ahnden.
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 2 von 8 -

38
39
40
41
42
43
44
45
Inhaltsverzeichnis
Norm 250 – Fehlerhandling .................................................................................................................. 1
Inhaltsverzeichnis ................................................................................................................................. 3
Fehler-Management ............................................................................................................................... 4
Abstraktionsebene .............................................................................................................................. 4
Modellierung von Fehlernachrichten .................................................................................................. 5
Erweiterte Ausnahmebehandlung ...................................................................................................... 8
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 3 von 8 -

46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
Fehler-Management
Dieser Abschnitt beschreibt wie und in welchem Maße Fehlermanagement im BiPRO-Kontext
durchgeführt wird.
Im Detail behandelt dieser Abschnitt folgende Aspekte des Fehlermanagements
• Abstraktionsebene
Die Frage auf welcher Ebene Fehler, die bei Verwendung von BiPRO Diensten
auftreten, behandelt werden
• Modellierung von Fehlernachrichten
In welchem Objektmodell BiPRO Fehlernachrichten beschrieben werden
• Erweiterte Ausnahmebehandlungen
Welche Ansätze zur erweiterten Ausnahmebehandlung benutzt werden können
• Normierung von Fehlernachrichten
Die Frage, wie Fehlernachrichten normiert werden können
Abstraktionsebene
BiPRO Fehler SOLLEN jene Fehler sein, die oberhalb der XML Validierungsebene auftreten.
Ein spezifischer BiPRO Fehler kann also nur dann auftreten, wenn die zu verarbeitende XML
Nachricht wohlgeformt im Sinne der W3C XML-Spezifikation und gültig gemäß des BiPRO
XML Schemas ist.
Fehler, die unterhalb der beschriebenen Ebene auftreten, KÖNNEN einem BiPRO Basisfehler
zugeordnet werden.
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 4 von 8 -

68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
Beispiel: Allgemeiner XML Verarbeitungsfehler
Modellierung von Fehlernachrichten
BiPRO Fehlermeldungen MÜSSEN grundsätzlich über die Objekte Status und Meldung des
BiPRO Schemas wiedergegeben werden. Das Objekt Status enthält grundsätzlich die
Information, ob ein Fehler aufgetreten ist. Ein Statusobjekt drückt diesen Fehler über die
StatusId aus.
Beispiel
…
…
00001
Optionale Fehlerbeschreibung
Zur genauen Fehlerspezifikation SOLLTE die Fehlernachricht mindestens ein Objekt vom Typ
Meldung beinhalten, das die Fehlernachricht tiefergehend beschreibt. Grundsätzlich KANN
das Objekt Status beliebig viele Objekte vom Typ Meldung beinhalten. Ein Objekt vom Typ
Status KANN unterschiedliche Typen von Objekt Meldung beinhalten. Hierarchische
Beziehungen zwischen Objekten vom Typ Meldung sind nicht vorgesehen.
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 5 von 8 -

89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
Ein Objekt vom Typ Meldung MUSS über sein Attribut ArtID als Fehler typisiert werden. Eine
weitergehende Typisierung der Fehlermeldung MUSS über das Attribut MeldungId erfolgen.
Ein Meldungsobjekt KANN eine beschreibende, textuelle Fehlermeldung beinhalten. Die
Fehlermeldung SOLLTE natürlichsprachlich und verständlich sein. Weiterhin SOLLTE ein
Meldungsobjekt eine Fehlerquelle beschreiben. Die Quelle MUSS dann durch einen XPATH-
Ausdruck gemäß W3C Spezifikation beschrieben sein. Der XPATH Ausdruck zeigt dann auf
das originär fehlerverursachende Objekt der Eingangsnachricht. Die Eingangsnachricht
SOLLTE vom Consumer vorgehalten werden, um im Fehlerfall den XPATH Ausdruck im
synchronen und asynchronen Modell auswerten zu können.
Werden L Defaultwerte zum Provider übertragen, der hiervon M Defaultwerte eigenständig
verändert und weitere N Felder, die nicht vom Consumer gesendet wurden, eigenständig mit
Defaultwerten belegt, so MUSS das Meldungsobjekt für die M veränderten Defaultwerte einen
Hinweis für den Consumer enthalten, um dieses Verhalten zu signalisieren. Zusätzlich
SOLLTEN diese Veränderungen über den optionalen XPATH-Ausdruck gekennzeichnet
werden.
Ein Meldungsobjekt kann einen Fehler also wie folgt ausdrücken:
Schematischer Aufbau eines Fehlerobjekts
…
…
00001
${X5}
${X1}
${X2}
${X3}
${X4}
…
…
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 6 von 8 -

124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
Variable Wert
${X1} Ein bestimmter Schlüsselwert des Datentyps ST_Meldungsart
${X2} Ein bestimmter Schlüsselwert des Datentyps ST_Meldung
${X3} Natürlichsprachlicher, verständlicher Fehlertext
${X4} XPATH Ausdruck gemäß W3C Norm
${X5} Optionale, textuelle Beschreibung der Statusmeldung
Das folgende Beispiel beschreibt eine konkrete, exemplarische BiPRO Fehlernachricht:
Beispiel
…
…
00001
Optionale Fehlerbeschreibung
1
00002
Die Adressdaten sind unvollständig
/bipro:whateverelemement/bipro:fooelement
…
…
Für den Fall, dass ein Fehler auf SOAP Ebene stattfindet, MUSS der Fehler im SOAP Objekt
beschrieben werden. In diesem Fall ist also das oben beschriebene Fehlermodell hinfällig. Der
BiPRO-spezifische Fehler wird dann im Element detail hinterlegt. Der Inhalt des Elements
detail SOLLTE ein BiPRO Status Objekt sein.
Beispiel
© Copyright BiPRO e.V. – Brancheninitiative Prozessoptimierung
- Seite 7 von 8 -

151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
soap:Client
Invalid message format
http://example.org/someactor