GML CR: Allow extensions to UML-to-XML encoding rule
OGC Doc 06-112
Open Geospatial Consortium
CR-Form-v3
CHANGE REQUEST
GML CR ?
rev
-
Current version:
3.2.1
For HELP on using this form, see bottom of this page or look at the pop-up text over the symbols.
Proposed change affects:
AS
Imp Spec X
Best Practices Paper
Title:
Allow extensions points in UML-to-XML encoding rule
Source:
interactive instruments
Work item code:
Category:
Other
Date: 2008-09-19
B
Use one of the following categories:
F (Critical correction)
A (corresponds to a correction in an earlier
release)
B (Addition of feature),
C (Functional modification of feature)
D (Editorial modification)
Detailed explanations of the above categories can
be found in the TC Policies and Procedures.
Reason for change:
The UML-to-XML encoding rule specified in Annex E standardises an encoding
pattern that has been developed as a result of implementations. The encoding
rule covers only a limited set of the capabilities of UML and GML. For example,
the use of nilReason and xsi:nil in GML instances is not supported by the
standard encoding rule. Communities may have the need to specify extensions
to this encoding rule to address specific requirements that are not covered by
the standardised rule.
Summary of change: Amend the encoding rule to clarify how extensions to the standard encoding rule
can be specified. Add a conformance class.
Consequences if
not approved:
Use of extensions to the standard encoding rule cannot be used without breaking
conformance
Clauses affected:
Annex A, Annex E
Other specs
Affected:
Supporting Doc.
Other comments:
Status
Disposition
Other core specifications
Abstract specifications
Best Practices Document
Add the following sub-clause:
E.4 Encoding rule extensions
E.4.2 Overview
Information communities may have the need to specify extensions to the encoding rule specified in
E.2 to address specific requirements that are not covered by this encoding rule. This sub-clause
specifies requirements for such an extended GML encoding rule.
E.4.3 Conformance to ISO 19118
Any extended GML encoding rule shall conform to ISO 19118.
E.4.4 Reference to the specification of the extended encoding rule
An element with a URL referencing the specification of the
extended encoding rule shall be created in an annotation of each element in
the target namespace of the GML application schema created by applying the extended encoding
rule.
The specification of the extended encoding rule shall be documented in accordance with the
requirements stated in ISO 19118.
The element is defined as
E.4.5 Reference to standard encoding rule
Any extended GML encoding rule shall normatively reference E.2 and E.4.3 of this standard and
specify only the extensions to the rule in E.2.
Any extension shall be one of the following:
A new stereotype in the UML profile associated with a classifier, an attribute, an association
role or package.
o A new stereotype shall only be introduced, if the concept described by the stereotype is
not encoding specific but relevant on the conceptual level.
o Schema conversion rules shall be specified defining how XML Schema documents
shall be derived from UML model elements with the stereotype.
A new tagged value in the UML profile associated with a classifier, an attribute, an association
role or package.
o A new tagged value shall describe a concept that is specific to the GML encoding.
o
o
The name of the tagged value shall use a lowerCamelCase name starting with
"gmlext".
Schema conversion rules shall be specified defining how XML Schema documents
shall be derived from UML model elements with the tagged value.
A schema conversion rule for instances of GF_Constraint.
o
The schema conversion rule shall not convert the constraint to XML Schema, but to a
separate language.
EXAMPLE Schematron is a language to specify constraints.
NOTE: GML 3.2.1 references ISO 19118:2005 in its normative reference clause. I.e., this is
the version of ISO 19118 that is referenced by the references to “ISO 19118” above.
The OGC Technical Committee Policies & Procedures 05-020r3
Change the following sub-clause:
A.1.2
Test cases for GML application schemas converted from an ISO 19109 Application
Schema in UML using the standard encoding rule
A.1.2.1 Valid application schema
a) Test Purpose: If the GML application schema is mapped from an ISO 19109 Application
Schema in UML, verify that the UML application schema satisfies the requirements of the UML
profile.
b) Test Method: Check the conformance of the UML application schema with ISO 19109 and
check that the UML application schema has been constructed in accordance with E.2.1.
c) Reference: ISO 19109, Clause 2, Annex A; ISO 19136, E.2.1
d) Test Type: Capability Test
A.1.2.2 Schema conversion to XML Schema
a) Test Purpose: If the ISO 19109 Application Schema in UML satisfies the test stated in A.1.2.1,
verify that the GML application schema has been derived from the UML application schema
correctly.
b) Test Method: Compare both descriptions of the application schema and check whether the
conversion from UML to XML Schema is in accordance with the conversion rules in E.2.4.
c) Reference: ISO 19136, E.2.4
d) Test Type: Capability Test
Add the following sub-clause:
A.1.13 Test cases for GML application schemas converted from an ISO 19109 Application
Schema in UML using an extended encoding rule
A.1.13.1 References encoding rule
a) Test Purpose: Verify existence of a encoding rule.
b) Test Method: Check each schema document of the GML application schema and verify that each
contains an element /schema/annotation/appinfo/gml33:extendedEncodingRule. Verify that all
values are identical and that a document specifying the encoding rule can be retrieved by resolving
the URL.
c) Reference: ISO 19136, E.4.3
d) Test Type: Basic Test
A.1.13.2 Valid encoding rule
a) Test Purpose: Verify that the encoding rule conforms to the requirements in E.4.2 and E.4.4
b) Test Method: Check the conformance of the encoding rule retrieved in test A.1.13.1 with ISO
19118. Verify that the rule normatively references E.2 and E.4.3 of this standard and specifies only
the extensions to the rule in E.2 in accordance with E.4.4.
c) Reference: ISO 19136, E.4.2, E.4.4
d) Test Type: Capability Test
A.1.13.3 Valid application schema
a) Test Purpose: If the GML application schema is mapped from an ISO 19109 Application
Schema in UML, verify that the UML application schema satisfies the requirements of ISO 19109
and the additional requirements of the encoding rule.
b) Test Method: Check the conformance of the UML application schema with ISO 19109 and
check that the UML application schema has been constructed in accordance with the UML profile
stated in the encoding rule retrieved in test A.1.13.1.
c) Reference: ISO 19109, Clause 2, Annex A; ISO 19136, E.4.4
Last Revision Date: 2 December 2017
Page3
The OGC Technical Committee Policies & Procedures 05-020r3
d) Test Type: Capability Test
A.1.13.4 Mapping from an ISO 19109 Application Schema in UML
a) Test Purpose: If the ISO 19109 Application Schema in UML satisfies the requirements stated in
A.1.13.3, verify that the GML application schema has been derived from the UML application
schema correctly.
b) Test Method: Compare both descriptions of the application schema and check whether the
conversion from UML to XML Schema is in accordance with the conversion rules in the encoding
rule retrieved in test A.1.13.1.
c) Reference: ISO 19136, E.4.4
d) Test Type: Capability Test
Change table 1 in 2.2:
Table 1 — Conformance classes related to GML application schemas
Conformance class
All GML application schemas
GML application schemas converted from an ISO 19109 Application Schema in
UML using the standard encoding rule
GML application schema to be converted to an ISO 19109 Application Schemas
in UML
GML application schemas defining Features and Feature Collections
GML application schemas defining Spatial Geometries
GML application schemas defining Spatial Topologies
GML application schemas defining Time
GML application schemas defining Coordinate Reference Systems
GML application schemas defining Coverages
GML application schemas defining Observations
GML application schemas defining Dictionaries and Definitions
GML application schemas defining Values
GML application schemas converted from an ISO 19109 Application Schema in
UML using an extended encoding rule
Last Revision Date: 2 December 2017
Subclause of the
Abstract Test Suite
A.1.1
A.1.2
A.1.3
A.1.4
A.1.5
A.1.6
A.1.7
A.1.8
A.1.9
A.1.10
A.1.11
A.1.12
A.1.13
Page4
Open Geospatial Consortium
CR-Form-v3
CHANGE REQUEST
GML CR ?
rev
-
Current version:
3.2.1
For HELP on using this form, see bottom of this page or look at the pop-up text over the symbols.
Proposed change affects:
AS
Imp Spec X
Best Practices Paper
Title:
Allow extensions points in UML-to-XML encoding rule
Source:
interactive instruments
Work item code:
Category:
Other
Date: 2008-09-19
B
Use one of the following categories:
F (Critical correction)
A (corresponds to a correction in an earlier
release)
B (Addition of feature),
C (Functional modification of feature)
D (Editorial modification)
Detailed explanations of the above categories can
be found in the TC Policies and Procedures.
Reason for change:
The UML-to-XML encoding rule specified in Annex E standardises an encoding
pattern that has been developed as a result of implementations. The encoding
rule covers only a limited set of the capabilities of UML and GML. For example,
the use of nilReason and xsi:nil in GML instances is not supported by the
standard encoding rule. Communities may have the need to specify extensions
to this encoding rule to address specific requirements that are not covered by
the standardised rule.
Summary of change: Amend the encoding rule to clarify how extensions to the standard encoding rule
can be specified. Add a conformance class.
Consequences if
not approved:
Use of extensions to the standard encoding rule cannot be used without breaking
conformance
Clauses affected:
Annex A, Annex E
Other specs
Affected:
Supporting Doc.
Other comments:
Status
Disposition
Other core specifications
Abstract specifications
Best Practices Document
Add the following sub-clause:
E.4 Encoding rule extensions
E.4.2 Overview
Information communities may have the need to specify extensions to the encoding rule specified in
E.2 to address specific requirements that are not covered by this encoding rule. This sub-clause
specifies requirements for such an extended GML encoding rule.
E.4.3 Conformance to ISO 19118
Any extended GML encoding rule shall conform to ISO 19118.
E.4.4 Reference to the specification of the extended encoding rule
An element with a URL referencing the specification of the
extended encoding rule shall be created in an annotation of each element in
the target namespace of the GML application schema created by applying the extended encoding
rule.
The specification of the extended encoding rule shall be documented in accordance with the
requirements stated in ISO 19118.
The element is defined as
E.4.5 Reference to standard encoding rule
Any extended GML encoding rule shall normatively reference E.2 and E.4.3 of this standard and
specify only the extensions to the rule in E.2.
Any extension shall be one of the following:
A new stereotype in the UML profile associated with a classifier, an attribute, an association
role or package.
o A new stereotype shall only be introduced, if the concept described by the stereotype is
not encoding specific but relevant on the conceptual level.
o Schema conversion rules shall be specified defining how XML Schema documents
shall be derived from UML model elements with the stereotype.
A new tagged value in the UML profile associated with a classifier, an attribute, an association
role or package.
o A new tagged value shall describe a concept that is specific to the GML encoding.
o
o
The name of the tagged value shall use a lowerCamelCase name starting with
"gmlext".
Schema conversion rules shall be specified defining how XML Schema documents
shall be derived from UML model elements with the tagged value.
A schema conversion rule for instances of GF_Constraint.
o
The schema conversion rule shall not convert the constraint to XML Schema, but to a
separate language.
EXAMPLE Schematron is a language to specify constraints.
NOTE: GML 3.2.1 references ISO 19118:2005 in its normative reference clause. I.e., this is
the version of ISO 19118 that is referenced by the references to “ISO 19118” above.
The OGC Technical Committee Policies & Procedures 05-020r3
Change the following sub-clause:
A.1.2
Test cases for GML application schemas converted from an ISO 19109 Application
Schema in UML using the standard encoding rule
A.1.2.1 Valid application schema
a) Test Purpose: If the GML application schema is mapped from an ISO 19109 Application
Schema in UML, verify that the UML application schema satisfies the requirements of the UML
profile.
b) Test Method: Check the conformance of the UML application schema with ISO 19109 and
check that the UML application schema has been constructed in accordance with E.2.1.
c) Reference: ISO 19109, Clause 2, Annex A; ISO 19136, E.2.1
d) Test Type: Capability Test
A.1.2.2 Schema conversion to XML Schema
a) Test Purpose: If the ISO 19109 Application Schema in UML satisfies the test stated in A.1.2.1,
verify that the GML application schema has been derived from the UML application schema
correctly.
b) Test Method: Compare both descriptions of the application schema and check whether the
conversion from UML to XML Schema is in accordance with the conversion rules in E.2.4.
c) Reference: ISO 19136, E.2.4
d) Test Type: Capability Test
Add the following sub-clause:
A.1.13 Test cases for GML application schemas converted from an ISO 19109 Application
Schema in UML using an extended encoding rule
A.1.13.1 References encoding rule
a) Test Purpose: Verify existence of a encoding rule.
b) Test Method: Check each schema document of the GML application schema and verify that each
contains an element /schema/annotation/appinfo/gml33:extendedEncodingRule. Verify that all
values are identical and that a document specifying the encoding rule can be retrieved by resolving
the URL.
c) Reference: ISO 19136, E.4.3
d) Test Type: Basic Test
A.1.13.2 Valid encoding rule
a) Test Purpose: Verify that the encoding rule conforms to the requirements in E.4.2 and E.4.4
b) Test Method: Check the conformance of the encoding rule retrieved in test A.1.13.1 with ISO
19118. Verify that the rule normatively references E.2 and E.4.3 of this standard and specifies only
the extensions to the rule in E.2 in accordance with E.4.4.
c) Reference: ISO 19136, E.4.2, E.4.4
d) Test Type: Capability Test
A.1.13.3 Valid application schema
a) Test Purpose: If the GML application schema is mapped from an ISO 19109 Application
Schema in UML, verify that the UML application schema satisfies the requirements of ISO 19109
and the additional requirements of the encoding rule.
b) Test Method: Check the conformance of the UML application schema with ISO 19109 and
check that the UML application schema has been constructed in accordance with the UML profile
stated in the encoding rule retrieved in test A.1.13.1.
c) Reference: ISO 19109, Clause 2, Annex A; ISO 19136, E.4.4
Last Revision Date: 2 December 2017
Page3
The OGC Technical Committee Policies & Procedures 05-020r3
d) Test Type: Capability Test
A.1.13.4 Mapping from an ISO 19109 Application Schema in UML
a) Test Purpose: If the ISO 19109 Application Schema in UML satisfies the requirements stated in
A.1.13.3, verify that the GML application schema has been derived from the UML application
schema correctly.
b) Test Method: Compare both descriptions of the application schema and check whether the
conversion from UML to XML Schema is in accordance with the conversion rules in the encoding
rule retrieved in test A.1.13.1.
c) Reference: ISO 19136, E.4.4
d) Test Type: Capability Test
Change table 1 in 2.2:
Table 1 — Conformance classes related to GML application schemas
Conformance class
All GML application schemas
GML application schemas converted from an ISO 19109 Application Schema in
UML using the standard encoding rule
GML application schema to be converted to an ISO 19109 Application Schemas
in UML
GML application schemas defining Features and Feature Collections
GML application schemas defining Spatial Geometries
GML application schemas defining Spatial Topologies
GML application schemas defining Time
GML application schemas defining Coordinate Reference Systems
GML application schemas defining Coverages
GML application schemas defining Observations
GML application schemas defining Dictionaries and Definitions
GML application schemas defining Values
GML application schemas converted from an ISO 19109 Application Schema in
UML using an extended encoding rule
Last Revision Date: 2 December 2017
Subclause of the
Abstract Test Suite
A.1.1
A.1.2
A.1.3
A.1.4
A.1.5
A.1.6
A.1.7
A.1.8
A.1.9
A.1.10
A.1.11
A.1.12
A.1.13
Page4