Generación de una representación WADL

Puede generar una representación WADL de elementos de solicitud y respuesta y su documentación.

Acerca de esta tarea

Para escribir la entrada XML para el método POST para un URL de punto final de conjunto de reglas específico, puede generar la representación WADL. La representación WADL contiene dos entradas para un método POST y una para un método GET. Se adjunta un conjunto de archivos XSD a este método para describir la representación XML de los objetos de entrada y salida.

Para generar una representación WADL, puede utilizar los URI de puntos finales. El formato WADL se describe en la página El enlace externo abre una nueva ventana o pestaña Lenguaje de descripción de aplicaciones web del sitio W3C web.

Procedimiento

Defina la solicitud:

https://<vhostname>.bpm.ibmcloud.com/odm/<odm_on_cloud_environment>/DecisionService/rest/v1/{rulesetPath}/wadl

Las variables URI se definen en los URI de punto final.

Ejemplo:

GET https://vhost005.bpm.ibmcloud.com/odm/dev/DecisionService/rest/v1/miniloanruleapp/1.0/miniloanrules/1.0/wadl

Opcional: Para añadir los archivos XSD en el código WADL, utilice el inline parámetro de consulta.
Ejemplo:
```
GET https://vhost005.bpm.ibmcloud.com/odm/dev/DecisionService/rest/v1/miniloanruleapp/1.0/miniloanrules/1.0/wadl?inline
```
Si no especifica el parámetro inline, los archivos .xsd externos referenciados por el archivo .wadl seguirán siendo externos. El archivo .wadl puede no funcionar correctamente con algunas herramientas de proveedores de software independientes. Si especifica el parámetro inline, los archivos .xsd se incluirán en el archivo .wadl.
Opcional: Para generar el código WADL y sus archivos XSD en un archivo comprimido, añada el zip parámetro.
Si especifica el parámetro zip, el parámetro inline no es necesario.
Ejemplo:
```
GET https://vhost005.bpm.ibmcloud.com/odm/dev/DecisionService/rest/v1/miniloanruleapp/1.0/miniloanrules/1.0/wadl?zip=true 
```

Resultados

Si intenta generar una representación WADL para un URL no válido o si se produce un error durante la generación de WADL, se devuelve un código de estado de error.

Si ha enviado la petición desde un navegador, una página HTML muestra el mensaje de error.
Nota: El código de estado es200A pesar del mensaje de error, ya que se aplica a la página HTML, no al resultado de la solicitud.
Si envió la solicitud desde un cliente que no sea un navegador, el código de estado404 (Not Found)se devuelve y el error se describe en XML.

Encontrará una descripción de los mensajes de error en los HTTP códigos de estado.