06-027r1_wfs_1.1_schema_corrigendum

8/13/2019 06-027r1_WFS_1.1_Schema_Corrigendum

1/35

Open Geospatial Consortium Inc.

Date:2006-02-12

Reference number of this document:OGC 06-027r1

Version:1.1.0

Category: OpenGIS

IS Corrigendum

Editor: Panagiotis (Peter) A. Vretanos

Corrigendum for the OpenGISWeb Feature Service

(WFS) implementation specification 04-095

Copyright 2006 Open Geospatial Consortium, Inc. All Rights Reserved.

To obtain additional rights of use, visit http://www.opengeospatial.org/legal/.

Document type: OpenGIS

IS

Document subtype: Implementation Specification Corrigendum

Document stage: Proposed

Document language: English
http://www.opengeospatial.org/legal/http://www.opengeospatial.org/legal/


2/35


3/35

OGC 06-027r1

Copyright 2006 Open Geospatial Consortium, Inc. All Rights Reserved. iii

i. Preface

This document is a corrigendum for OGC Document 04-094. Specifically, this document

corrects the files referenced in ANNEX A and found in the OGC schema repository.

ii. Document terms and definitions

This document uses the specification terms defined in Subclause 5.3 of [OGC 05-008]. In

particular, the word shall (not must) is the verb form used to indicate a requirementto be strictly followed to conform to this specification.

iii. Document contributor contact points

All questions regarding this submission should be directed to the editor or thecontributors.

Editor:

Panagiotis (Peter) A. Vretanos (Editor)CubeWerx Inc.

pvretano {at} cubewerx.com

Contributors:

Name Organization

Kammersell,Willian

BBNT Solutions LLC

Lansing, Jeff SYS Technologies Inc.

iv. Revision history

Date Release Editor Primary clausesmodified

Description

2006-02-12 1.0.0 Panagiotis(Peter) A.Vretanos

wfs.xsd The copy of wfs.xsd currently available in theOGC schema repository does not validate andthis is causing WFS requests that reference itto not validate as well. This corrigendum liststhe changes required to fix wfs.xsd so that itvalidates.


4/35

OGC 06-027r1

iv Copyright 2006 Open Geospatial Consortium, Inc. All Rights Reserved.

v. Changes to OGC Specifications

The previously approved OGC Specifications do not need changes to accommodate thetechnical contents of this document.


5/35

OGC 06-027r1

Copyright 2006 Open Geospatial Consortium, Inc. All Rights Reserved. v

Foreword

This document provides the details for a corrigendum for the files referenced in ANNEX

A of the Web Feature Service implementation specification version 1.1.0 and does not

modify that implementation specification.

Attention is drawn to the possibility that some of the elements of this document may bethe subject of patent rights. The OGC shall not be held responsible for identifying any or

all such patent rights.


6/35

OGC 06-027r1

vi Copyright 2006 Open Geospatial Consortium, Inc. All Rights Reserved.

Introduction

This document contains revision notes for 04-094. The OGC document 04-094 was

approved by the OGC membership on 2004-12-22. As a result of the RWG process, therewere a number of edits and enhancements made to this specification. This document

provides the details of those edits, deficiency corrections, and enhancements. It also

documents those items that have been deprecated.


7/35

OpenGIS

Corrigendum OGC 06-027

Copyright 2006 Open Geospatial Consortium, Inc. All Rights Reserved. 1

Corrigendum for the OpenGISWFS implementation specification 04-

094

1 Scope

The Web Feature Service implementation specification (04-094) defines a set of

operations that allow clients to query, insert, update and delete feature instances for web-accessible feature repositories. ANNEX A of that specification references a set of files in

the OGC schema repository (http://schemas.opengis.net/wfs/1.1.0) that define the XML

encoding of those operations as well as documents that describe the API using the WebServices Description Language (WSDL). Those files either contain errors that prevent

them from validating or do not exist at all.

This document provides the details for a corrigendum that corrects the referenced files

that have errors and adds the files that are referenced in ANNEX A but do not currently

exist in the OGC schema repository.

2 Normative references

The following is a list of any normative document references that have changed for this

Corrigendum. A good example might be that this revision of the specification references

the latest OWS Common Specification. For undated references, the latest edition of the

normative document referred to applies.

[1] [OGC 04-094], OpenGIS Web Feature Service Implementation Specification

version 1.1

3 Corrigendum Description

3.1 Changes to ANNEX A of 04-094

ANNEX A of 04-094 should be changed to read:

In order to keep this document to a reasonable length, the normative schemas are notincluded inline but are attached to the archive package that includes this document.

Optionally, the schemas can be obtained at http://schemas.opengis.net/wfs.

The files that make up the WFS schemas, WSDL documents and example are:

1. 1. 0/ wf s. xsd1. 1. 0/ wsdl / wf s- ht t p- bi ndi ngs. wsdl1. 1. 0/ wsdl / wf s- kvp- bi ndi ngs. wsdl
http://schemas.opengis.net/wfs/1.1.0http://schemas.opengis.net/wfs/1.1.0


8/35

OGC 06-027r1

2 Copyright 2006 Open Geospatial Consortium, Inc. All Rights Reserved.

1. 1. 0/ wsdl / wf s- kvp- i nt er f aces. wsdl1. 1. 0/ wsdl / wf s- kvp. xsd1. 1. 0/ wsdl / wf s- r esponses. wsdl1. 1. 0/ wsdl / wf s- ut i l . xsd1. 1. 0/ wsdl / wf s- xml - i nt er f aces. wsdl1. 1. 0/ wsdl / WSDL2J ava. bat

1. 1. 0/ exampl es/ WFS_Capabi l i t i es_Sampl e. xml

3.2 Changes to the XML Schema wfs.xsd

ANNEX A contains a copy of the wfs.xsdXML Schema document that was distributed

with 04-094. The schema in ANNEX A has been annotated with line numbers, which are

used in Table 1 to indicate where the specific changes listed should be made.

The columns in Table 1 contain the following information:

Line #: The line number where a change has been made is show here.

The line number refers to the line numbers in the annotatedschema in ANNEX A.

O: The letter contained in the column denotes the operation

performed at that indicated line number; A=add, C=change,

D=delete.

Original Text: The XML Schema fragment that currently exists in the schema inANNEX A is shown here. If an addition is being made then this

column can be empty.

Replacement Text: The XML Schema fragment that should replace the existing

fragment is shown here. If a deletion is being made then thiscolumn can be empty

Reason: A brief explanation about the change.

Validity of the resulting schema has been checked using the following validating XMLparsers: XSV Web Form version 2.10-1, XML Spy version 2006 sp1 and Xerces version

2.7.1 (Java).

Table 1 Changes to wfs.xsd

Line

#

O Original Text Replacement Text Reason

1795 C

The element is named"InsertResults" so thetype should be renamed tomatch.

1692 C Type="wf s: I nser t Resul t Type"> t ype="wf s: I nser t Resul t sType" > The element is named"InsertResults" so thetype should be renamed tomatch.


9/35

OGC 06-027r1


Line#

O Original Text Replacement Test Reason

1342 C

_FeatureCollectionand _Feature arealready substitutablefor each other so youdon't need toreference them twice.

1253 C

Derived from wrongbase type.

695 A

See line 88.

344 C

MIME types, such astext/xml, are notvalid NMTOKENtypes.

334 C

MIME types, such astext/xml, are not

valid NMTOKENtypes.

304 C

164 D subst i t ut i onGr oup="ows: Capabi l i t i es" This element doesnot exist so youcannot substitute forit.

129 A

See line 99

99 A

See line 87

88 D subst i t ut i onGr oup="wf s: Propert yName"> a choice group canbe used to encodeeither PropertyName

orXlinkPropertyName

87 C


10/35

OGC 06-027r1


ANNEX AAnnotated XML Schema wfs.xsd distributed with 04-094

1

2 11

12

14 ============================================================== - - > 15 17 19 21

22 23 24 25 26 27 28 XML encoded WFS operat i on r equest base, f or al l operat i ons

29 except GetCapabi l i t i es.30

31 32 34

35 36 The servi ce att r i but e i s i ncl uded t o support servi ce37 endpoi nt s t hat i mpl ement mor e t han one OGC ser vi ce.38 For exampl e, a si ngl e CGI t hat i mpl ements WMS, WFS39 and WCS ser vi ces.40 The endpoi nt can i nspect t he val ue of t hi s att r i but e41 t o f i gur e out whi ch servi ce shoul d pr ocess t he r equest.42 The val ue WFS i ndi cates t hat a web f eat ur e ser vi ce shoul d43 pr ocess t he r equest .44 Thi s par amet er i s somewhat r edundant i n t he XML encodi ng45 si nce t he r equest namespace can be used t o determi ne46 whi ch servi ce shoul d process any gi ve r equest . For exampl e,47 wf s: Get Capabi l i t i es and easi l y be di st i ngui shed f r om

48 wcs: GetCapabi l i t i es usi ng t he namespaces.49

50 51

52 54 55 56 The ver si on att r i but e i s used t o i ndi cat e t he ver si on of t he

57 WFS speci f i cat i on t hat a r equest conf orms t o. Al l r equests i n58 t hi s schema conf orm t o V1. 1 of t he WFS speci f i cat i on.59 For WFS i mpl ement at i ons t hat suppor t more t han one vers i on of60 a WFS sepci f i cat i on . . . i f t he ver si on at t r i but e i s not61 speci f i ed t hen t he servi ce shoul d assume t hat t he r equest62 conf or ms t o gr eat est avai l abl e speci f i cat i on ver si on.63

64 65


11/35

OGC 06-027r1


66

68 69 70 The handl e at t r i but e al l ows a cl i ent appl i cat i on

71 t o assi gn a cl i ent - gener at ed r equest i dent i f i er72 t o a WFS r equest . The handl e i s i ncl uded t o73 f aci l i t ate err or r eport i ng. A WFS may r eport t he74 handl e i n an except i on r eport t o i dent i f y t he75 of f endi ng r equest or act i on. I f t he handl e i s not76 present , t hen t he WFS may empl oy ot her means t o77 l ocal i ze t he er r or ( e. g. l i ne number s) .78

79 80 81 82

83 84 85 86 87 89 90

91 Thi s el ement may be used i n pl ace of an wf s: Pr oper t yName el ement92 i n a wf s: Query el ement i n a wf s: GetFeat ure el ement t o sel ecti vel y93 r equest t he t r aversal of nested XLi nks i n t he r eturned el ement f or94 t he named proper t y. Thi s el ement may not be used i n ot her r equest s95 - - GetFeat ur eWi t hLock, LockFeat ur e, I nsert , Update, Del ete - - i n96 t hi s ver si on of t he WFS speci f i cat i on.97

98 99 100

102 103 104 Thi s att r i but e i ndi cat es t he dept h t o whi ch nested pr opert y105 XLi nk l i nki ng el ement l ocat or att r i but e ( hr ef ) XLi nks ar e106 t r aversed and r esol ved i f possi bl e. A val ue of "1" i ndi cat es107 t hat one l i nki ng el ement l ocat or att r i but e ( hr ef ) Xl i nk

108 wi l l be t r aversed and t he r ef erenced el ement r etur ned i f109 possi bl e, but nested pr opert y XLi nk l i nki ng el ement l ocator110 att r i but e ( hr ef ) XLi nks i n t he r eturned el ement are not111 t r aversed. A val ue of "* " i ndi cat es t hat al l nested pr opert y112 XLi nk l i nki ng el ement l ocat or att r i but e ( hr ef ) XLi nks wi l l be113 t r aversed and t he r ef erenced el ement s r eturned i f possi bl e.114 The r ange of val i d val ues f or t hi s at t r i but e consi st s of115 posi t i ve i nt egers pl us "*" .116

117 118 119

122 123 124 The t r aver seXl i nkExpi r y at t r i but e val ue i s speci f i ed i n

125 mi nut es I t i ndi cat es how l ong a Web Feat ure Ser vi ce shoul d126 wai t t o r ecei ve a r esponse t o a nest ed Get Gml Obj ect r equest .127

128 129 130 131 132133

134 135 136 137


12/35

OGC 06-027r1


138 139 140 141 Request t o a WFS t o perf orm t he GetCapabi l i t i es operat i on.142 Thi s oper at i on al l ows a cl i ent t o r et r i eve a Capabi l i t i es143 XML document provi di ng met adat a f or t he speci f i c WFS ser ver.144145 The Get Capapbi l i t i es el ement i s used t o r equest t hat a Web Feat ure

146 Ser vi ce gener at e an XML document descr i bi ng t he organi zat i on147 provi di ng t he servi ce, t he WFS operat i ons t hat t he servi ce148 support s, a l i st of f eat ur e t ypes t hat t he servi ce can operat e149 on and l i st of f i l t eri ng capabi l i t i es t hat t he ser vi ce suppor t .150 Such an XML document i s cal l ed a capabi l i t i es document .151

152 153 154 155

157158

159 160 161 162 165 166 167 168 XML encoded WFS Get Capabi l i t i es operat i on r esponse. Thi s169 document provi des cl i ent s wi t h ser vi ce metadat a about a170 speci f i c servi ce i nst ance, i ncl udi ng metadata about t he171 t i ght l y- coupl ed data served. I f t he server does not i mpl ement172 t he updat eSequence par ameter , t he ser ver shal l al ways r et urn173 t he compl et e Capabi l i t i es document , wi t hout t he updat eSequence174 paramet er . When t he ser ver i mpl ements t he updateSequence175 parameter and t he GetCapabi l i t i es operat i on r equest i ncl uded176 t he updat eSequence par ameter wi t h t he curr ent val ue, t he ser ver177 shal l r eturn t hi s el ement wi t h onl y t he "versi on" and178 "updateSequence" att r i but es. Ot herwi se, al l opt i onal el ement s179 shal l be i ncl uded or not dependi ng on t he actual val ue of t he

180 Cont ent s parameter i n t he GetCapabi l i t i es operat i on r equest.181

182 183 184 185 186 187 188 189 190 191 192 193 194 195 196

197 198 A l i st of f eat ur e t ypes avai l abl e f rom t hi s ser ver .199

200 201 202

205

208 209


13/35

OGC 06-027r1


210 211 212 213 An el ement of t hi s t ype t hat descr i bes a f eat ur e i n an appl i cat i on214 namespace shal l have an xml xml ns speci f i er , e. g.215 xml ns: bo="htt p: / / www. Bl ueOx. org/ Bl ueOx"216

217 218 219 220 221 222 Name of t hi s f eatur e t ype, i ncl udi ng any namespace pref i x223

224 225 226 227 228 229 Ti t l e of t hi s f eat ur e t ype, nor mal l y used f or di spl ay230 t o a human.231

232 233 234

235 236 237 Br i ef nar r at i ve descri pt i on of t hi s f eat ur e t ype, nor mal l y238 used f or di spl ay t o a human.239

240 241 242 243 244 245

247 248 249 The Def aul t SRS el ement i ndi cated whi ch spat i al250 r ef erence syst em shal l be used by a WFS t o251 expr ess t he st ate of a spat i al f eature i f not

252 otherwi se expl i ci t l y i dent i f i ed wi t hi n a quer y253 or t r ansact i on r equest . The SRS may be i ndi cat ed254 usi ng ei t her t he EPSG f orm ( EPSG: posc code) or255 t he URL f orm def i ned i n subcl ause 4. 3. 2 of256 r efer nce[ 2] .257

258 259 260

263 264 265 The Ot her SRS el ement i s used t o i ndi cat e ot her266 suppor t ed SRSs wi t hi n query and t r ansact i on267 oper at i ons. A suppor t ed SRS means t hat t he268 WFS support s t he t r ansf ormat i on of spat i al

269 propert i es bet ween t he Ot her SRS and t he i nternal270 st orage SRS. The ef f ects of such t r ansf ormat i ons271 must be consi dered when deter mi ni ng and decl ar i ng272 t he guarant eed dat a accur acy.273

274 275 276 277 278 279 280 281


14/35

OGC 06-027r1


282 t ype="wf s: Oper at i onsType"283 mi nOccur s="0"/ >

284

287

289 292 293 294 295 296

299 300 301 302 303 304 305 306

307 308 309 310 311 312 313 314 315 316 317 318 319 A Web Feat ure Server MAY use zer o or mor e Met adataURL320 el ement s t o of f er detai l ed, st andardi zed metadata about321 t he dat a underneat h a part i cul ar f eat ur e t ype. The t ype322 at t r i bute i ndi cates t he st andar d t o whi ch t he metadata323 compl i es; t he f ormat att r i but e i ndi cates how t he metadata i s

324 st r uct ured. Two t ypes are def i ned at pr esent :325 ' TC211' or ' I SO19115' = I SO TC211 19115;326 ' FGDC' = FGDC CSDGM.327 ' I SO19139' = I SO 19139328

329 330 331 332 333 334 335 336 337 338 339 340

341 342 343 344 345 346 347 348 349 350 351 352 353


15/35

OGC 06-027r1


354 355

357 358 359 Li st of GML Obj ect t ypes avai l abl e f or GetGml Obj ect r equest s360

361 362 363

365 366 367 Li st of GML Obj ect t ypes t hat WFS i s capabl e of servi ng, ei t her368 di r ect l y, or as val i dl y deri ved t ypes def i ned i n a GML appl i cat i on369 schema.370

371 372 373 374 375

377 378

379 Name of t hi s GML obj ect t ype, i ncl udi ng any namespace pref i x380 381 382 383 384 385 386 387 388 An el ement of t hi s t ype t hat descri bes a GML obj ect i n an389 appl i cati on namespace shal l have an xml xml ns speci f i er,390 e. g. xml ns: bo="ht t p: / / www. Bl ueOx. org/ Bl ueOx"391

392 393 394 395

396 397 Name of t hi s GML Obj ect t ype, i ncl udi ng any namespace pref i x.398

399 400 401 402 403 404 Ti t l e of t hi s GML Obj ect t ype, normal l y used f or di spl ay405 t o a human.406

407 408 409 410 411 412 Br i ef narr ati ve descr i pt i on of t hi s GML Obj ect t ype, normal l y

413 used f or di spl ay t o a human.414

415 416 417

419

421 422 423424

425


16/35

OGC 06-027r1


426 427 428 429 430 431 The Descr i beFeat ureType el ement i s used t o r equest t hat a Web432 Feature Servi ce gener at e a document descr i bi ng one or mor e433 f eat ur e t ypes.

434 435 436 437 438 439 440 The Descr i beFeat ur eType operat i on al l ows a cl i ent appl i cat i on441 t o r equest t hat a Web Feat ure Ser vi ce descr i be one or more442 f eatur e t ypes. A Web Feat ure Ser vi ce must be abl e t o gener at e443 f eat ure descr i pt i ons as val i d GML3 appl i cati on schemas.444445 The schemas gener at ed by t he Descr i beFeat ureType oper at i on can446 be used by a cl i ent appl i cat i on t o val i date t he out put .447448 Feat ure i nstances wi t hi n t he WFS i nter f ace must be speci f i ed449 usi ng GML3. The schema of f eat ure i nstances speci f i ed wi t hi n450 t he WFS i nter f ace must val i dat e agai nst t he f eature schemas

451 gener at ed by t he Descr i beFeat ureType r equest .452 453 454 455 456 457

459 460 461 The TypeName el ement i s used t o enumer at e t he462 f eat ure t ypes t o be descr i bed. I f no TypeName463 el ement s are speci f i ed t hen al l f eat ur es shoul d464 be descr i bed. The name must be a val i d t ype465 t hat bel ongs t o t he f eat ure cont ent as def i ned466 by t he GML Appl i cat i on Schema.467

468 469 470 471

474 475 476 The out put Format at t r i but e i s used t o speci f y what schema477 descr i pti on l anguage shoul d be used t o descri be f eat ures.478 The def aul t val ue of ' t ext / xml ; subt ype=3. 1. 1' means t hat479 t he WFS must gener at e a GML3 appl i cat i on schema t hat can480 be used t o val i dat e t he GML3 out put of a GetFeat ure481 r equest or f eat ur e i nst ances speci f i ed i n Transact i on482 operat i ons.483 For t he pur poses of exper i ment at i on, vendor ext ensi on,484 or even ext ensi ons t hat serve a speci f i c communi t y of

485 i nt erest , other accept abl e out put f ormat val ues may be486 adver t i sed by a WFS servi ce i n t he capabi l i t i es document .487 The meani ng of such val ues i n not def i ned i n t he WFS488 speci f i cat i on. The onl y pr ovi so i s such cases i s t hat489 cl i ent s may saf el y i gnore out putFor mat val ues t hat do490 not r ecogni ze.491

492 493 494 495 496 497


17/35

OGC 06-027r1


498 499 500 501 502 503504

505 506 507 508 509 510 The Get Feat ure el ement i s used t o r equest t hat a Web Feat ure511 Servi ce r etur n f eat ur e t ype i nst ances of one or more f eat ur e512 t ypes.513

514 515 516 517 518 519 A Get Feature el ement contai ns one or mor e Quer y el ements520 t hat descr i be a quer y operat i on on one f eat ur e t ype. I n521 r esponse t o a Get Feat ure r equest , a Web Feat ure Ser vi ce522 must be abl e t o gener ate a GML3 r esponse t hat val i dat es

523 usi ng a schema gener at ed by t he Descr i beFeat ureType r equest .524 A Web Feat ure Servi ce may suppor t ot her poss i bl y non- XML525 ( and even bi nar y) out put f ormats as l ong as t hose f ormats526 are adver t i sed i n t he capabi l i t i es document .527

528 529 530 531 532 533 534

537 538 539 The r esul t Type att r i but e i s used t o i ndi cat e

540 what r esponse a WFS shoul d r et urn t o user once541 a GetFeat ur e r equest i s pr ocessed.542 Possi bl e val ues are:543 r esul t s - meani ng t hat t he f ul l r esponse set544 ( i . e. al l t he f eat ure i nstances)545 shoul d be r et urned.546 hi t s - meani ng t hat an empty r esponse set547 shoul d be r eturned ( i . e. no f eat ur e548 i nstances shoul d be r etur ned) but549 t he "numberOf Feat ures" at t r i but e550 shoul d be set t o t he number of f eat ure551 i nstances t hat woul d be r etur ned.552

553 554 555 558 559 560 The out putFor mat at t r i but e i s used t o speci f y t he out put561 f ormat t hat t he Web Feat ure Ser vi ce shoul d gener at e i n562 r esponse t o a GetFeatur e or Get Feat ureWi t hLock el ement .563 The def aul t val ue of ' t ext / xml ; subt ype=gml / 3. 1. 1'564 i ndi cat es t hat t he out put i s an XML document t hat565 conf or ms t o t he Geography Mar kup Language ( GML)566 I mpl ement ati on Speci f i cat i on V3. 1. 1.567 For t he pur poses of exper i ment at i on, vendor ext ensi on,568 or even ext ensi ons t hat serve a speci f i c communi t y of569 i nt erest , other accept abl e out put f ormat val ues may be


18/35

OGC 06-027r1


570 used t o speci f y other f ormats as l ong as t hose val ues571 are adver t i sed i n t he capabi l i t i es document .572 For exampl e, t he val ue WKB may be used t o i ndi cat e t hat a573 Wel l Known Bi nary f or mat be used t o encode t he output .574

575 576 577 579 580 581 The maxFeatures at t r i but e i s used t o speci f y t he maxi mum 582 number of f eatur es t hat a Get Feat ure operat i on shoul d583 generat e ( r egardl ess of t he actual number of query hi t s) .584

585 586 587

589 590 591 Thi s att r i but e i ndi cat es t he dept h t o whi ch nested pr opert y592 XLi nk l i nki ng el ement l ocat or att r i but e ( hr ef ) XLi nks ar e593 t r aversed and r esol ved i f possi bl e. A val ue of "1"594 i ndi cat es t hat one l i nki ng el ement l ocator at t r i but e

595 ( hr ef ) Xl i nk wi l l be t r aversed and t he r ef erenced el ement596 r eturned i f possi bl e, but nested pr opert y XLi nk l i nki ng597 el ement l ocator att r i but e ( hr ef ) XLi nks i n t he r eturned598 el ement are not t r aversed. A val ue of "*" i ndi cat es t hat599 al l nested pr opert y XLi nk l i nki ng el ement l ocator att r i but e600 ( hr ef ) XLi nks wi l l be t r aversed and t he r ef erenced el ement s601 r et ur ned i f possi bl e. The r ange of val i d val ues f or t hi s602 at t r i but e consi sts of posi t i ve i nt egers pl us "*".603 I f t hi s at t r i but e i s not speci f i ed t hen no xl i nks shal l be604 r esol ved and t he val ue of t r aver seXl i nkExpi r y at t r i but e ( i f605 i t speci f i ed) may be i gnored.606

607 608 609

612 613 614 The t r averseXl i nkExpi r y at t r i but e val ue i s speci f i ed i n615 mi nutes. I t i ndi cates how l ong a Web Feat ur e Servi ce616 shoul d wai t t o r ecei ve a r esponse t o a nest ed Get Gml Obj ect617 r equest .618 Thi s at t r i but e i s onl y rel evant i f a val ue i s speci f i ed619 f or t he t r aver seXl i nkDept h att r i but e.620

621 622 623 624 625 626 627 628

629 630 631 I ndi cat es t hat a compl et e r esponse shoul d be gener at ed632 by t he WFS. That i s, al l r esponse f eat ure i nstances633 shoul d be r eturned t o t he cl i ent .634

635 636 637 638 639 640 I ndi cat es t hat an empty r esponse shoul d be gener ated wi t h641 t he "numberOf Features" att r i but e set ( i . e. no f eat ur e


19/35


20/35

OGC 06-027r1


714 Speci f i cat i on.715

716 717 718 719 720 721 The Sort By el ement i s used speci f y proper t y names whose

722 val ues shoul d be used t o order ( upon pr esent ati on) t he723 set of f eat ur e i nst ances t hat sat i sf y t he quer y.724

725 726 727 728

730 731 732 The handl e att r i but e al l ows a cl i ent appl i cat i on733 t o assi gn a cl i ent - gener at ed i dent i f i er f or t he734 Quer y. The handl e i s i ncl uded t o f aci l i t at e er r or735 r eport i ng. I f one Quer y i n a GetFeat ur e r equest736 causes an except i on, a WFS may r epor t t he handl e737 t o i ndi cat e whi ch query el ement f ai l ed. I f t he a738 handl e i s not present , t he WFS may use ot her means

739 t o l ocal i ze t he er r or ( e. g. l i ne number s) .740 741 742 743

745 746 747 The t ypeName at t r i but e i s a l i st of one or more748 f eatur e t ype names t hat i ndi cat e whi ch t ypes749 of f eat ure i nst ances shoul d be i ncl uded i n t he750 r eponse set . Speci f yi ng mor e t han one t ypename751 i ndi cat es t hat a j oi n operat i on i s bei ng perf ormed.752 Al l t he names i n t he t ypeName l i st must be val i d753 t ypes t hat bel ong t o t hi s query' s f eat ur e cont ent754 as def i ned by t he GML Appl i cat i on Schema.755

756 757 758

760 761 762 For syst ems t hat i mpl ement ver si oni ng, t he f eat ur eVers i on763 at t r i but e i s used t o speci f y whi ch ver si on of a par t i cul ar764 f eat ure i nst ance i s t o be r etr i eved. A val ue of ALL means765 t hat al l ver si ons shoul d be r etr i eved. An i nt eger val ue766 ' i ' , means t hat t he i t h ver si on shoul d be r etr i eve i f i t767 exi st s or t he most r ecent ver si on other wi se.768

769 770 771 772

773 774 Thi s att r i but e i s used t o speci f y a speci f i c WFS- support ed SRS775 t hat shoul d be used f or r etur ned f eat ure geomet r i es. The val ue776 may be t he WFS StorageSRS val ue, Def aul t Ret r i eval SRS val ue, or777 one of Addi t i onal SRS val ues. I f no sr sName val ue i s suppl i ed,778 t hen t he f eat ur es wi l l be r eturned usi ng ei t her t he779 Def aul t Retr i eval SRS, i f speci f i ed, and St orageSRS other wi se.780 For f eat ur e t ypes wi t h no spat i al pr oper t i es, t hi s att r i but e781 must not be speci f i ed or i gnor ed i f i t i s speci f i ed.782

783 784 785


21/35


22/35

OGC 06-027r1


858 859 860 861 862 863864

865

866 867 868

869 870 The Get Gml Obj ect el ement i s used t o r equest t hat a Web Feat ure871 Servi ce r eturn an el ement wi t h a gml : i d att r i but e val ue speci f i ed872 by an ogc: Gml Obj ect I d.873

874 875 876 877 878 879 A Get Gml Obj ect Type el ement cont ai ns exact l y one Gml Obj ect I d.880 The val ue of t he gml : i d att r i but e on t hat Gml Obj ectI d i s used881 as a uni que key t o r et r i eve t he compl ex el ement wi t h a882 gml : i d att r i but e wi t h t he same val ue.

883 884 885 886 887 888 889 890

892

894 895 896 Thi s att r i but e i ndi cat es t he dept h t o whi ch nested897 pr opert y XLi nk l i nki ng el ement l ocator att r i but e898 ( hr ef ) XLi nks are t r aversed and r esol ved i f possi bl e.899 A val ue of "1" i ndi cat es t hat one l i nki ng el ement

900 l ocat or att r i but e ( hr ef ) XLi nk wi l l be t r aver sed901 and t he r ef erenced el ement r etur ned i f possi bl e, but902 nested pr opert y XLi nk l i nki ng el ement l ocator att r i but e903 ( hr ef ) XLi nks i n t he r eturned el ement are not t r aversed.904 A val ue of "* " i ndi cat es t hat al l nested pr opert y XLi nk905 l i nki ng el ement l ocator at t r i but e ( hr ef ) XLi nks wi l l be906 t r aversed and t he r ef erenced el ement s r etur ned i f907 possi bl e. The r ange of val i d val ues f or t hi s at t r i but e908 consi st s of posi t i ve i nt eger s pl us "*" .909

910 911 912

915 916

917 The t r averseXl i nkExpi r y at t r i but e val ue i s speci f i ed918 i n mi nutes. I t i ndi cates how l ong a Web Feat ur e Ser vi ce919 shoul d wai t t o r ecei ve a r esponse t o a nest ed Get Gml Obj ect920 r equest .921

922 923 924 925 926 927 928 929


23/35

OGC 06-027r1


930


24/35

OGC 06-027r1


1002 t ype="xsd: posi t i veI nteger " use="opti onal ">1003 1004 1005 See def i ni t i on of wf s: GetFeatur eType.1006 1007 1008 1009 1011 1012 1013 See def i ni t i on of wf s: GetFeatur eType.1014 1015 1016 1017 1019 1020 1021 See def i ni t i on of wf s: GetFeatur eType.1022 1023 1024 1025 1026

1027 10281029 1030 1031 1032 1033 1034 1035 1036 Thi s i s t he r oot el ement f or a LockFeat ure r equest .1037 The LockFeat ure r equest can be used t o l ock one or1038 more f eatur e i nst ances.1039 1040 1041 1042 1043

1044 1045 Thi s t ype def i nes t he LockFeat ur e operat i on. The LockFeature1046 el ement cont ai ns one or more Lock el ement s t hat def i ne whi ch1047 f eat ur es of a part i cul ar t ype shoul d be l ocked. A l ock1048 i dent i f i er ( l ockI d) i s r et urned t o t he cl i ent appl i cat i on whi ch1049 can be used by subsequent operat i ons t o r ef erence t he l ocked1050 f eat ures.1051 1052 1053 1054 1055 1056 1058 1059 1060 The l ock el ement i s used t o i ndi cate whi ch f eat ur e

1061 i nst ances of part i cul ar t ype are t o be l ocked.1062 1063 1064 1065 1066 1069 1070 1071 The expi r y att r i but e i s used t o set t he l engt h1072 of t i me ( expr essed i n mi nut es) t hat f eat ur es wi l l1073 r emai n l ocked as a r esul t of a LockFeat ur e


25/35

OGC 06-027r1


1074 r equest. Af t er t he expi r y peri od el apses, t he1075 l ocked r esources must be r el eased. I f t he1076 expi r y at t r i but e i s not set , t hen t he def aul t1077 val ue of 5 mi nutes wi l l be enf orced.1078 1079 1080 1081 1084 1085 1086 The l ockAct i on att r i but e i s used t o i ndi cat e what1087 a Web Feat ure Servi ce shoul d do when i t encount er s1088 a f eat ure i nstance t hat has al r eady been l ocked by1089 anot her cl i ent appl i cat i on.10901091 Val i d val ues are ALL or SOME.10921093 ALL means t hat t he Web Feature Ser vi ce must acqui r e1094 l ocks on al l t he r equest ed f eat ur e i nst ances. I f i t1095 cannot acqui r e t hose l ocks t hen t he r equest shoul d1096 f ai l . I n t hi s i nstance, al l l ocks acqui red by t he1097 operat i on shoul d be r el eased.1098

1099 SOME means t hat t he Web Feat ure Servi ce shoul d l ock1100 as many of t he r equest ed f eatur es as i t can.1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115

1116 Thi s t ype def i nes t he Lock el ement . The Lock el ement1117 def i nes a l ocki ng operat i on on f eat ur e i nst ances of1118 a si ngl e t ype. An OGC Fi l t er i s used t o const r ai n t he1119 scope of t he operat i on. Features t o be l ocked can be1120 i dent i f i ed i ndi vi dual l y by usi ng t hei r f eat ure i dent i f i er1121 or t hey can be l ocked by sat i sf yi ng t he spat i al and1122 non- spat i al constr ai nt s def i ned i n t he f i l t er.1123 1124 1125 1126 1127 1128 1129 1130 1131 The handl e att r i but e al l ows a cl i ent appl i cat i on1132 t o assi gn a cl i ent - gener at ed r equest i dent i f i er

1133 t o a Lock acti on. The handl e i s i ncl uded t o1134 f aci l i t at e er ror r eport i ng. I f one of a set of1135 Lock acti ons f ai l ed whi l e pr ocessi ng a LockFeat ure1136 r equest , a WFS may r epor t t he handl e i n an except i on1137 r eport t o l ocal i ze t he err or . I f a handl e i s not1138 pr esent t hen a WFS may empl oy some ot her means of1139 l ocal i zi ng t he er r or ( e. g. l i ne number) .1140 1141 1142 1143 1144 1145


26/35

OGC 06-027r1


1146 The val ue of t he t ypeName at t r i but e i s t he name1147 of t he f eature t ype t o be updated. The name1148 speci f i ed must be a val i d t ype t hat bel ongs t o1149 t he f eat ure cont ent as def i ned by t he GML1150 Appl i cat i on Schema.1151 1152 1153

1154 1155 1156 1158 1159 1160 The LockFeat ureResponse el ement cont ai ns a r epor t1161 about t he compl et i on st atus of a LockFeatur e r equest .1162 1163 1164 1165 1166 1167 1168 The LockFeat ureResponseType i s used t o def i ne an1169 el ement t o cont ai ns t he r esponse t o a LockFeat ure1170 operat i on.

1171 1172 1173 1174 1175 1176 1177 The LockFeat ureResponse i ncl udes a LockI d el ement1178 t hat cont ai ns a l ock i dent i f i er . The l ock i dent i f i er1179 can be used by a cl i ent , i n subsequent operat i ons, t o1180 operat e upon t he l ocked f eat ure i nstances.1181 1182 1183 1184 1186 1187

1188 The LockFeat ure or Get Feat ureWi t hLock operat i ons1189 i dent i f y and att empt t o l ock a set of f eat ur e1190 i nst ances t hat sat i sf y t he const r ai nt s speci f i ed1191 i n t he r equest. I n t he event t hat t he l ockAct i on1192 at t r i bute ( on t he LockFeat ur e or GetFeatur eWi t hLock1193 el ement s) i s set t o SOME, a Web Feat ure Ser vi ce wi l l1194 at t empt t o l ock as many of t he f eat ur e i nst ances f r om1195 t he r esul t set as possi bl e.11961197 The Featur esLocked el ement cont ai ns l i st of ogc: FeatureI d1198 el ement s enumerat i ng t he f eat ure i nst ances t hat a WFS1199 act ual l y managed t o l ock.1200 1201 1202 1203

1205 1206 1207 I n cont r ast t o t he Feat ur esLocked el ement , t he1208 Feat ur esNotLocked el ement cont ai ns a l i st of1209 ogc: Fi l t er el ement s i dent i f yi ng f eat ur e i nst ances1210 t hat a WFS di d not manage t o l ock because t hey wer e1211 al r eady l ocked by anot her process.1212 1213 1214 1215 1216 1217


27/35

OGC 06-027r1


1218 1219 1220 1221 1222 1223 1224 1225 1226 12271228 1229 1230 1231 1232 1233 1234 1235 Thi s i s t he r oot el ement f or a Transact i on r equest.1236 A t r ansact i on r equest al l ows i nser t , updat e and1237 del et e operat i ons t o be per f ormed t o cr eate, change1238 or r emove f eatur e i nst ances.1239 1240 1241 1242

1243 1244 1245 The Transact i onType def i nes t he Transact i on operat i on. A1246 Transact i on el ement cont ai ns one or more I nsert , Updat e1247 Del ete and Nati ve el ement s t hat al l ow a cl i ent appl i cat i on1248 t o cr eat e, modi f y or r emove f eat ur e i nst ances f r omt he1249 f eat ur e r eposi t ory t hat a Web Feature Servi ce cont r ol s.1250 1251 1252 1253 1254 1255 1256 1257 1258 I n order f or a cl i ent appl i cat i on t o operat e upon1259 l ocked f eat ure i nstances, t he Transact i on r equest

1260 must i ncl ude t he LockI d el ement . The cont ent of1261 t hi s el ement must be t he l ock i dent i f i er t he cl i ent1262 appl i cat i on obt ai ned f r oma pr evi ous1263 GetFeatur eWi t hLock or LockFeat ure operat i on.12641265 I f t he cor r ect l ock i dent i f i er i s speci f i ed t he Web1266 Feat ur e Ser vi ce knows t hat t he cl i ent appl i cati on may1267 operat e upon t he l ocked f eat ur e i nstances.12681269 No LockI d el ement needs t o be speci f i ed t o operate upon1270 unl ocked f eat ur es.1271 1272 1273 1274 1275 1276

1277 1278 1279 1280 1281 1283 1284 1285 The r el easeAct i on at t r i but e i s used t o cont r ol how a Web1286 Feature servi ce r el eases l ocks on f eat ur e i nst ances af t er1287 a Transact i on r equest has been processed.12881289 Val i d val ues are ALL or SOME.


28/35

OGC 06-027r1


12901291 A val ue of ALL means t hat t he Web Feature Ser vi ce shoul d1292 r el ease t he l ocks of al l f eat ur e i nst ances l ocked wi t h t he1293 speci f i ed l ockI d r egardl ess or whether or not t he f eat ur es1294 were actual l y modi f i ed.12951296 A val ue of SOME means t hat t he Web Feat ure Servi ce wi l l1297 onl y r el ease t he l ocks hel d on f eat ur e i nst ances t hat

1298 were act ual l y operat ed upon by t he t r ansact i on. The1299 l ockI d t hat t he cl i ent appl i cat i on obt ai ned shal l r emai n1300 val i d and t he other , unmodi f i ed, f eat ur e i nst ances shal l1301 r emai n l ocked.13021303 I f t he expi r y att r i but e was speci f i ed i n t he or i gi nal1304 operat i on t hat l ocked t he f eat ure i nst ances, t hen t he1305 expi r y count er wi l l be r eset t o gi ve t he cl i ent1306 appl i cat i on t hat same amount of t i me t o post subsequent1307 t r ansact i ons agai nst t he l ocked f eat ur es.1308 1309 1310 1311 1312 1313 1314

1315 1316 1317 The LockI d el ement cont ai ns t he val ue of t he l ock i dent i f i er1318 obt ai ned by a cl i ent appl i cat i on f r oma pr evi ous GetFeat ur eWi t hLock1319 or LockFeatur e r equest .1320 1321 1322 1323 1324 1325 1326 The I nser t el ement i s used t o i ndi cate t hat t he Web Feat ure1327 Servi ce shoul d cr eat e a new i nst ance of a f eat ur e t ype. The1328 f eatur e i nst ance i s speci f i ed usi ng GML3 and one or more1329 f eat ure i nstances t o be cr eat ed can be cont ai ned i nsi de t he1330 I nser t el ement .1331

1332 1333 1334 1335 1336 1337 An I nser t el ement may cont ai n a f eat ure col l ecti on or one1338 or more f eat ure i nstances t o be i nser t ed i nto t he1339 r eposi t ory.1340 1341 1342 1343 1344 1345 1346 1347 1348 1351 1352 1353 The i dgen att r i but e cont r ol how a WFS generat es i dent i f i ers1354 f r omnewl y cr eat ed f eat ur e i nst ances usi ng t he I nsert act i on.1355 The def aul t act i on i s t o have t he WFS gener at e a new i d f or1356 t he f eat ur es. Thi s i s al so backward compat i bl e wi t h WFS 1. 01357 wher e t he onl y act i on was f or t he WFS t o gener at e an new i d.1358 1359 1360 1361


29/35

OGC 06-027r1


1362 1363 1364 The handl e att r i but e al l ows a cl i ent appl i cat i on1365 t o assi gn a cl i ent - gener at ed r equest i dent i f i er1366 t o an I nsert act i on. The handl e i s i ncl uded t o1367 f aci l i t at e er ror r eport i ng. I f an I nser t acti on1368 i n a Transact i on r equest f ai l s, t hen a WFS may1369 i ncl ude t he handl e i n an except i on r eport t o l ocal i ze1370 t he err or. I f no handl e i s i ncl uded of t he of f endi ng1371 I nser t el ement t hen a WFS may empl oyee ot her means of1372 l ocal i zi ng t he er r or ( e. g. l i ne number) .1373 1374 1375 1376 1378 1379 1380 Thi s i nput For mat att r i but e i s used t o i ndi cat e1381 t he f ormat used t o encode a f eat ure i nst ance i n1382 an I nser t el ement . The def aul t val ue of1383 ' t ext / xml ; subt ype=gml / 3. 1. 1' i s used t o i ndi cat e1384 t hat f eatur e encodi ng i s GML3. Anot her exampl e1385 mi ght be ' t ext / xml ; subt ype=gml / 2. 1. 2' i ndi cat i ng1386 t hat t he f eat ure us encoded i n GML2. A WFS must

1387 decl are i n t he capabi l i t i es document , usi ng a1388 Paramet er el ement , whi ch vers i on of GML i t suppor t s.1389 1390 1391 1392 1393 1394 1395 ===== PAV 12NOV2004 ====1396 WHY I S THI S HERE? WOULDN' T WE KNOW THE I NCOMI NG SRS FROM THE1397 GML GEOMETRY ELEMENTS? I ASSUME THAT I F THE I NCOMI NG SRS1398 DOES NOT MATCH ONE OF THE STORAGE SRS( s) THEN THE WFS WOULD1399 EI THER PROJ ECT I NTO THE STORAGE SRS OR RAI SE AN EXCEPTI ON.1400 1401 1402 1403

1404 1405 1406 1407 1408 1409 The UseExsi t i ng val ue i ndi cat es t hat WFS shoul d not1410 generat e a new f eat ur e i dent i f i er f or t he f eat ur e1411 bei ng i nsert ed i nt o t he r eposi t r y. I nst ead, t he WFS1412 shoul d use t he i dent i f i er encoded i f t he f eat ur e.1413 I f a dupl i cate exi st s t hen t he WFS shoul d r ai se an1414 excepti on.1415 1416 1417 1418 1419 1420

1421 The Repl aceDupl i cat e val ue i ndi cat es t hat WFS shoul d1422 not generat e a new f eat ur e i dent i f i er f or t he f eat ur e1423 bei ng i nsert ed i nt o t he r eposi t r y. I nst ead, t he WFS1424 shoul d use t he i dent i f i er encoded i f t he f eat ur e.1425 I f a dupl i cate exi st s t hen t he WFS shoul d r epl ace t he1426 exi st i ng f eat ur e i nst ance wi t h t he one encoded i n t he1427 I nser t acti on.1428 1429 1430 1431 1432 1433


30/35

OGC 06-027r1


1434 The Gener at eNew val ue i ndi cat es t hat WFS shoul d1435 generat e a new uni que f eat ur e i dent i f i er f or t he1436 f eat ur e bei ng i nser t ed i nt o t he r eposi t r y.1437 1438 1439 1440 1441

1442 1443 1444 1445 One or mor e exi st i ng f eature i nst ances can be changed by1446 usi ng t he Updat e el ement .1447 1448 1449 1450 1451 1452 1453 1454 1455 Changi ng or updat i ng a f eatur e i nst ance means t hat1456 t he cur r ent val ue of one or more propert i es of1457 t he f eatur e are r epl aced wi t h new val ues. The Updat e1458 el ement cont ai ns one or more Propert y el ement s. A

1459 Propert y el ement cont ai ns t he name or a f eatur e propert y1460 who' s val ue i s t o be changed and t he r epl acement val ue1461 f or t hat pr opert y.1462 1463 1464 1465 1466 1467 1468 The Fi l t er el ement i s used t o const r ai n t he scope1469 of t he update operat i on t o t hose f eat ur es i dent i f i ed1470 by t he f i l t er. Feature i nst ances can be speci f i ed1471 expl i ci t l y and i ndi vi dual l y usi ng t he i dent i f i er of1472 each f eat ure i nstance OR a set of f eat ur es t o be1473 operat ed on can be i dent i f i ed by speci f yi ng spati al1474 and non- spat i al const r ai nt s i n t he f i l t er.1475 I f no f i l t er i s speci f i ed t hen updat e oper at i on

1476 appl i es t o al l f eatur e i nst ances.1477 1478 1479 1480 1481 1482 1483 1484 The handl e att r i but e al l ows a cl i ent appl i cat i on1485 t o assi gn a cl i ent - gener at ed r equest i dent i f i er1486 t o an I nsert act i on. The handl e i s i ncl uded t o1487 f aci l i t at e er r or r eport i ng. I f an Updat e act i on1488 i n a Transact i on r equest f ai l s, t hen a WFS may1489 i ncl ude t he handl e i n an except i on r eport t o l ocal i ze1490 t he err or. I f no handl e i s i ncl uded of t he of f endi ng1491 I nser t el ement t hen a WFS may empl oyee ot her means of1492 l ocal i zi ng t he er r or ( e. g. l i ne number) .

1493 1494 1495 1496 1497 1498 1499 The val ue of t he t ypeName at t r i but e i s t he name1500 of t he f eature t ype t o be updated. The name1501 speci f i ed must be a val i d t ype t hat bel ongs t o1502 t he f eat ure cont ent as def i ned by t he GML1503 Appl i cat i on Schema.1504 1505


31/35

OGC 06-027r1


1506 1507 1509 1510 1511 Thi s i nput For mat att r i but e i s used t o i ndi cat e1512 t he f ormat used t o encode a f eat ure i nst ance i n1513 an I nser t el ement . The def aul t val ue of1514 ' t ext / xml ; subt ype=gml / 3. 1. 1' i s used t o i ndi cat e1515 t hat f eatur e encodi ng i s GML3. Anot her exampl e1516 mi ght be ' t ext / xml ; subt ype=gml / 2. 1. 2' i ndi cat i ng1517 t hat t he f eat ure us encoded i n GML2. A WFS must1518 decl are i n t he capabi l i t i es document , usi ng a1519 Paramet er el ement , whi ch vers i on of GML i t suppor t s.1520 1521 1522 1523 1524 1525 1526 DO WE NEED THI S HERE?1527 1528 1529 1530

1531 1532 1533 1534 The Proper t y el ement i s used t o speci f y t he new1535 val ue of a f eat ure pr opert y i nsi de an Update1536 el ement .1537 1538 1539 1540 1541 1542 1543 1544 1545 The Name el ement contai ns t he name of a f eature proper t y1546 t o be updated.1547

1548 1549 1550 1551 1552 1553 The Val ue el ement cont ai ns t he r epl acement val ue f or t he1554 named propert y.1555 1556 1557 1558 1559 1560 1561 1562 1563 The Del ete el ement i s used t o i ndi cat e t hat one or more1564 f eat ure i nstances shoul d be r emoved f r omt he f eat ur e

1565 r eposi t ory.1566 1567 1568 1569 1570 1571 1572 1573 1574 The Fi l t er el ement i s used t o const r ai n t he scope1575 of t he del ete operat i on t o t hose f eat ur es i dent i f i ed1576 by t he f i l t er. Feature i nst ances can be speci f i ed1577 expl i ci t l y and i ndi vi dual l y usi ng t he i dent i f i er of


32/35


33/35

OGC 06-027r1


1650 1651 1653 1654 1655 The Transact i onResponse el ement cont ai ns a r epor t1656 about t he compl et i on st atus of a Transact i on operat i on.1657 1658 1659 1660 1661 1662 1663 The r esponse f or a t r ansact i on r equest t hat was successf ul l y1664 compl eted. I f t he t r ansact i on f ai l ed f or any r eason, an1665 except i on r eport i s r eturned i nst ead.1666 1667 1668 1669 1671 1672 1673 The Tr ansact i onSummar y el ement i s used t o summar i ze1674 t he number of f eat ure i nst ances af f ect ed by t he

1675 tr ansact i on.1676 1677 1678 1679 1682 1683 1684 For syst ems t hat do not support atomi c t r ansact i ons,1685 t he Transact i onResul t s el ement may be used t o r epor t1686 excepti on codes and messages f or al l act i ons of a1687 t r ansacti on t hat f ai l ed t o execut e successf ul l y.1688 1689 1690 1691 1693 1694 1695 A t r ansact i on i s a col l ect i on of I nsert , Update and Del ete1696 acti ons. The Update and Del ete acti ons modi f y f eat ur es1697 t hat al r eady exi st . The I nsert act i on, however, cr eat es1698 new f eat ur es. The I nser t Resul t s el ement i s used t o1699 r eport t he i dent i f i er s of t he newl y creat ed f eat ur es.1700 1701 1702 1703 1704 1706 1707 1708 The ver si on att r i but e cont ai ns t he ver si on of t he r equest

1709 t hat generat ed t hi s r esponse. So a V1. 1. 0 t r ansact i on1710 r equest generat es a V1. 1. 0 t r ansact i on r esponse.1711 1712 1713 1714 1715 1716 1717 1718 Repor t s t he t otal number of f eat ures af f ect ed by some ki nd1719 of wr i t e acti on ( i . e, i nser t , updat e, del et e) .1720 1721


34/35

OGC 06-027r1


1722 1723 1726 1729 1732 1733 1734 1735 1736 1737 The Transact i onResul t s el ement may be used t o r epor t except i on1738 codes and messages f or al l act i ons of a t r ansact i on t hat f ai l ed1739 t o compl ete successf ul l y.1740 1741 1742 1743 1745 1746

1747 The Act i on el ement r epor t s an excepti on code1748 and except i on message i ndi cat i ng why t he1749 corr espondi ng acti on of a t r ansact i on r equest1750 f ai l ed.1751 1752 1753 1754 1755 1756 1757 1758 1760 1761 1762 I f an act i on f ai l s, t he message el ement may be used1763 t o suppl y an except i on message.

1764 1765 1766 1767 1768 1769 1770 1771 The l ocator att r i but e i s used t o l ocate an act i on1772 wi t hi n a &l t ; Transact i on> el ement . The val ue1773 of t he l ocat or at t ri but e i s ei t her a str i ng t hat1774 i s equal t o t he val ue of t he handl e att r i but e1775 speci f i ed on an &l t ; I nsert &gt ; , &l t ; Update&gt ;1776 or &l t ; Del et e&gt ; acti on. I f a val ue i s not1777 speci f i ed f or t he handl e at t r i bute t hen a WFS1778 may empl oy some ot her means of l ocat i ng t he1779 act i on. For exampl e, t he val ue of t he l ocator1780 at t r i bute may be an i nt eger i ndi cati ng t he order

1781 of t he act i on ( i . e. 1=Fi r st act i on, 2=Second act i on,1782 et c. ) .1783 1784 1785 1786 1787 1788 1789 The code at t r i but e may be used t o speci f y an1790 except i on code i ndi cati ng why an acti on f ai l ed.1791 1792 1793


35/35

OGC 06-027r1

1794 1795 1796 1797 1798 Repor t s t he l i st of i dent i f i ers of al l f eat ures creat ed1799 by a t r ansact i on r equest . New f eat ur es are cr eat ed usi ng1800 t he I nser t acti on and t he l i st of i deti f i er s must be1801 present ed i n t he same order as t he I nsert act i ons were1802 encountered i n t he t r ansact i on r equest . Feat ures may1803 opt i onal l y be cor r el ated wi t h i dent i f i er s usi ng t he1804 handl e at t r i but e ( i f i t was speci f i ed on t he I nser t1805 el ement ) .1806 1807 1808 1809 1812 1813 1814 1815 1816 1817 1818

1819 Thi s i s t he f eatur e i dent i f i er f or t he newl y creat ed1820 f eat ur e. The f eat ur e i dent i f i er may be generat ed by1821 t he WFS or provi ded by t he cl i ent ( dependi ng on t he1822 val ue of t he i dgen at t r i but e) . I n al l cases of i dgen1823 val ues, t he f eat ur e i d must be r eport ed here.1824 1825 1826 1827 1828 1829 1830 1831 I f t he i nsert el ement t hat generat ed t hi s f eat ur e1832 had a val ue f or t he "handl e" at t r i but e t hen a WFS1833 may r epor t i t usi ng t hi s att r i but e t o cor r el ate1834 t he f eat ur e cr eat ed wi t h t he act i on t hat cr eat ed i t .1835

1836 1837 1838 1839

06-027r1_wfs_1.1_schema_corrigendum

Documents