requestbuilder.rst 2.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. .. _wps_request_builder:
  2. WPS Request Builder
  3. ===================
  4. The GeoServer WPS extension includes a request builder for testing out WPS processes through the :ref:`web_admin`. This tool can also be used to demonstrate processes, and construct your own examples.
  5. Accessing the request builder
  6. ---------------------------------
  7. To access the WPS Request Builder:
  8. #. Navigate to the main :ref:`web_admin`.
  9. #. Click on the :guilabel:`Demos` link on the left side.
  10. #. Select :guilabel:`WPS Request Builder` from the list of demos.
  11. .. figure:: images/demospage.png
  12. :align: center
  13. *WPS request builder in the list of demos*
  14. Using the request builder
  15. -------------------------
  16. The WPS Request Builder primarily consists of a selection box listing all of the available processes, and two buttons, one to submit the WPS request, and another to display what the POST request looks like.
  17. .. figure:: images/requestbuilderblank.png
  18. :align: center
  19. *Blank WPS request builder form*
  20. The display changes depending on the process and input selected. JTS processes have available as inputs any of a GML/WKT-based feature collection, URL reference, or subprocess. GeoServer-specific processes have all these as options and also includes the ability to choose a GeoServer layer as input.
  21. For each process, a form will display based on the required and optional parameters associated with that process, if any.
  22. .. figure:: images/requestbuildertoppstates.png
  23. :align: center
  24. *WPS request builder form to determine the bounds of topp:states*
  25. To see the process as a POST request, click the :guilabel:`Generate XML from process inputs/outputs` button.
  26. .. figure:: images/requestbuilderrequest.png
  27. :align: center
  28. *Raw WPS POST request for the above process*
  29. To execute the process, click the :guilabel:`Execute Process in New Page` button. The response will be displayed in the window.
  30. .. figure:: images/requestbuilderresponse.png
  31. :align: center
  32. *WPS server response (Browsers may render differently)*
  33. To see and execute the request in :ref:`demos_demorequests`, click the :guilabel:`Execute Process in Demo Requests` button.
  34. .. figure:: images/requestbuilder_demo.png
  35. :align: center
  36. *Request and Response shown in Demo Requests*