$Id: wpsExecute_response.xsd 2007-10-09 $ This XML Schema Document encodes the WPS Execute operation response. WPS is an OGC Standard. Copyright (c) 2007,2010 Open Geospatial Consortium. To obtain additional rights of use, visit http://www.opengeospatial.org/legal/ . WPS Execute operation response. By default, this XML document is delivered to the client in response to an Execute request. If "status" is "false" in the Execute operation request, this document is normally returned when process execution has been completed. If "status" in the Execute request is "true", this response shall be returned as soon as the Execute request has been accepted for processing. In this case, the same XML document is also made available as a web-accessible resource from the URL identified in the statusLocation, and the WPS server shall repopulate it once the process has completed. It may repopulate it on an ongoing basis while the process is executing. However, the response to an Execute request will not include this element in the special case where the output is a single complex value result and the Execute request indicates that "store" is "false". Instead, the server shall return the complex result (e.g., GIF image or GML) directly, without encoding it in the ExecuteResponse. If processing fails in this special case, the normal ExecuteResponse shall be sent, with the error condition indicated. This option is provided to simplify the programming required for simple clients and for service chaining. Process description from the ProcessOfferings section of the GetCapabilities response. Execution status of this process. Inputs that were provided as part of the execute request. This element shall be omitted unless the lineage attribute of the execute request is set to "true". Complete list of Output data types that were requested as part of the Execute request. This element shall be omitted unless the lineage attribute of the execute request is set to "true". List of values of the Process output parameters. Normally there would be at least one output when the process has completed successfully. If the process has not finished executing, the implementer can choose to include whatever final results are ready at the time the Execute response is provided. If the reference locations of outputs are known in advance, these URLs may be provided before they are populated. Unordered list of values of all the outputs produced by this process. It is not necessary to include an output until the Status is ProcessSucceeded. This attribute shall contain the GetCapabilities URL of the WPS service which was invoked The URL referencing the location from which the ExecuteResponse can be retrieved. If "status" is "true" in the Execute request, the ExecuteResponse should also be found here as soon as the process returns the initial response to the client. It should persist at this location as long as the outputs are accessible from the server. The outputs may be stored for as long as the implementer of the server decides. If the process takes a long time, this URL can be repopulated on an ongoing basis in order to keep the client updated on progress. Before the process has succeeded, the ExecuteResponse contains information about the status of the process, including whether or not processing has started, and the percentage completed. It may also optionally contain the inputs and any ProcessStartedType interim results. When the process has succeeded, the ExecuteResponse found at this URL shall contain the output values or references to them. Definition of a format, encoding, schema, and unit-of-measure for an output to be returned from a process. Output definition as provided in the execute request Value of one output from a process. In this use, the DescriptionType shall describe this process output. Identifies the form of this output, and provides supporting information. Identifies the form of this input or output value, and provides supporting information. Identifies this output as a web accessible resource, and references that resource. This element shall only be used for complex data. This element shall be used by a server when "store" in the Execute request is "true". Identifies this output value as a data embedded in this response, and includes that data. This element shall be used by a server when "store" in the Execute request is "false". Reference to an output value that is a web accessible resource. Reference to a web-accessible resource that is provided by the process as output. This attribute shall contain a URL from which this output can be electronically retrieved. Description of the status of process execution. Indicates that this process has been accepted by the server, but is in a queue and has not yet started to execute. The contents of this human-readable text string is left open to definition by each server implementation, but is expected to include any messages the server may wish to let the clients know. Such information could include how long the queue is, or any warning conditions that may have been encountered. The client may display this text to a human user. Indicates that this process has been accepted by the server, and processing has begun. Indicates that this process has been accepted by the server, and processing has started but subsequently been paused by the server. Indicates that this process has successfully completed execution. The contents of this human-readable text string is left open to definition by each server, but is expected to include any messages the server may wish to let the clients know, such as how long the process took to execute, or any warning conditions that may have been encountered. The client may display this text string to a human user. The client should make use of the presence of this element to trigger automated or manual access to the results of the process. If manual access is intended, the client should use the presence of this element to present the results as downloadable links to the user. Indicates that execution of this process has failed, and includes error information. The time (UTC) that the process finished. If the process is still executing or awaiting execution, this element shall contain the creation time of this document. Indicates that this process has been has been accepted by the server, and processing has begun. A human-readable text string whose contents are left open to definition by each WPS server, but is expected to include any messages the server may wish to let the clients know. Such information could include how much longer the process may take to execute, or any warning conditions that may have been encountered to date. The client may display this text to a human user. Percentage of process that has been completed, where 0 means the process has just started, and 99 means the process is almost complete. This value is expected to be accurate to within ten percent. Indicator that the process has failed to execute successfully. The reason for failure is given in the exception report.