WSDL-Darstellung generieren

Sie können eine WSDL-Darstellung von Anforderungs- und Antwortelementen und deren Dokumentation generieren.

Informationen zu dieser Task

Wenn Sie die SOAP-Nutzdaten für die an eine bestimmte Regelsatzendpunkt-URI gerichtete Anforderung schreiben möchten, müssen Sie die WSDL-Darstellung generieren. Die WSDL-Darstellung enthält die Beschreibung der SOAP-Anforderung und der SOAP-Antwort sowie den Web-Service-Endpunkt. An die WSDL-Datei ist eine Reihe von XSD-Dateien angehängt, um die XML-Darstellung der Eingabe- und Ausgabeobjekte zu beschreiben.

Wenn Sie die WSDL-Darstellung generieren möchten, können Sie das Format von SOAP-Ressourcen-URIs verwenden. Das WSDL-Format wird auf der Seite Web Services Description Language Externer Link öffnet ein neues Fenster oder eine neue Registerkarte seite der Website W3C beschrieben.

Vorgehensweise

  1. Definieren Sie die Anforderung:
    https://<vhostname>.bpm.ibmcloud.com/odm/<odm_on_cloud_environment>/DecisionService/ws/{rulesetPath}/wsdl

    Die URI-Variablen sind in Endpoint URIs definiert.

    Beispiel:
    GET https://vhost005.bpm.ibmcloud.com/odm/dev/DecisionService/ws/miniloanruleapp/1.0/miniloanrules/1.0/wsdl
  2. Optional: Fügen Sie den Parameter zip hinzu, um den WSDL-Code und seine XSD-Dateien in einer komprimierten Datei zu erstellen.

    Verwenden Sie den Parameter zip, wenn Sie die WSDL als ein ZIP-Archiv herunterladen möchten, in dem die XSD-Dateien und die WSDL-Datei gesondert voneinander gespeichert sind. Diese Option ist hilfreich, wenn Sie mehrere Entscheidungen aus Decision Server in ein IBM® Integration Designer -Projekt importieren oder wenn Sie einen Regelablauf in einen Prozess migrieren. Die Trennung der Objekttypen von der WSDL verhindert die Duplizierung dieser Objekte in IBM Integration Designer.

    Beispiel:
    GET https://vhost005.bpm.ibmcloud.com/odm/dev/DecisionService/ws/miniloanruleapp/1.0/miniloanrules/1.0/wsdl?zip=true 

Ergebnisse

Wenn Sie versuchen, die WSDL-Darstellung für eine ungültige URL zu generieren, oder wenn ein Fehler während der WSDL-Generierung auftritt, wird ein Fehlerstatuscode zurückgegeben.
  • Wenn Sie die Anforderung über einen Browser senden, wird die Fehlernachricht auf einer HTML-Seite angezeigt.
    Hinweis: Der Statuscode lautet200trotz der Fehlernachricht, da sie für die HTML-Seite gilt, nicht für das Anforderungsergebnis.
  • Wenn Sie die Anfrage von einem anderen Client als einem Browser gesendet haben, Statuscode404 (Not Found)wird zurückgegeben und der Fehler wird in XML beschrieben.
Eine Beschreibung der Fehlermeldungen finden Sie in HTTP.