KML 2.2 Validator

Scope

The OGC KML conformance test suite implements the abstract test suite (ATS) for OGC KML 2.2 and provides a basis for verifying the structure and content of KML 2.2 documents.

Three conformance levels are defined in the KML 2.2 specification, where each level builds upon the lower level by imposing additional constraints; these essentially correspond to the imperative terms defined in RFC 2119 (MUST, SHOULD, MAY).

• Level 1 - includes test cases covering requirements that must be satisfied by a minimally conformant document;
• Level 2 - as for Level 1, plus test cases addressing recommended constraints;
• Level 3 - as for Level 2, plus test cases covering suggested constraints that are informative in nature.

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

The Javadoc documentation provides more detailed information about the test classes and test methods that comprise the suite.

Test requirements

The documents listed below stipulate requirements that must be satisfied by a conforming instance document.

• [OGC-07-147r2] OGC® KML 2.2.0
• [OGC-07-134r2] OGC KML 2.2 - Abstract Test Suite

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
• TEAM-Engine: Run the CTL script located in the /src/main/ctl/ directory.

The test run arguments are summarized in Table 2. The value domain is expressed in terms of XML Schema datatypes for convenience. The Obligation descriptor can have the following values: M (mandatory), O (optional), or C (conditional).