GML 3.2 (ISO 19136:2007) Conformance Test Suite

Scope

This executable test suite (ETS) verifies the conformance of GML data and application schemas with respect to ISO 19136:2007 (GML 3.2). It includes Version 3.2.1 and the corrigendum GML 3.2.2. It can be used to check a GML application schema or an instance document; both types of resources are referenced by URI. The application schema could be accessed from a variety of sources, such as a WFS (DescribeFeatureType request using the GET method) or a catalogue service. As shown in Figure 1, a conforming GML data instance must refer to the relevant GML application schema, which in turn imports the complete GML schema.

Figure 1 - GML schemas

A Schematron schema (ISO 19757-3) may be used to define supplementary data constraints that lay beyond the reach of an XML Schema grammar. A GML instance document may include a schema reference using the xml-model processing instruction (PI) as described in ISO 19757-11. The PI must appear before the document element as shown in the following listing.

<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://example.org/data-constraints.sch" 
            schematypens="http://purl.oclc.org/dsdl/schematron" 
            phase="#ALL"?>
<CityModel xmlns="http://www.opengis.net/citygml/2.0">
  <!-- content omitted --> 
</CityModel>

The uom attribute indicates the unit of measure for some measured quantity. If the value is not an absolute URI, it is expected to be a unit symbol (possibly with a prefix symbol) appearing in the Unified Code for Units of Measure (UCUM).

Test coverage

Table 1 in the GML specification defines the conformance classes related to GML application schemas. In this test suite all mandatory conformance requirements are checked, and every GML instance document is thoroughly validated against all referenced application schemas. However, the classes dealing with less commonly used types of objects are not implemented by the current test suite. Table 1 below indicates the implementation status of each conformance class.

No specific conformance classes are defined for GML instance documents. However, clause A.3 (Abstract test suite for GML documents) includes a set of abstract test cases for validating GML documents. Of these, A.3.1-A.3.4 are implemented by this test suite. Clause A.3.5 is a very broad, catch-all constraint that is partly implemented: “Verify that the GML document complies with all other constraints specified by this International Standard.”

Among the constraints implied by A.3.5 are those concerned with the validity of geometry representations. The suite includes tests that validate the geometry elements listed below; these tests also apply to any application-defined geometries that can substitute for the standard GML elements.

• gml:Point
• gml:Curve having the following curve segments: gml:ArcByCenterPoint, gml:CircleByCenterPoint, gml:Arc, gml;Circle, gml:GeodesicString, gml:Geodesic, gml: LineStringSegment
• gml:OrientableCurve
• gml:CompositeCurve
• gml:Polygon
• gml:Surface having the following surface patches: gml:PolygonPatch, gml:Rectangle, gmlTriangle

Test suite structure

The test suite definition file (testng.xml) is located in the root package, org.opengis.cite.iso19136. A conformance class corresponds to a element; each test element includes a set of test classes that contain the actual test methods. The general structure of the test suite is shown in Table 2.

The Javadoc documentation provides more detailed information about the test methods that constitute the suite.

Test requirements

The documents listed below stipulate requirements that must be satisfied by a conforming application schema.

• ISO-19136 - Geographic information – Geography Markup Language (GML). Also published as OGC 07-036 and OGC 07-036r1.
• XML Schema Part 1: Structures, Second Edition

A conforming GML application schema must satisfy all mandatory constraints and define at least one type of GML object in accord with clauses 21.3 through 21.11. The applicable type-specific test cases are described in clauses A.1.4 through A.1.12.

How to run the tests

The test suite may be run in any of the following environments:

• Integrated development environment (IDE): The main Java class is TestNGController.
• REST API: Submit a request that includes the necessary arguments to the test run controller (/rest/suites/${ets-code}/${project.version}/run).
• TEAM-Engine: Run the CTL script located in the /src/main/ctl/ directory.

The test run arguments are summarized in Table 3. The Obligation descriptor can have the following values: M (mandatory), O (optional), or C (conditional). A GML application schema may be validated by itself without a referring document.

Table 3 - Test run arguments

Notes:

1. Ampersand (‘&’) characters appearing within query parameter values must be percent-encoded as %26.
2. See ISO 19757-3:2006