Mit dem WS-I Validator (Prüfprogramm) kann überprüft werden, ob WSDL-Definitionen den Spezifikationen des Basic Profile entsprechen.
Weitere Informationen zum WS-I Basic Profile finden Sie auf der WS-I-Website, insbesondere im WS-I Basic Profile-Dokument:
Mit dem WS-I Validator (Prüfprogramm) kann überprüft werden, ob WSDL-Definitionen den Spezifikationen des Basic Profile entsprechen (siehe WS-I Basic Profile Version 1.1).
Sie können den Validator auf eine der folgenden Arten ausführen:
- Manuell für eine bestimmte .wsdl-Ressource in der Workbench.
Mit dieser Option können Sie WS-I-Konformitätsprobleme erkennen und korrigieren. Alle Probleme bei der Gültigkeitsprüfung
werden als Tasklistenfehler und Warnungen angezeigt.
- Automatisch beim Import oder der Generierung der WSDL.
Die WSDL-Definition kann mit dem Assistenten für den Schnelleinstieg in WSDL, dem Assistenten für den Import von WSDLs oder dem Befehl mqsicreatemsgdefsfromwsdl importiert werden.
Die WSDL-Definition kann mit dem Assistenten für die Generierung von WSDLs aus einer Nachrichtengruppe generiert werden.
Das Verhalten des Prüfprogramms können Sie über die Befehlsfolge
Einstellungen > Web-Services > Profile Compliance and Validation' (Profilkonformität und Validierung) einstellen. .
Folgende Einstellungen sind besonders wichtig:
- WS-I AP compliance level (WS-I AP-Konformitätsstufe) (WS-I Attachments Profile 1.0)
- WS-I SSBP compliance level (WS-I SSBP-Konformitätsstufe) (WS-I Simple SOAP Binding Profile 1.0)
Folgende Einstellungen sind möglich:
- Suggest (Vorschlagen)
- Fehler, die bei der Ausführung des Prüfprogramms auftreten, werden als nicht behebbar behandelt, Warnungen dienen lediglich der Benachrichtigung. Dies ist die Standardeinstellung.
- Require (Anfordern)
- Fehler und Warnungen, die bei der Ausführung des Prüfprogramms auftreten, werden als nicht behebbar behandelt.
- Ignorieren
- Das Prüfprogramm wird nicht ausgeführt.
Beachten Sie, dass die AP-Auswahl automatisch auch für das SSBP-Feld gilt. Die Einstellung 'Ignore' (Ignorieren) kann daher nur dann explizit ausgewählt werden, wenn auch die AP-Auswahl auf 'Ignore' gesetzt ist.
Für die drei übergeordneten Kategorien der WSDL-Definition werden die folgenden Begriffe verwendet:
- document-literal bezeichnet die Kombination style="document" und use="literal".
- rpc-litera[ bezeichnet die Kombination style="rpc" und use="literal".
- rpc-encoded bezeichnet die Kombination style="rpc" und use="encoded".
Nachfolgend finden Sie eine Aufstellung der häufigsten Validierungsprobleme (dabei werden die oben genannten Bezeichnungen verwendet):
- Ihre WSDL ist 'rpc-encoded'
- Eine WSDL mit use="encoded" ist nicht WS-I-konform. Sie kann zu Betriebsfehlern führen, da Produkte verschiedener Hersteller von unterschiedlichen Voraussetzungen hinsichtlich der SOAP-Nutzdaten ausgehen.
WS-I: (BP2406) Das Attribut 'use' eines soapbind:body, soapbind:fault, soapbind:header und soapbind:headerfault hat nicht den Wert "literal".
- Ihre WSDL ist 'document-literal', eine oder mehrere WSDL-Teildefinitionen verweisen jedoch auf XML-Schematypen.
- In WSDL-Definitionen des Typs document-literal bestehen die Nutzdaten des SOAP-Hauptteils aus dem XML-Schema-Element, auf das der betreffende WSDL-Teil verweist.
Wenn statt eines Elements ein Typ angegeben wird, sind die SOAP-Nutzdaten nicht eindeutig definiert (der Name der Nutzdaten fehlt). Daraus ergeben sich häufig Interoperabilitätsprobleme.
WS-I: (BP2012) Eine document-literal-Bindung enthält soapbind:body-Elemente, die auf Nachrichtenteilelemente ohne Elementattribut verweisen.
- Ihre WSDL ist 'rpc-literal' oder 'rpc-encoded', eine oder mehrere WSDL-Teildefinitionen verweisen jedoch auf XML-Schema-Elemente.
- In WSDL-Definitionen des Typs 'rpc' bestehen die Nutzdaten des SOAP-Hauptteils aus dem WSDL-Operationsnamen. Seine untergeordneten Elemente bezeichnen die für die jeweilige Operation angegebenen WSDL-Teile.
Wenn statt eines Typs ein Element angegeben wird, sind die Nutzdaten der SOAP-Nachricht nicht eindeutig definiert (sowohl der Name des WSDL-Teils als auch der Name des XML-Schema-Elements kann der Name der Nutzdaten sein). Daraus ergeben sich häufig Interoperabilitätsprobleme.
WS-I: (BP2013) Eine rpc-literal-Bindung enthält soapbind:body-Elemente, die auf Nachrichtenteilelemente ohne Typattribut verweisen.
- Ihre WSDL enthält SOAP-Definitionen des Typs 'header', 'headerfault' oder 'fault', die auf XML-Schematypen verweisen.
- In WSDL-Definitionen des Typs 'rpc' wird der SOAP-Hauptteil korrekt durch die oben angegebenen XML-Schema-Typen definiert.
SOAP-Header und -Fehler verhalten sich bei einem rpc-Funktionsaufruf jedoch nicht auf die gleiche Weise wie der Hauptteil.
Insbesondere gibt es im Zusammenhang mit Headern oder Fehlern keine Parameter. Zur Vermeidung von Mehrdeutigkeiten müssen Header oder Fehler daher immer durch XML-Schema-Elemente definiert werden. Dies bedeutet, dass Header- und Fehlerdefinitionen in WSDL immer document-literal sind.
WS-I: (BP2113) Die Elemente soapbind:header, soapbind:headerfault und soapbind:fault verweisen auf wsd:part-Elemente, die nicht allein durch das 'element'-Attribut definiert sind.
- Ihre WSDL ist 'rpc-literal' oder 'rpc-encoded', für eine Operation wurde jedoch kein Namespace angegeben.
- In WSDL-Definitionen des Typs 'rpc' bestehen die Nutzdaten der SOAP-Nachricht aus dem WSDL-Operationsnamen. Dieser wird durch einen Namespace qualifiziert, der als Teil der WSDL-Bindung angegeben wird.
Wenn kein Namespace angegeben ist, sind die Nutzdaten der SOAP-Nachricht nicht eindeutig definiert (dem Namen der Nutzdaten ist entweder gar kein Namespace zugeteilt oder der Nutzdatenname verwendet standardmäßig einen anderen Namespace, beispielsweise den Ziel-Namespace der WSDL-Definition). Daraus ergeben sich häufig Interoperabilitätsprobleme.
WS-I: (BP2020) Eine rpc-literal-Bindung enthält soapbind:body-Elemente, die entweder gar kein Namespace-Attribut aufweisen oder deren Namespace-Attribut keinen absoluten URI-Wert aufweist.
Die Web-Service-Interoperabilität lässt sich durch Beachtung der folgenden Richtlinien verbessern:
- Verwenden Sie, wann immer möglich, WSDL-Definitionen des Typs 'document'.
- Verwenden Sie die Codierung 'literal', wenn Sie eine WSDL-Definition des Typs 'rpc' benötigen.
- Stellen Sie sicher, dass die WSDL-Operationsdefinitionen durch ein gültiges Namespaceattribut qualifiziert sind, wenn Sie eine rpc-codierte WSDL-Definition benötigen.