Nachrichten verschicken mit SOAP - Die SOAP-Spezifikation

SOAP-Fehler

Bei der Kommunikation können an verschiedenen Stellen der Kommunikationskette Fehler auftreten. Teil 1 der SOAP Spezifikation ist diesem Thema gewidmet. Die Spezifikation schreibt vor, dass im Fall eines Fehlers ein SOAP Fault Block als einziges Element des SOAP Body übertragen werden darf.

Der Namespace des Fault Blocks muss dabei mit dem URI HTTP://www.w3.org/2002/12/soap-envelope definiert werden. Dabei müssen in dem Fault Block die Elemente der folgenden Tabelle enthalten sein, ein Teil davon ist fakultativ:

Die Elemente des SOAP Fault Blocks

Elementname	Status	Beschreibung
Code	Verpflichtend	Von der SOAP Spezifikation festgelegte Codierung der Fehlerquelle
Reason	Verpflichtend	Textuelle Beschreibung des aufgetretenen Fehlers
Node	Fakultativ	Gibt an, an welcher Stelle der SOAP Kommunikation der Fehler aufgetreten ist
Role	Fakultativ	Beschreibt die Rolle des Knotens, bei dem der Fehler aufgetreten ist
Detail	Fakultativ	Enthält weitere Infos zum aufgetretenen Fehler. Der Inhalt kann von den Anwendungen frei festgelegt werden

Als Beispiel sei hier nur das erste Element „Code“ beschrieben, die anderen können bei Bedarf im Teil 1 der Spezifikation nachgelesen werden.

„Code“ besteht aus zwei Elementen: dem verpflichtenden „Value“, das den Fehlercode der Fehlermeldung enthält und dem optionalen „Subcode“, das die genaue Spezifikation des Fehlercodes im Element „Value“ ermöglicht.