Table 14 — UML attributes and role “query” operation normal response
Name Definition
Data type and value Optionality and use
sessionInfo The core set of parameters required in
each message exchanged between a client and server operating in a
session context, where these parameters support message routing
and session management SessionInfo, See Table
12 Zero or one Conditional
Include when sessions are supportedrequired by
protocol binding andor result sets are persistent
resultSetID Identifier of the Result Set generated
for the query. Further query, present and cancel requests for this Result
Set will supply this value through the collectionID parameter
Character String as defined by protocol
binding and may be further defined by
application profile Zero or one Conditional
Include when sessions are supportedrequired by
protocol binding andor result sets are persistent
resultType How the server responded to the query
request. CodeList type with
allowed values of “dataset”,
“datasetcollection” and “service”
Zero or one Optional
retrievedData A subset of the results of this query
request, organised and formatted as specified in the presentation,
messageFormat, and sortField parameters.
ReturnData Set of resource
descriptionsrecords Zero or one Conditional
Include when resultType = Results
cursorPosition Last result set resource returned for this
operation request. Positive integer
Zero or one Conditional Include when results
returned hits
Number of entries in the result set. Non-negative integer
One Mandatory
NOTE This general model assumes that operation failure will be signalled to the client in a manner specified by
each protocol binding.
7.2.4.3 “present” operation
The “present” operation is more completely specified in Table 15. provides a UML model of the “present” operation that shows the complete Discovery class with the
PresentRequest and PresentResponse classes and the class they use. This UML diagram does not detail the CodeList stereotyped classes named PresentationSetType,
ResponseSchema, ReturnFormat, and SortOrder. The operation request includes the attributes and association role name listed and defined in Table 16. The normal operation
response includes the attributes and association role name listed and defined in Table 17.
Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.
37
Table 15 — Definition of “present” operation
Definition Allows clients to retrieve selected metadata for some or all of the resources referenced in a
specific previous result set or a list of resource identifiers. This operation can be used repetitively to retrieve more of the result set, each time retrieving metadata for a maximum
number of the resources listed, starting at a specified position.
Receives Specifications of sorting and of metadata to be returned, optionally including maximum
number of records for which metadata is to be returned
Returns Metadata document containing selected metadata for some or all of the specific result set,
after it is sorted as specified by the client. Most of the metadata returned depends on the metadata requested and on the types of data defined by the specific Application Profile
Exceptions Missing Parameter Value, Invalid Parameter Value , Unrecognized collection identifier.
Pre-conditions
Client has previously performed “search” operation, and the server has provided a result set identifier that the client can use to perform the present operation.
Post-conditions
Metadata document returned to requesting client, containing selected metadata for some or all of sorted result set
Figure 7 — “present” operation UML static model
38
Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.
Table 16 — UML attributes and role in “present” operation request
Name Definition
Data type and value Optionality and use
sessionInfo The core set of parameters
required in each message exchanged between a client and
server operating in a session context, where these parameters
support message routing and session management
SessionInfo, See Table 12
Zero or one Conditional Include when sessions are
supportedrequired by protocol binding andor
result sets are persistent
targetID Unique identifier of result set
from which resources to be returned or of resources to be
returned Either resultSetID OR
list of resource IDs One Mandatory
responseElements Specifies set name or list of
metadata elements to be returned in the context of a
specific metadata structure. Either a list of
elements as nametype pairs OR
Codelist type named PresentationSetType
with allowed values of “brief,”
“summary” “full” and “browse”
Zero or one Optional Default is “Brief”
Include when results returned
responseSchema The name of the “well-known” or
advertised in the capabilities schema of the response
Code List type with allowed values of
“FGDC”,”ISO- 19115”, ISO19139”,
ANZLIC Zero or one Optional
sortSpec SortField provides sorting
information to the server for formatting data returned to the
client SortSpec , See Table
11 Zero or one Optional
Default is sorted on ID in descending order
returnFormat Specifies format MIME or
Internet media type for returning result set metadata.
CodeList type with allowed values of
XML HTML
TXT Zero or one Optional
Default is “XML”
cursorPosition First result set resource to be
returned for this operation request.
Positive integer Zero or one Optional
Default is “1” iteratorSize
Specifies maximum number of result set resources to be
returned. Non-negative integer
Zero or one Optional Default is “10”
Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.
39
Table 17 — UML attributes and role in “present” operation normal response
Name Definition
Data type and value Optionality and use
sessionInfo The core set of parameters required in
each message exchanged between a client and server operating in a
session context, where these parameters support message routing
and session management SessionInfo, See
Table 12 Zero or one Conditional
Include when sessions are supportedrequired by
protocol binding andor result sets are persistent
retrievedData A subset of the results of this query
request, organised and formatted as specified in the presentation,
messageFormat, and sortField parameters.
Record type for the catalogue or
collection. One Mandatory
cursor Last result set resource returned for
this operation request. Non-negative integer
One Mandatory hits
Number of entries in the result set. Non-negative integer
One Mandatory?
NOTE This general model assumes that operation failure will be signalled to the client in a manner specified by
each protocol binding
7.2.4.4 describeRecordType operation
