$Id: wpsExecute_request.xsd 2007-10-09 $ This XML Schema Document encodes the WPS Execute operation request. Copyright (c) 2007 OGC, All Rights Reserved. For conditions, see OGC Software Notice http://www.opengeospatial.org/ogc/software WPS Execute operation request, to execute one identified Process. If a process is to be run multiple times, each run shall be submitted as a separate Execute request. Identifier of the Process to be executed. This Process identifier shall be as listed in the ProcessOfferings section of the WPS Capabilities document. List of input (or parameter) values provided to the process, including each of the Inputs needed to execute the process. 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. Defines the response type of the WPS, either raw data or XML document. If absent, the response shall be a response document which includes all outputs encoded in the response. List of the Inputs provided as part of the Execute Request. Unordered list of one or more inputs to be used by the process, including each of the Inputs needed to execute the process. Defines the response type of the WPS, either raw data or XML document Indicates that the outputs shall be returned as part of a WPS response document. Indicates that the output shall be returned directly as raw data, without a WPS response document. Unordered list of definitions of the outputs (or parameters) requested from the process. These outputs are not normally identified, unless the client is specifically requesting a limited subset of outputs, and/or is requesting output formats and/or schemas and/or encodings different from the defaults and selected from the alternatives identified in the process description, or wishes to customize the descriptive information about the output. Indicates if the execute response document shall be stored. If "true" then the executeResponseLocation attribute in the execute response becomes mandatory, which will point to the location where the executeResponseDocument is stored. The service shall respond immediately to the request and return an executeResponseDocument containing the executeResponseLocation and the status element which has five possible subelements (choice):ProcessAccepted, ProcessStarted, ProcessPaused, ProcessFailed and ProcessSucceeded, which are chosen and populated as follows: 1) If the process is completed when the initial executeResponseDocument is returned, the element ProcessSucceeded is populated with the process results. 2) If the process already failed when the initial executeResponseDocument is returned, the element ProcessFailed is populated with the Exception. 3) If the process has been paused when the initial executeResponseDocument is returned, the element ProcessPaused is populated. 4) If the process has been accepted when the initial executeResponseDocument is returned, the element ProcessAccepted is populated, including percentage information. 5) If the process execution is ongoing when the initial executeResponseDocument is returned, the element ProcessStarted is populated. In case 3, 4, and 5, if status updating is requested, updates are made to the executeResponseDocument at the executeResponseLocation until either the process completes successfully or fails. Regardless, once the process completes successfully, the ProcessSucceeded element is populated, and if it fails, the ProcessFailed element is populated. Specifies if the Execute operation response shall be returned quickly with status information, or not returned until process execution is complete. This parameter shall not be included unless the corresponding "statusSupported" parameter is included and is "true" in the ProcessDescription for this process. Indicates if the Execute operation response shall include the DataInputs and OutputDefinitions elements. If lineage is "true" the server shall include in the execute response a complete copy of the DataInputs and OutputDefinition elements as received in the execute request. If lineage is "false" then these elements shall be omitted from the response. Indicates if the stored execute response document shall be updated to provide ongoing reports on the status of execution. If status is "true" and storeExecuteResponse is "true" (and the server has indicated that both storeSupported and statusSupported are "true") then the Status element of the execute response document stored at executeResponseLocation is kept up to date by the process. While the execute response contains ProcessAccepted, ProcessStarted, or ProcessPaused, updates shall be made to the executeResponse document until either the process completes successfully (in which case ProcessSucceeded is populated), or the process fails (in which case ProcessFailed is populated). If status is "false" then the Status element shall not be updated until the process either completes successfully or fails. If status="true" and storeExecuteResponse is "false" then the service shall raise an exception. Definition of a format, encoding, schema, and unit-of-measure for an output to be returned from a process. In this use, the DescriptionType shall describe this process input or output. Title of the process output, normally available for display to a human. This element should be used if the client wishes to customize the Title in the execute response. This element should not be used if the Title provided for this output in the ProcessDescription is adequate. Brief narrative description of a process output, normally available for display to a human. This element should be used if the client wishes to customize the Abstract in the execute response. This element should not be used if the Abstract provided for this output in the ProcessDescription is adequate. Specifies if this output should be stored by the process as a web-accessible resource. If asReference is "true", the server shall store this output so that the client can retrieve it as required. If store is "false", all the output shall be encoded in the Execute operation response document. This parameter only applies to ComplexData outputs. This parameter shall not be included unless the corresponding "storeSupported" parameter is included and is "true" in the ProcessDescription for this process. Definition of a format, encoding, schema, and unit-of-measure for an output to be returned from a process. Unambiguous identifier or name of an output, unique for this process. Reference to the unit of measure (if any) requested for this output. A uom can be referenced when a client wants to specify one of the units of measure supported for this output. This uom shall be a unit of measure referenced for this output of this process in the Process full description. References the XML schema, format, and encoding of a complex value. The Format of this input or requested for this output (e.g., text/xml). This element shall be omitted when the Format is indicated in the http header of the output. When included, this format shall be one published for this output or input in the Process full description. The encoding of this input or requested for this output (e.g., UTF-8). This "encoding" shall be included whenever the encoding required is not the default encoding indicated in the Process full description. When included, this encoding shall be one published for this output or input in the Process full description. Web-accessible XML Schema Document that defines the content model of this complex resource (e.g., encoded using GML 2.2 Application Schema). This reference should be included for XML encoded complex resources to facilitate validation. PS I changed the name of this attribute to be consistent with the ProcessDescription. The original was giving me validation troubles in XMLSpy. Value of one input to a process. Unambiguous identifier or name of a process, unique for this server, or unambiguous identifier or name of an output, unique for this process. Title of a process or output, normally available for display to a human. Brief narrative description of a process or output, normally available for display to a human. Identifies the form of this input, and provides supporting information. Identifies the form of this input or output value, and provides supporting information. Identifies this input value as a web accessible resource, and references that resource. Identifies this input value as a data embedded in this request, and includes that data. Identifies the form of this input or output value, and provides supporting information. Identifies this input or output value as a complex data structure encoded in XML (e.g., using GML), and provides that complex data structure. For an input, this element may be used by a client for any process input coded as ComplexData in the ProcessDescription. For an output, this element shall be used by a server when "store" in the Execute request is "false". Identifies this input or output data as literal data of a simple quantity (e.g., one number), and provides that data. Identifies this input or output data as an ows:BoundingBox data structure, and provides that ows:BoundingBox data. Reference to an input or output value that is a web accessible resource. Extra HTTP request headers needed by the service identified in ../Reference/@href. For example, an HTTP SOAP request requires a SOAPAction header. This permits the creation of a complete and valid POST request. Key portion of the Key-Value pair in the HTTP request header. Value portion of the Key-Value pair in the HTTP request header. The contents of this element to be used as the body of the HTTP request message to be sent to the service identified in ../Reference/@href. For example, it could be an XML encoded WFS request using HTTP POST Reference to a remote document to be used as the body of the an HTTP POST request message to the service identified in ../Reference/@href. Reference to a remote document to be used as the body of the an HTTP POST request message. This attribute shall contain a URL from which this input can be electronically retrieved. Reference to a web-accessible resource that can be used as input, or is provided by the process as output. This attribute shall contain a URL from which this input/output can be electronically retrieved. Identifies the HTTP method. Allows a choice of GET or POST. Default is GET. Complex data (such as an image), including a definition of the complex value data structure (i.e., schema, format, and encoding). May be an ows:Manifest data structure. One simple literal value (such as an integer or real number) that is embedded in the Execute operation request or response. String containing the Literal value (e.g., "49"). Identifies the data type of this literal input or output. This dataType should be included for each quantity whose value is not a simple string. Identifies the unit of measure of this literal input or output. This unit of measure should be referenced for any numerical value that has units (e.g., "meters", but not a more complete reference system). Shall be a UOM identified in the Process description for this input or output.