Creazione di una rappresentazione WSDL

È possibile generare una rappresentazione WSDL di elementi di richiesta e risposta e la relativa documentazione.

Informazioni su questa attività

Per scrivere il payload SOAP per la richiesta in uno specifico URI endpoint della serie di regole, è necessario generare la rappresentazione WSDL. La rappresentazione WSDL contiene la descrizione della richiesta SOAP e della risposta SOAP, nonché l'endpoint del servizio Web. Una serie di file XSD sono allegati al file WSDL per descrivere la rappresentazione XML degli oggetti di input e output.

Per generare una rappresentazione WSDL, è possibile utilizzare il formato degli URI della risorsa SOAP. Il formato WSDL è descritto nella pagina Web Services Description Language Il link esterno apre una nuova finestra o scheda del sito web W3C.

Procedura

  1. Definire la richiesta:
    https://<vhostname>.bpm.ibmcloud.com/odm/<odm_on_cloud_environment>/DecisionService/ws/{rulesetPath}/wsdl

    Le variabili URI sono definite in URI endpoint.

    Esempio:
    GET https://vhost005.bpm.ibmcloud.com/odm/dev/DecisionService/ws/miniloanruleapp/1.0/miniloanrules/1.0/wsdl
  2. Facoltativo: per creare il codice WSDL e i relativi file XSD in un file compresso, aggiungere il parametro zip .

    Utilizzare il parametro zip se si desidera scaricare il WSDL come archivio ZIP in cui i file XSD vengono salvati separatamente dal file WSDL. Questa opzione è utile se si importa più di una decisione da Decision Server in un progetto IBM® Integration Designer o se si migra un flusso delle regole in un processo. La separazione dei tipi di oggetto dal WSDL evita la duplicazione di tali oggetti in IBM Integration Designer.

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

Risultati

Se si tenta di generare una rappresentazione WSDL per un URL non valido o se si verifica un errore durante la generazione del WSDL, viene restituito un codice di stato di errore.
  • Se la richiesta è stata inviata da un browser, una pagina HTML visualizza il messaggio di errore.
    Nota: il codice di stato è200nonostante il messaggio di errore perché si applica alla pagina HTML, non al risultato della richiesta.
  • Se la richiesta è stata inviata da un client diverso da un browser, il codice di stato404 (Not Found)viene restituito e l'errore viene descritto in XML.
La descrizione dei messaggi di errore è contenuta nei codici di stato HTTP.