OGC WPS规范详解（英文）.pdf

Open Geospatial Consortium Inc.Date:2007-06-08Reference number of this document:OGC 05007r7Version:.0.0Category；OpenGIS StandardEditor：Peter SchutOpenGIS Web Processing ServiceCopyright 2007 Open Geospatial Consortium,Inc All Rights Reserved To obtain additional rights of use,visit http:www.opengeospatial.org/legal/Document type:OGC Publicly A vailable StandardDocument Subtype:OGC StandardDocument stage:ApprovedDocument language:EnglishOGC05-007r7WarningOGC official documents use a triple decimal-dot notation(i.e.MM.xx.ss).This document may be identified as MM.xx(M(yor.minor)and may include increments to the third dot series(schema changes)without any modification to this document,or the version displayed on the document.This means,for example,that a document labelled with versions 1.1.0 and 1.1.1 or even 1.1.9 are exactly the scune except for modifications to the official schemas that are maintained and perpetually located at:httD： that corrections to the document are registered via corrigendums.A corrigendum will change the base document and notice will be given by appending a c#to the version(where#specifies the corrigendum number).In corrigendums that correct both the schemas and the base document,the third triplet of the document version will increment and the cl or subsequent identifier will be appended,however the schemas will only increase the third triplet of the version.This document is an OGC Standard.Recipients of this document are invited to submit,with their comments,notification of any relevant patent rights of which they are aware and to provide supporting documentation.Copyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.OGC 05-007r7ContentsPagei.Preface.ixii.Document terms and definitions.ixHi.Submitting organizations.ixiv.Document contributor contact points.xv.Revision history.xvi.Changes to the OGC Abstract Specification.xivii.Future work.xiForeword.xiiIntroduction.xiii1 Scope.12 Conformance.13 Normativ e references.14 Terms and definitions.25.1 A bbrev iated terms.5.2 UML notation.5.3 Used parts of other documents.5.4 Platform-neutral and platform-specific specifications6 WPS overview.7 2 3 4 5 6 WPS Operations.Generic nature of WPS.Middleware nature of WPS WPS Profiles.Service chaining with WPSWPS and SOAP/WSDL 7 Shared aspects.7.1 Introduction.7.2 Shared data structures.7.3 Operation request encoding.8 GetCapabilities operation(mandatory).8.1 Introduction.8.2 GetCapabilities operation request.8.2.1 HTTP GET request using KVP encoding(mandatory).8.2.2 GetCapabilities HTTP POST request using XML encoding(optional).8.3 GetCapabilities operation response.8.3.1 Normal response.8.3.2 OperationsMetadata section contents.8.3.3 ProcessOfferings section.Copyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved,HiOGC 05-007r78.3.48.3.58.3.68.3.7Languages section.WSDL section.Capabilities document XML encodingGetCapabilities exceptions.4 5 5 67 7 J 79 DescribeProcess operation(mandatory)9.19.29.2.19.2.29.2.39.39.3.19.3.29.3.3Introduction.DescribeProcess operation request.DescribeProcess request parameters.DescribeProcess HTTP GET request KVP encoding(mandatory)DescribePiocess HTTP POST request XML encoding(optional)DescribeProcess operation response.DescribeProcess response parameters.DescribeProcess response XML encoding.DescribeProcess exceptions.6666788890777777772310 Execute operation(mandatory).10.1 Introduction.10.2 Execute operation request.10.2.1 Execute request parameters.10.2.2 Execute HTTP GET request KVP encoding(optional).10.2.2.1 Encoding of Datalnput and Output values(mandatory).10.2.2.2 Chaining of requests using KVP(mandatory).10.2.3 Execute HTTP POST request XML encoding(mandatory)10.3 Execute operation response.10.3.1 Execute response parameters.10.3.2 Execute response XML encoding.10.3.3 Execute exceptions.Annex A(normative)Abstract test suite.A.lA.2A.2.1A.2.1A.2.2A.3C.lC.2C.3C.4C.5C.6Introduction.Client test module.GetCapabilities operation request.DescribeProcess operation request Execute operation request.Server test module.Annex B(normative)XML Schema DocumentsAnnex C(irtfonnative)UML model.A.4.1All operations implemented test moduleA.4.1.1HTTP protocol usage.A.4.2GetCapabilities operation test module.A.4.3DescribePiocess operation test module.A.4.4Execute operation test module.Introduction.UML packages.WPS Service package.WPS Get Capabilities package.WPS Describe Process package WPS Execute package.007789011788 007717711234 7 9901236333333444444 555555555555 5 5566666IVCopyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.OGC 05-007r7Annex D(normative)Use of WPS with SOAP.69D.l Overview.69D.2 SOA P encoding of WPS requests and responses.69Annex E(informative)WSDL best practices.71E.1 Overview.71E.2 WSDL document for the entire service.71E.3 WSDL document for specific processes.71E.4 WSDL example for a complete service.72Bibliography.73Copyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved,OGC05-007r7Figures PageFigure 1-WPS interface UML diagram.5Figure 2-Activity diagram when client requests storage of results.31Figure C.l 一 WPS interface UML diagram.59Figure C.3-WPS Service package class diagram.61Figure C.4-WPS Get Capabilities package class diagram.62Figure C.5-Describe Process package class diagram,part 1.63Figure C.6-Describe Process package class diagram,part 2.64Figure C.7-Describe Process package class diagram,part 3.65Figure C.8-Execute package class diagram,part 1.66Figure C.9 Execute package class diagram,part 2.67Figure C.10 一 Execute package class diagram,part 3.68Tables PageTable 1-Parameters in Description data structure.9Table 2-Parts of ProcessBrief data structure.10Table 3-Parts of WSDL data structure.10Table 4-Parts of Format data structure.10Table 5-Operation request encoding.11Table 6-Implementation of parameters in GetCapabilities operation request.11Table 7 Parts of Capabilities document.13Table 8-Operations described in the Operations Metadata section.14Table 9-Parts of ProcessOfferings section.14Table 10-Parts of Languages section.14Table 11 Language data structure.15Table 12-Parts of WSDL section.15Table 13-Parameters in DescribeProcess operation request.17Table 14-DescribeProcess operation request URL parameters.18Table 15-Parts of ProcessDescriptions data structure.21Table 16 Parts of ProcessDescription data structure.22Table 17-Parts of WSDL data structure.23Table 18-Parts of Datalnputs data structure.23Table 19-Parts of InputDescription data structure.23Table 20-Parts of InputFonnChoice data structure.24viCopyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.OGC 05-007r7SupportedComplexData data structure,see.24Table 21-Parts of ComplexData data structure.24Table 22-Parts of Default Format data structure.25Table 23-Parts of Format data structure.25Table 24-Parts of Supported Format data structure.25Table 25-Parts of Literalinput data structure.26Table 26-Parts ofUOMs data structure.26Table 27-Parts of Default UOM data structure.26Table 28-Parts of Supported UOM data structure.26Table 29-Parts of LitercdVcduesChoice data structure.27Table 30-Parts of Values Reference data structure.27Table 31-Parts of SupportedCRSs data structure.27Table 32-Parts of Default CRS data structure.27Table 33-Parts of Supported CRS data structure.28Table 34-Parts of ProcessOutputs data structure.28Table 35-Parts of OutputDescription data structure.28Table 36-Parts of OutputFormChoice data structure.29ComplexData data structure,see.29Table 37-Parts of LiteralOutput data structure.29Table 38-Exception codes for DescribeProcess operation.30Table 39-Parts of Execute operation request.32Table 40-Parts of Datalnputs data structure.33Table 41-Parts of InputType data structure.33Table 42-Parts of InputDataFomiChoice data structure.33Table 43-Parts of InputReference data structure.34Table 44-Parts of Header data structure.34Table 45-Parts of BodyReference data structure.34Table 46-Parts of DataType data structure.35Table 47-Parts of ComplexData data structure.35Table 48-Parts of LiteralData data structure.35Table 49-Parts of ResponseForm data structure.36Table 50-Parts of ResponseDocument data structure.36Table 51 Parts of DocumentOutputDefinition data structure.37Table 52-Parts of RawDataOutput data structure.37Table 53-Execute operation request URL parameters.38Table 54-Parts of ExecuteResponse data structure.44Table 55-Parts of Status data structure.45Copyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.VHOGC05-007r7Table 56-Parts of ProcessStarted data structure.46Table 57-Parts of ProcessFailed data structure.46Table 58-Parts of OutputDefinitions data structure.46Table 59-Parts of ProcessOutputs data structure.46Table 60-Parts of OutputData data structure.47Table 61-Parts of OutputReference data structure.47Table 62-Exception codes for Execute operation.49viiiCopyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved,OGC 05-007r7i.PrefaceThis document specifies the interface to a Web Processing Service(WPS).This document is the result of work undertaken to support the Canadian Geospatial Data Infrastructure(CGDI),and in particular the National Land and Water Information Service(NLWIS),and the National Forest Information Service(NFIS).The specification was first implemented as a prototype in 2004 by Agriculture and Agri-Food Canada(A AFC),In the first half of2005,it was the subject of a successful OGC Interoperability Experiment.Suggested additions,changes,and comments on this recommendation paper are welcome and encouraged.Such suggestions may be submitted by email message or by making suggested changes in an edited copy of this document.ii.Document terms and definitionsThis document uses the specification terms defined in Subclause 5.3 of OGC 06-121r3,which is based on the ISO/IEC Directives,Part 2.Rules for the structure and drafting of International Standards.In particular,the word“shall(not“must)is the verb form used to indicate a requirement to be strictly followed to conform to this specificationiii.Submitting organizationsThe following organizations submitted this document to the Open Geospatial Consortium Inc.GeoConnections/Natural Resources CanadaPCI GeomaticsCopyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.ixOGC05-007r7iv.Document contributor contact pointsAll questions regarding this document should be directed to the editor or the WPS Revision Working Group contributors:NameOrganizationTheodor ForsterrrcChristian HeierWupperverbandSteven KeensPCI GeomaticsChristian Kiehlelat/lon GmbHRachel ONeilESRI CanadaNicole OstlaenderJoint Research Centre(JRC)Joan Maso PauUniversitat A utonoma de Barcelona(CREA F)Peter SchutGeoConnectionsArliss WhitesideBAE Systems-National Security SolutionsThe Revision Working Group acknowledges the formative input to this specification from the following contributors:NameOrganizationMike AdairGeoConnectionsHarald BorsutzkyUniversity of Muenster-Institute for GeoinformaticsStephane FellahPCI GeomaticsXiaoyuan GengGeoConnectionsMartin KyleGaldos SystemsWeis he ng LiPCI GeomaticsMaru NewbyGeoConnectionsv.Revision historyDateReleaseEditorPrimary clauses modifiedDescription05 May 20040.1.0Peter.SchutAllInitial document,formatted for OGC template22 May 20040.1.0PeterSchutAllCleaned up some problems,added informative examples in Annex B21 Oct.20040.2.0Stephane FellahContentRewrite the schema and the Table of Contents22 Nov.20040.2.0Xiaoyuan GengAllCreated document using the latest OGC template,the initial draft,and schemaxCopyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.OGC05-007r7DateReleaseEditorPrimary clauses modifiedDescription24 Dec.20040.2.1Peter SchutAllMinor corrections and revisions throughout,additions of human readable explanations of schemas11 April 20050.2.3PeterSchutAllUpgrade based on results to date of WPSie.05 April 20050.3.0PeterSchutAllUpgrade based on results to date of WPSie and alignment with OWS Common13 July 20050.4.0PeterSchut6&7Complete documentation of each element and renaming of elements to eliminate confusion caused by abstractions1 Sept 20050.4.0Arliss WhitesideAllAdded UML diagrams,aligned with new schemas.16 Sept 20050.4.0Peter Schut and Arliss WhitesideAllFinal editing and cleanup for the WPS RFC08 June 20071.0.0PeterSchutAllComplete rewrite based on comments received in the WPS RFC and additional change requests handled by the WPS RWG.vi.Changes to the OGC Abstract SpecificationThe OpenGIS Abstract Specification does not require changes to accommodate the technical contents of this document.vii.Future workCopyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.XIOGC05-007r7ForewordThe Web Processing Service(WPS)was originally named Geoprocessing Service(OGC document number 04-043).The name was changed to Web Processing Serviceearly in its development to avoid the acronym GPS,since this would have caused confusion with the conventional use of this acronym for Global Positioning System.Since WPS is an OGC specification,the term geospatial would have been redundant.A version of WPS was released in September 2005 as document number 05-007r4,and was the subject of an OGC RFC.This document replaces those earlier draft documents.The WPS Interoperability Experiment(see OGC document 05-051rl)demonstrated that clients developed by different organizations could readily access and bind to services that are set up in accordance with the WPS Implementation Specification.Version 1.0.0 incorporates the recommendations that were made during that Interoperability Experiment and subsequent comments received through OGCs RFC process and the subsequent OWS-4 test bed.This document includes five annexes;A nnexes A,B,and D are nonnative,while Annex C and Fare informative.Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights.The OGC shall not be held responsible for identifying any or all such patent rights.Recipients of this document are requested to submit,with their comments,notification of any relevant patent claims or other intellectual property rights of which they may be aware that might be infringed by any implementation of the standard set forth in this document,and to provide supporting documentation.xiiCopyright 2007 Open Geospatial Consortium,Inc.All Rights Reserved.OGC 05-007r7IntroductionThis document specifies the interface to a Web Processing Service(WPS).WPS defines a standardized inteiface that facilitates the publishing of geospatial processes,and the discovery of and binding to those processes by clients.tTrocesses include any algorithm,calculation or model that operates on spatially referenced data.Publishing”means making available machine-readable binding information as well as human-readable metadata that allows service discovery and use.A WPS can be configured to offer any sort of GIS functionality to clients across a network,including access to pre-programmed calculations and/or computation models that operate on spatially refe