source: TI02-CSML/trunk/services/specs/WPS draft 20051117/wps/0.4.0/wpsDescribeProcess.xsd @ 2194

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI02-CSML/trunk/services/specs/WPS draft 20051117/wps/0.4.0/wpsDescribeProcess.xsd@2194
Revision 2194, 21.1 KB checked in by lawrence, 13 years ago (diff)

Adding various specs and 3rd party code of interest for the CSML
services development.

Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:wps="http://www.opengeospatial.net/wps" xmlns:ows="http://www.opengeospatial.net/ows" targetNamespace="http://www.opengeospatial.net/wps" elementFormDefault="qualified" version="0.4.0" xml:lang="en">
3        <annotation>
4                <appinfo>$Id: wpsDescribeProcess.xsd 2005-09-12 $</appinfo>
5                <documentation>This XML Schema Document encodes the WPS DescribeProcess operation request and response.
6                Copyright (c) Open Geospatial Consortium (2005). </documentation>
7        </annotation>
8        <!-- =============================================================
9                includes and imports
10        ============================================================== -->
11        <include schemaLocation="wpsCommon.xsd"/>
12        <import namespace="http://www.opengeospatial.net/ows" schemaLocation="../../ows/1.0.0/owsDataIdentification.xsd"/>
13        <import namespace="http://www.opengeospatial.net/ows" schemaLocation="../../ows/1.0.0/owsDomainType.xsd"/>
14        <!-- =============================================================
15                elements and types
16        ============================================================== -->
17        <element name="DescribeProcess">
18                <annotation>
19                        <documentation>WPS DescribeProcess operation request. </documentation>
20                </annotation>
21                <complexType>
22                        <complexContent>
23                                <extension base="wps:RequestBaseType">
24                                        <sequence>
25                                                <element ref="ows:Identifier" maxOccurs="unbounded">
26                                                        <annotation>
27                                                                <documentation>Unordered list of one or more identifiers of the processes for which the client is requesting detailed descriptions. This element shall be repeated for each process for which a description is requested. These Identifiers are unordered, but the WPS shall return the descriptions in the order in which they were requested. </documentation>
28                                                        </annotation>
29                                                </element>
30                                        </sequence>
31                                </extension>
32                        </complexContent>
33                </complexType>
34        </element>
35        <!-- =========================================================== -->
36        <element name="ProcessDescriptions">
37                <annotation>
38                        <documentation>WPS DescribeProcess operation response. </documentation>
39                </annotation>
40                <complexType>
41                        <sequence>
42                                <element name="ProcessDescription" type="wps:ProcessDescriptionType" maxOccurs="unbounded">
43                                        <annotation>
44                                                <documentation>Ordered list of one or more full Process descriptions, listed in the order in which they were requested in the DescribeProcess operation request. </documentation>
45                                        </annotation>
46                                </element>
47                        </sequence>
48                </complexType>
49        </element>
50        <!-- =========================================================== -->
51        <complexType name="ProcessDescriptionType">
52                <annotation>
53                        <documentation>Full description of a process. </documentation>
54                </annotation>
55                <complexContent>
56                        <extension base="wps:ProcessBriefType">
57                                <sequence>
58                                        <element name="DataInputs" minOccurs="0">
59                                                <annotation>
60                                                        <documentation>List of the inputs to this process. In almost all cases, at least one process input is required. However, no process inputs may be identified when all the inputs are predetermined fixed resources.  In this case, those resources shall be identified in the ows:Abstract element that describes the process.</documentation>
61                                                </annotation>
62                                                <complexType>
63                                                        <sequence>
64                                                                <element name="Input" type="wps:InputDescriptionType" maxOccurs="unbounded">
65                                                                        <annotation>
66                                                                                <documentation>Unordered list of one or more descriptions of the inputs that can be accepted by this process, including all required and optional inputs.  Where an input is optional because a default value exists, that default value must be identified in the "ows:Abstract" element for that input, except in the case of LiteralData, where the default must be indicated in the corresponding ows:DefaultValue element. Where an input is optional because it depends on the value(s) of other inputs, this must be indicated in the ows:Abstract element for that input. </documentation>
67                                                                        </annotation>
68                                                                </element>
69                                                        </sequence>
70                                                </complexType>
71                                        </element>
72                                        <element name="ProcessOutputs">
73                                                <annotation>
74                                                        <documentation>List of outputs which will or can result from executing the process. </documentation>
75                                                </annotation>
76                                                <complexType>
77                                                        <sequence>
78                                                                <element name="Output" type="wps:OutputDescriptionType" maxOccurs="unbounded">
79                                                                        <annotation>
80                                                                                <documentation>Unordered list of one or more descriptions of all the outputs that can result from executing this process. At least one output is required from each process. </documentation>
81                                                                        </annotation>
82                                                                </element>
83                                                        </sequence>
84                                                </complexType>
85                                        </element>
86                                </sequence>
87                                <attribute name="storeSupported" type="boolean" use="optional" default="false">
88                                        <annotation>
89                                                <documentation>Indicates if the ComplexData outputs from this process can be stored by the WPS server as web-accessible resources. If "storeSupported" is "true", the Execute operation request may include "store" equals "true", directing that all ComplexData outputs of the process be stored so that the client can retrieve them as required. By default for this process, storage is not supported and all outputs are returned encoded in the Execute response. </documentation>
90                                        </annotation>
91                                </attribute>
92                                <attribute name="statusSupported" type="boolean" use="optional" default="false">
93                                        <annotation>
94                                                <documentation>Indicates if the Execute operation response can be returned quickly with status information, or will not be returned until process execution is complete. If "statusSupported" is "true", the Execute operation request may include "status" equals "true", directing that the Execute operation response be returned quickly with status information. By default, status information is not provided for this process, and the Execute operation response is not returned until process execution is complete. </documentation>
95                                        </annotation>
96                                </attribute>
97                        </extension>
98                </complexContent>
99        </complexType>
100        <!-- =================INPUT PARAMETERS======================== -->
101        <!-- =========================================================== -->
102        <complexType name="InputDescriptionType">
103                <annotation>
104                        <documentation>Description of an input to a process. </documentation>
105                </annotation>
106                <complexContent>
107                        <extension base="wps:DescriptionType">
108                                <annotation>
109                                        <documentation>In this use, the DescriptionType shall describe this process input. </documentation>
110                                </annotation>
111                                <sequence>
112                                        <group ref="wps:InputFormChoice"/>
113                                        <element name="MinimumOccurs" minOccurs="0">
114                                                <annotation>
115                                                        <documentation>The minimum number of times that values for this parameter are required. If MinimumOccurs is "0", this data input is optional. If MinimumOccurs is "1" or if this element is omitted, this process input is required. </documentation>
116                                                </annotation>
117                                                <simpleType>
118                                                        <restriction base="nonNegativeInteger">
119                                                                <enumeration value="0"/>
120                                                                <enumeration value="1"/>
121                                                        </restriction>
122                                                </simpleType>
123                                        </element>
124                                </sequence>
125                        </extension>
126                </complexContent>
127        </complexType>
128        <!-- =========================================================== -->
129        <group name="InputFormChoice">
130                <annotation>
131                        <documentation>Identifies the form of this output and provides supporting information. </documentation>
132                </annotation>
133                <choice>
134                        <element name="ComplexData" type="wps:SupportedComplexDataType">
135                                <annotation>
136                                        <documentation>Indicates that this input shall be a complex data structure (such as a GML document), and provides a list of formats and encodings supported for this Input. The value of this ComplexData structure can be input either embedded in the Execute request or remotely accessible to the server.
137                                        This element also provides a list of formats, encodings, and schemas supported for this output. The client can select from among the identified combinations of formats, encodings, and schemas to specify the form of the output. This allows for complete specification of particular versions of GML, or image formats. </documentation>
138                                </annotation>
139                        </element>
140                        <element name="LiteralData" type="wps:LiteralInputType">
141                                <annotation>
142                                        <documentation>Indicates that this input shall be a simple numeric value or character string that is embedded in the execute request, and describes the possible values. </documentation>
143                                </annotation>
144                        </element>
145                        <element name="BoundingBoxData" type="wps:SupportedCRSsType">
146                                <annotation>
147                                        <documentation>Indicates that this input shall be a BoundingBox data structure that is embedded in the execute request, and provides a list of the CRSs supported for this Bounding Box. </documentation>
148                                </annotation>
149                        </element>
150                </choice>
151        </group>
152        <!-- =========================================================== -->
153        <complexType name="LiteralInputType">
154                <annotation>
155                        <documentation>Description of a process input that consists of a simple literal value (e.g., "2.1"). (Informative: This type is a subset of the ows:UnNamedDomainType defined in owsDomaintype.xsd.) </documentation>
156                </annotation>
157                <complexContent>
158                        <extension base="wps:LiteralOutputType">
159                                <sequence>
160                                        <group ref="wps:LiteralValuesChoice"/>
161                                        <element ref="ows:DefaultValue" minOccurs="0">
162                                                <annotation>
163                                                        <documentation>Optional default value for this quantity, which should be included when this quantity has a default value. </documentation>
164                                                </annotation>
165                                        </element>
166                                </sequence>
167                        </extension>
168                </complexContent>
169        </complexType>
170        <!-- ========================================================== -->
171        <group name="LiteralValuesChoice">
172                <annotation>
173                        <documentation>Identifies the type of this literal input and provides supporting information. </documentation>
174                </annotation>
175                <choice>
176                        <element ref="ows:AllowedValues">
177                                <annotation>
178                                        <documentation>Indicates that there are a finite set of values and ranges allowed for this input, and contains list of all the valid values and/or ranges of values. Notice that these values and ranges can be displayed to a human client. </documentation>
179                                </annotation>
180                        </element>
181                        <element ref="ows:AnyValue">
182                                <annotation>
183                                        <documentation>Indicates that any value is allowed for this input. This element shall be included when there are no restrictions, except for data type, on the allowable value of this input. </documentation>
184                                </annotation>
185                        </element>
186                        <element ref="ows:ValuesReference">
187                                <annotation>
188                                        <documentation>Indicates that there are a finite set of values and ranges allowed for this input, which are specified in the referenced list. </documentation>
189                                </annotation>
190                        </element>
191                </choice>
192        </group>
193        <!-- ================= INPUT AND OUTPUT TYPES =================== -->
194        <!-- =========================================================== -->
195        <complexType name="SupportedUOMsType">
196                <annotation>
197                        <documentation>List of supported units of measure for a process input or output. </documentation>
198                </annotation>
199                <sequence>
200                        <element ref="ows:UOM" minOccurs="0" maxOccurs="unbounded">
201                                <annotation>
202                                        <documentation>Unordered list of references to the Units of Measure supported for this input or output. This element shall not be included if there is only one (i.e., the default) UOM supported. </documentation>
203                                </annotation>
204                        </element>
205                </sequence>
206                <attribute name="defaultUOM" type="anyURI" use="optional">
207                        <annotation>
208                                <documentation>Reference to the default UOM supported for this input or output, if any. The process shall expect input in or produce output in this UOM unless the Execute request specifies another supported UOM. </documentation>
209                        </annotation>
210                </attribute>
211        </complexType>
212        <!-- =========================================================== -->
213        <complexType name="SupportedCRSsType">
214                <annotation>
215                        <documentation>List of supported Coordinate Reference Systems. </documentation>
216                </annotation>
217                <sequence>
218                        <element name="CRS" type="anyURI" minOccurs="0" maxOccurs="unbounded">
219                                <annotation>
220                                        <documentation>Unordered list of references to the coordinate reference systems supported. This element shall not be included if there is only one (i.e., the default) CRS supported. </documentation>
221                                </annotation>
222                        </element>
223                </sequence>
224                <attribute name="defaultCRS" type="anyURI" use="required">
225                        <annotation>
226                                <documentation>Reference to the CRS that will be used unless the Execute operation request specifies another supported CRS. </documentation>
227                        </annotation>
228                </attribute>
229        </complexType>
230        <!-- =========================================================== -->
231        <complexType name="SupportedComplexDataType">
232                <annotation>
233                        <documentation>Formats, encodings, and schemas supported by a process input or output. </documentation>
234                </annotation>
235                <sequence>
236                        <element name="SupportedComplexData" type="wps:ComplexDataType" minOccurs="0" maxOccurs="unbounded">
237                                <annotation>
238                                        <documentation>Unordered list of combinations of format, encoding, and schema supported for this Input or Output (an example of one such combination is format=text/XML, encoding=UTF-8, schema=GML 2.1). This element should be included when this process supports more than one combination of format/encoding/schema for this Input/Output. This element shall be repeated for each combination of Format/Encoding/Schema that is supported for this Input/Output. This element shall not be included if there is only one (i.e., the default) Format/Encoding/Schema combination. </documentation>
239                                </annotation>
240                        </element>
241                </sequence>
242                <attribute name="defaultFormat" type="ows:MimeType" use="optional">
243                        <annotation>
244                                <documentation>Identifier of the default Format supported for this input or output. The process shall expect input in or produce output in this Format unless the Execute request specifies another supported Format. This parameter shall be included when the default Format is other than text/XML. This parameter is optional if the Format is text/XML.
245</documentation>
246                        </annotation>
247                </attribute>
248                <attribute name="defaultEncoding" type="anyURI" use="optional">
249                        <annotation>
250                                <documentation>Reference to the default encoding supported for this input or output. The process will expect input using or produce output using this encoding unless the Execute request specifies another supported encoding. This parameter shall be included when the default Encoding is other than the encoding of the XML response document (e.g. UTF-8). This parameter shall be omitted when there is no Encoding required for this input/output. </documentation>
251                        </annotation>
252                </attribute>
253                <attribute name="defaultSchema" type="anyURI" use="optional">
254                        <annotation>
255                                <documentation>Reference to the definition of the default XML element or type supported for this input or output. This XML element or type shall be defined in a separate XML Schema Document. The process shall expect input in or produce output conformant with this XML element or type unless the Execute request specifies another supported XML element or type. This parameter shall be omitted when there is no XML Schema associated with this input/output (e.g., a GIF file). This parameter shall be included when this input/output is XML encoded using an XML schema. When included, the input/output shall validate against the referenced XML Schema. Note: If the input/output uses a profile of a larger schema, the server administrator should provide that schema profile for validation purposes. </documentation>
256                        </annotation>
257                </attribute>
258        </complexType>
259        <!-- =========================================================== -->
260        <complexType name="ComplexDataType">
261                <annotation>
262                        <documentation>A combination of format, encoding, and/or schema supported by a process input or output. </documentation>
263                </annotation>
264                <sequence>
265                        <element name="Format" type="ows:MimeType" minOccurs="0">
266                                <annotation>
267                                        <documentation>Format supported for this input or output (e.g., text/XML). This element shall be included when the format for this ComplexDataType differs from the defaultFormat for this Input/Output. This element shall not be included if there is only one (i.e., the default) format supported for this Input/Output, or Format does not apply to this Input/Output. </documentation>
268                                </annotation>
269                        </element>
270                        <element name="Encoding" type="anyURI" minOccurs="0">
271                                <annotation>
272                                        <documentation>Reference to an encoding supported for this input or output (e.g., UTF-8). This element shall be included when the encoding for this ComplexDataType differs from the defaultEncoding for this Input/Output. This element shall not be included if there is only one (i.e., the default) encoding supported for this Input/Output, or Encoding does not apply to this Input/Output. </documentation>
273                                </annotation>
274                        </element>
275                        <element name="Schema" type="anyURI" minOccurs="0">
276                                <annotation>
277                                        <documentation>Reference to a definition of XML elements or types supported for this Input or Output (e.g., GML 2.1 Application Schema). Each of these XML elements or types shall be defined in a separate XML Schema Document. This element shall be included when the schema for this ComplexDataType differs from the defaultSchema for this Input/Output. This element shall not be included if there is only one (i.e., the default) XML Schema Document supported for this Input/Output, or Schema does not apply to this Input/Output. </documentation>
278                                </annotation>
279                        </element>
280                </sequence>
281        </complexType>
282        <!-- =================OUTPUT PARAMETERS======================= -->
283        <!-- =========================================================== -->
284        <complexType name="OutputDescriptionType">
285                <annotation>
286                        <documentation>Description of a process Output. </documentation>
287                </annotation>
288                <complexContent>
289                        <extension base="wps:DescriptionType">
290                                <annotation>
291                                        <documentation>In this use, the DescriptionType shall describe this process output. </documentation>
292                                </annotation>
293                                <group ref="wps:OutputFormChoice"/>
294                        </extension>
295                </complexContent>
296        </complexType>
297        <!-- =========================================================== -->
298        <group name="OutputFormChoice">
299                <annotation>
300                        <documentation>Identifies the form of this output, and provides supporting information. </documentation>
301                </annotation>
302                <choice>
303                        <element name="ComplexOutput" type="wps:SupportedComplexDataType">
304                                <annotation>
305                                        <documentation>Indicates that this Output shall be a complex data structure (such as a GML fragment) that is returned by the execute operation response. The value of this complex data structure can be output either embedded in the execute operation response or remotely accessible to the client. When this output form is indicated, the process produces only a single output, and "store" is "false, the output shall be returned directly, without being embedded in the XML document that is otherwise provided by execute operation response.
306                                        This element also provides a list of format, encoding, and schema combinations supported for this output. The client can select from among the identified combinations of formats, encodings, and schemas to specify the form of the output. This allows for complete specification of particular versions of GML, or image formats. </documentation>
307                                </annotation>
308                        </element>
309                        <element name="LiteralOutput" type="wps:LiteralOutputType">
310                                <annotation>
311                                        <documentation>Indicates that this output shall be a simple literal value (such as an integer) that is embedded in the execute response, and describes that output. </documentation>
312                                </annotation>
313                        </element>
314                        <element name="BoundingBoxOutput" type="wps:SupportedCRSsType">
315                                <annotation>
316                                        <documentation>Indicates that this output shall be a BoundingBox data structure, and provides a list of the CRSs supported in these Bounding Boxes. This element shall be included when this process output is an ows:BoundingBox element. </documentation>
317                                </annotation>
318                        </element>
319                </choice>
320        </group>
321        <!-- =========================================================== -->
322        <complexType name="LiteralOutputType">
323                <annotation>
324                        <documentation>Description of a literal output (or input). </documentation>
325                </annotation>
326                <sequence>
327                        <element ref="ows:DataType" minOccurs="0">
328                                <annotation>
329                                        <documentation>Data type of this set of values (e.g. integer, real, etc). This data type metadata should be included for each quantity whose data type is not a string. </documentation>
330                                </annotation>
331                        </element>
332                        <element name="SupportedUOMs" type="wps:SupportedUOMsType" minOccurs="0">
333                                <annotation>
334                                        <documentation>List of supported units of measure for this input or output. This element should be included when this literal has a unit of measure (e.g., "meters", without a more complete reference system). Not necessary for a count, which has no units. </documentation>
335                                </annotation>
336                        </element>
337                </sequence>
338        </complexType>
339        <!-- =========================================================== -->
340</schema>
Note: See TracBrowser for help on using the repository browser.