WPS Execute Operation via HTTP GET

geoprocessing.info

Home  |  Terms of use

Request Parameters


The following parameters form part of an Execute request via HTTP GET.


Request Parameters

Name Presence Description
Request Required Identifies service request. Must be "Execute".
Service Required Identifies service type. Must be "WPS".
Version Required Identifies service version. Defaults to the latest available version, currently 1.0.0.
Language Optional Determines the language of the human-readable content of the response. Consists of a valid 2 or 5 digit RFC 4646 language tag (e.g "en", or "en-CA") supported by the server as indicated in the Capabilities document.
DataInputs Optional List of inputs provided to this process execution. The contents of this parameter are defined here.

The value of this parameter is double-encoded as indicated here.
ResponseDocument

     ... or ...

RawDataOutput
Optional The choice of ResponseDocument or RawDataOutput defines the response type of the WPS, either an XML Response Document, or raw data output. Contains the list of outputs and formats requested from this process execution. If neither parameter is present, the response shall be an XML Response Document which includes all outputs encoded in the response according to the default formats identified in the DescribeProcess response. The contents of this parameter are defined here.

The value of this parameter is double-encoded as indicated here.

More information on Execute response forms is found here.
storeExecuteResponse Optional Boolean value that determines if the Execute Response shall be stored as a web-accessible resource. Either "true" or "false". The default is "false". More information on how this parameter operates is found here.
lineage Optional Boolean value that specifies if lineage information shall be included in the response document. Either "true" or "false". The default is "false".

If "true" then the Response Document will include a complete copy of the DataInputs and OutputDefinition elements as received in the Execute request.
status Optional Boolean value that specifies if status information shall be updated in the response document. Either "true" or "false". The default is "false". If status is "true" and storeExecuteResponse is "true", then the Status element of the execute response document stored at the statusLocation is kept up to date by the server.

Notes:

  1. All parameter names are listed here using mostly lowercase letters. However, any parameter name capitalization shall be allowed in KVP encoding.
  2. It is possible to have no inputs provided only when all the inputs are predetermined fixed resources. In all other cases, at least one input is required.
  3. If ResponseDocument is present then one or more of storeExecuteResponse, lineage, and status may also be present (depending on the capabilities of the server).
  4. If RawDataOutput is present then storeExecuteResponse, lineage, and status are not valid as part of the request.

Example

HTTP GET method using KVP

http://foo.bar/foo?
   Request=Execute&
   Service=WPS&
   Version=1.0.0&
   Language=en-CA&
   Identifier=Buffer&
   DataInputs=InputPolygon%3D%40xlink%3Ahref%3Dhttp%253A%252F%252Ffoo.bar%252F
      some_WFS_request.xml%40method%3DPOST%40mimeType%3Dtext%252Fxml%40encoding
      %3DUTF-8%40schema%3Dhttp%253A%252F%252Ffoo.bar%252Fgml_polygon_schema.xsd
      %3B%20BufferDistance%3D400%40uom%3Dfeet&
   ResponseDocument=BufferedPolygon%3D%40asReference%3Dtrue&
   storeExecuteResponse=true&
   lineage=true&
   status=true



For more information on structuring requests, please see the WPS Standard.