NPTG & NaPTAN Versions

NPTG &  NaPTAN  uses a systematic versioning scheme in line with GovTalk & e-Gif  standards. The system is intended to allow you to design applications that operate at different schema levels concurrently, and to manage future schema application evolution in a rigourous and orderly manner.

  1. Version Numbering
  2. Version Location
  3. Version Identifiers

Both schemas & instance documents are versioned.

1. Version Numbering

1.1 Version Numbers

All NPTG &  NaPTAN  schemas have a version Identifier of the form N.Mx, where:

  • N indicates a Major release, e.g. "2.0". A major release is usually is not strictly compatible with the previous release.
  • M indicates a Minor release, e.g. "2.1". A minor release is compatible with the previous release, providing any new optional features added in the release are not used
  • x indicates an Unapproved draft, e.g. "1.0a", "4.3a". A letter suffix indicates that the release is not yet officially approved or released.

2. Version Location

2.1 Schema versions

NPTG &  NaPTAN  schema versions are always located at a specific, versioned URL. The URL has the general form:

  • http://www.naptan.org.uk/schema/N.M/NaPtan.xsd

Examples.

Version 1.1 of NaPTAN:

Draft of Version 1.2 of NaPTAN:

2.2 Namespace versions

Note that the namespace used for NaPTAN is not itself versioned, in line with GovTalk & e-Gif standards, thus:

<xs:schema targetNamespace="http://www.naptan.org.uk/schemas/"

2.3 Directory Structure

NPTG & NaPTAN artefacts are organised into a hierarchical directory structure  relative to the root domain, in accordance with the e-Gif versioning system. For example the directory structure used is as follows:

//www.naptan.org.uk/
//www.naptan.org.uk/schema/
...
//www.naptan.org.uk/schema/2.1/
//www.naptan.org.uk/schema/2.1/NaPtan.xsd

//www.naptan.org.uk/schema/2.0/
//www.naptan.org.uk/schema/2.0/NaPtan.xsd
//www.naptan.org.uk/schema/2.0/NPTG.xsd
//www.naptan.org.uk/schema/2.0/NPTG_Discovery.xsd
//www.naptan.org.uk/schema/2.0/napt/NaPT_stop-v2-0.xsd
//www.naptan.org.uk/schema/2.0/napt/NaPT_common-v2-0.xsd
//www.naptan.org.uk/schema/2.0/napt/NaPT_dates-v2-0.xsd
//www.naptan.org.uk/schema/2.0/napt/NaPT_geographic-v2-0.xsd
//www.naptan.org.uk/schema/2.0/napt/NaPT_topography-v2-0.xsd
//www.naptan.org.uk/schema/2.0/xml/xml.xsd
//www.naptan.org.uk/schema/2.0/guide
//www.naptan.org.uk/schema/2.0/guide/NaPtanSchemaGuide-v2.0-32.pdf
   ....

3.  Version Identifiers

3.1 Schema Version Identifiers

All NPTG &  NaPTAN schema versions have a formal version identifier in the header element: 

<xs:schema targetNamespace="http://www.naptan.org.uk/schemas/"
xmlns="http://www.naptan.org.uk/schemas/"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified"
attributeFormDefault="unqualified"
version="2.0"
id="NaPTAN">
...

3.2 Document Version Identifiers

All NPTG &  NaPTAN  documents have a version identifier which must be populated by the implementation to indicate the schema level against which the document validates.

<?xml version="1.0" encoding="UTF-8"?>
<NaPTAN xmlns="http://www.naptan.org.uk/"   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.naptan.org.uk/:\Projects\Naptan\schema\2.0\NaPTAN.xsd" CreationDateTime="2004-07-17T09:30:47-05:00" ModificationDateTime="2004-07-17T09:30:47-05:00" Modification="new" RevisionNumber="1" FileName="String" SchemaVersion="2.0" LocationSystem="Grid">
   <StopPoints>
   ......
   </StopPoints>
</NaPTAN>

3.3 Package versions

Low level  subschemas that are shared with other schemas and referenced by NPTG &  NaPTAN schemas are individually versioned within a subdirectory, for example /napt  and /apd. Copies of the referenced subschemas are included in the download so that the schemas can be used offline. For example:

 //www.naptan.org.uk/schema/2.0/napt/NaPT_stop-v2-0.xsd
 
GovTalk logo