INSPIRE

Infrastructure for Spatial Information in Europe

Best Practices for registers and registries & Technical Guidelines for the INSPIRE register federation

Title / Best Practices for registers and registries & Technical Guidelines for the INSPIRE register federation
Creator / JRC registry team
Date of last update / 2016-07-19
Subject / Best Practices for registers and registries & Technical Guidelines for the INSPIRE register federation
Status / Version 0.1
Publisher / MIG-T
Type / Text
Description / This document describesbest practices for setting up registers for INSPIRE, including for extended INSPIRE code lists. It also includes technical guidance for sharing national or community registers in the INSPIRE register federation and for using the federation’s access point (the “register of registers”) to search and browse through the registers included in the federation.
Format / MS Word (doc)
Source / MIG-T sub-group MIWP-6 on registers and registries
Rights / Reuse is authorised, provided the source is acknowledged. The reuse policy of the European Commission is implemented by aDecision of 12 December 2011.
Identifier / INSPIRE_Register_Federation_TG.docx
Language / EN
INSPIRE / Technical Guidelines & Best Practices for registers and registries
2016-07-19 / Page 1 of 54

Table of Contents

Foreword

Executive Summary

1Introduction

2Normative references

3Terms and abbreviations

3.1Terms

3.2Symbols and abbreviations

3.3Verbal forms for the expression of provisions

3.4References

4Registers and registries

4.1INSPIRE requirements for code lists and code list extensions

4.2Best practices for setting up registers and registries

4.3Register reuse (extensions, sub-sets and profiles)

4.3.1Harvesting scenario

4.3.2Reference scenario

5The INSPIRE register federation

5.1Why a register federation?

5.2Architecture and interactions

5.3RoR data model

6How to join the INSPIRE Register Federation

6.1Core conformance class

6.1.1Registry descriptor

6.1.2Register descriptor

6.2Automatic harvesting conformance class

6.2.1Registry descriptor

6.2.2Register descriptor

6.3Content conformance class

6.3.1Registry descriptor

6.3.2Register descriptor

6.4Validating the descriptors

6.5Registering descriptors in the RoR

7How to use the INSPIRE Register Federation

7.1Browsing the federation content

7.1.1Registries

7.1.2Registers

7.1.3Relations

7.2Searching for content in the federation

7.3API interface

Annex AExample descriptors

A.1Core conformance class

A.1.1Registry descriptor

A.1.2Register descriptor

A.2Automatic harvesting conformance class

A.2.1Registry descriptor

A.2.2Register descriptor

A.3Content conformance class

A.3.1Registry descriptor

A.3.2Register descriptor

Annex BDescriptor Validators

Annex CFrequently Asked Questions

Annex DRegistry information systems: available implementations

Foreword...... 3

Executive Summary...... 4

1Introduction...... 5

2Normative references...... 7

3Terms and abbreviations...... 8

3.1Terms...... 8

3.2Symbols and abbreviations...... 8

3.3Verbal forms for the expression of provisions...... 9

3.4References...... 10

4Registers and registries...... 11

4.1INSPIRE requirements for code lists and code list extensions...... 11

4.2Best practices for setting up registers and registries...... 12

4.3Register profiles (extensions and sub-sets)...... 19

4.3.1Harvesting scenario...... 20

4.3.2Reference scenario...... 20

5The INSPIRE register federation...... 21

5.1Why a register federation?...... 21

5.2Architecture and interactions...... 21

5.3Data model...... 23

5.3.1Registry...... 24

5.3.2Register...... 24

5.3.3Relation...... 25

6How to join the INSPIRE Register Federation...... 26

6.1Core conformance class...... 26

6.1.1Registry descriptor...... 26

6.1.2Register descriptor...... 29

6.2Automatic harvesting conformance class...... 31

6.2.1Registry descriptor...... 31

6.2.2Register descriptor...... 31

6.3Content conformance class...... 31

6.3.1Registry descriptor...... 32

6.3.2Register descriptor...... 32

6.4Validating the descriptors...... 33

6.5Registering descriptors in the RoR...... 33

7How to use the INSPIRE Register Federation...... 36

7.1Browse use case...... 36

7.1.1Registries...... 36

7.1.2Registers...... 37

7.1.3Relations...... 37

7.2Search use case...... 37

7.3API interface...... 38

Annex AExample descriptors...... 40

A.1Core conformance class...... 40

A.1.1Registry descriptor...... 40

A.1.2Register descriptor...... 41

A.2Automatic harvesting conformance class...... 42

A.2.1Registry descriptor...... 42

A.2.2Register descriptor...... 44

A.3Content conformance class...... 45

A.3.1Registry descriptor...... 45

A.3.2Register descriptor...... 47

Annex BDescriptor Validators...... 50

Annex CFrequently Asked Questions...... 52

Annex DRegistry information systems: available implementations...... 53

Table of figures

Figure 1 - Example for a hierarchical register

Figure 2 – Different types of register profiles. The original register is shown in light blue, the register profile in dark blue.

Figure 3 - RoR architecture – information retrieval and indexing

Figure 4 - RoR architecture – browsing and search

Figure 4 - Simplified RoR data model

Figure 5 - INPSIRE Register Federation administration page: adding a new registry descriptor

Figure 6 - Manual Harvesting start (red) & Report check (yellow highlight)

Figure 7 - Harvesting report dialog - Validation success

Figure 8 - Example of the INSPIRE Register Federation browsing interface: Registries

Figure 9 - Example of Registry details page

Figure 10 - Example of Register details page

Figure 11 - Example of Relation register

Figure 10 - Example of search interface

Figure 11 - Example of validator output

Figure 1 - Example for a hierarchical register...... 12

Figure 2 – Different types of profiles...... 20

Figure 3 - RoR architecture...... 24

Figure 4 - RoR simplified data model...... 25

Figure 5 - INPSIRE Register Federation administration page: adding a new registry descriptor....35

Figure 6 - Manual Harvesting start (red) & Report check (yellow highlight)...... 35

Figure 7 - Harvesting report dialog - Validation success...... 36

Figure 8 - Example of the INSPIRE Register Federation browsing interface: Registries...... 37

Figure 9 - Example of Registry details page...... 38

Figure 10 - Example of search interface...... 39

Figure 11 - Example of validator output...... 52

Foreword

Directive 2007/2/EC of the European Parliament and of the Council [INS DIR], adopted on 14 March 2007 aims at establishing an Infrastructure for Spatial Information in the European Community (INSPIRE) for environmental policies, or policies and activities that have an impact on the environment. INSPIRE will make available relevant, harmonised and quality geographic information to support the formulation, implementation, monitoring and evaluation of policies and activities, which have a direct or indirect impact on the environment.

INSPIRE is based on the infrastructures for spatial information established and operated by the 28 Member States of the European Union. The Directive addresses 34 spatial data themes needed for environmental applications. This makes INSPIRE a unique example of a legislative “regional” approach.

To ensure that the spatial data infrastructures of the Member States are compatible and usable in a Community and trans-boundary context, the Directive requires that common Implementing Rules (IR)be adopted in the following areas.

  • Metadata;
  • The interoperability and harmonisation of spatial data and services for selected themes (as described in Annexes I, II, III of the Directive);
  • Network Services;
  • Measures on sharing spatial data and services;
  • Co-ordination and monitoring measures.

The Implementing Rules are adopted as Commission Decisions or Regulations, and are legally binding in their entirety.

In addition to the Implementing Rules, non-binding Technical Guidance documents describe detailed implementation aspects and relations with existing standards, technologies, and practices. Technical Guidance documents define how Member States might implement the Implementing Rules described in a Commission Regulationor other aspects (not required by the Implementing Rules) that will improved interoperability in the INSPIRE infrastructure. These documents may include non-binding technical requirements that must be satisfied in order for an implementer to claim conformance with the Technical Guidance.

This document describesbest practices for setting up registers for INSPIRE, including for extended INSPIRE code lists. It also includes technical guidance for sharing national or community registers in the INSPIRE register federation and for using the federation’s access point (the “register of registers”) to search and browse through the registers included in the federation.

Note that there are no requirements in the INSPIRE implementing rules for setting up a register federation or for registry/register managers to join it. Therefore the compliance with the requirements in this document are entirely voluntary.

Disclaimer
This document has been developed collaboratively through the INSPIRE maintenance and implementation framework, involving the European Commission, European Environment Agency, EU Member States, the Accession and EFTA Countries. The document should be regarded as presenting an informal consensus position on best practice agreed by all partners. However, the document does not necessarily represent the official, formal position of any of the partners. Hence, the views expressed in the document do not necessarily represent the views of the European Commission.

Executive Summary

Registers provide a means to assign unique identifiers (or “reference codes”) to and consistently manage different versions of resources used in the INSPIRE infrastructure,such as INSPIRE code lists, INSPIRE themes, coordinate reference systems or application schemas. Registries are information systems for the maintenance and publication of registers.

INSPIRE includes only one legal obligation related to registers: extensions by data providers of the code lists mandated in Commission Regulation (EU) No 1089/2010 on interoperability of spatial data sets and services need to be published in registers. This document provides technical guidance for setting up such registers for extended INSPIRE code lists.

However, Member States and thematic communities are setting up registers for other purposes as well, e.g. to have a single repository of all organisations in a MS responsible for implementing INSPIRE, including their unique identifiers. In general, registers are useful in all situations where, by a reference code rather than free text, in data exchange, ambiguities or inconsistencies can be avoided. Also registers can facilitate the internationalisation of user interfaces by providing multilingual labels.

Therefore, this document also includes general guidance and best practices for setting up registers supporting INSPIRE implementation and for sharing the content of national or community registers in a register federation and for using the federation’s access point (the “register of registers”) to search and browse through the registers included in the federation.

This document is based on the work of the sub-group MIWP-6 on registers and registries of the maintenance and implementation group in 2015 and 2016.

1Introduction

Registers provide a means to assign unique identifiers (or “reference codes”) to and consistently manage different versions of resources used in the INSPIRE infrastructure,such as INSPIRE code lists, INSPIRE themes, coordinate reference systems or application schemas. Registries are information systems for the maintenance and publication of registers.

Managing and making available items in registers offers several benefits [adapted from ISO 19135-1]:

a)Registration of items supports wider use of registered items by making them publicly available to INSPIRE users.

b)Registers may provide a single mechanism to access information concerning items that are specified or used in different INSPIRE components.

c)Registers provide a mechanism for managing temporal change (of available items of a certain type and their definitions).

NOTE Items specified in a register may change over time either due to changes in technology or for other reasons. INSPIRE documentsmay not clearly document what changes may have occurred, and do not include information about earlier versions of specified items. Such information can be maintained in a register.

d)Registers may be used to make sets of standardized tags available for encoding of registered items in data sets.

e)Registers can support cultural and linguistic adaptability by providing both a means for recording equivalent names of items used in different languages, cultures, application areas and professions, and a means for making those equivalent names publicly available.

INSPIRE includes only one legal obligation related to registers: extensions by data providers of the code lists mandated in Commission Regulation (EU) No 1089/2010 on interoperability of spatial data sets and services need to be published in registers. INSPIRE implementers need technical guidance on how to set up such registers for extended INSPIRE code lists and how these can be linked to the central INSPIRE code list register.

At the same time, Member States and thematic communities are setting up registers for other purposes as well, e.g. to have a single repository of all organisations in a MS responsible for implementing INSPIRE, including their unique identifiers. In general, registers are useful in all situations where, by a reference code rather than free text, in data exchange, ambiguities or inconsistencies can be avoided. Also registers can facilitate the internationalisation of user interfaces by providing multilingual labels.

Within the MIWP 2014-2016, an action and sub-group[1] (MIWP-6) was therefore set up to develop technical guidelines and best practices for setting up register and registries and how European, national or community registers and the links between them can be published in and accessed through a register federation. The action also worked on setting up an access point to the INSPIRE register federation, the register of registers (RoR).

Based on the work of the MIWP-6 sub-group, this document contains

  • best practices for setting up registers supporting INSPIRE implementation (section 4.2);
  • best practices for setting up registers for extended INSPIRE code lists and how to link them to the central INSPIRE code list register (section 4.3);
  • a description of the concept and architecture of the INSPIRE register federation and the register of registers (section 5);
  • guidance for sharing the content of national or community registers in the INSPIRE register federation (section 6);
  • guidance for using the register of registers to search and browse through the registers included in the federation (section 7).

It also includes several annexes with detailed examples (Annex A), validation scripts (Annex B), frequently asked questions (Annex C) and an overview of existing software for registry management (Annex D).

Items for future work on this document include:

  • Documentation of the API of the RoR
  • Support for multi-lingual registers in the RoR harvesting

2Normative references

The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.

DCATFadiMaali; John Erickson. W3C. Data Catalog Vocabulary (DCAT). 16 January 2014. W3C Recommendation. URL:

INS DIRDirective 2007/2/EC of the European Parliament and of the Council of 14 March 2007 establishing an Infrastructure for Spatial Information in the European Community (INSPIRE), OJ L 108, 24.4.2007, p. 1

INS ISDSSCommission Regulation (EU) No 1089/2010 of 23 November 2010 Implementing Directive 2007/2/EC of the European Parliament and of the Council as regards interoperability of spatial data sets and services as amended by Commission Regulation (EU) No 1312/2014 of 10 December 2014,OJ L 354, 11.12.2014, p. 8–16

ISO 19106ISO 19106:2004, Geographic information – Profiles. URL:

ISO 19135-1ISO 19135-1:2015, Geographic information – Procedures for item registration – Part1: Fundamentals. URL:

SKOSAlistair Miles; Sean Bechhofer. W3C. SKOS Simple Knowledge Organization System Reference. 18 August 2009. W3C Recommendation. URL:

W3C DWBPBernadette FariasLóscio; Caroline Burle; Newton Calegari. W3C. Data on the Web Best Practices. 19 May 2016. W3C Editor’s Draft. URL:

3Terms and abbreviations

3.1Terms

(1)code list: open enumeration that can be extended [IR-ISDSS]

(2)enumeration: data type whose instances form a fixed list of named literal values. Attributes of an enumerated type may only take values from this list [IR-ISDSS]

(3)item: that which can be individually described or considered [ISO2859-1]

NOTE An item can be any part of a dataset, such as a feature, feature relationship, feature attribute, or combination of these.

(4)item class: set of items with common properties [ISO 19135-1]

NOTE Class is used in this context to refer to a set of instances, not the concept abstracted from that set of instances.

(5)metadata: information describing spatial data sets and spatial data services and making it possible to discover, inventory and use them [INS DIR]

NOTE A more general definition provided by ISO 19115 is "data about data"

(6)multilingual: in or using several languages [Oxford Dictionary]

(7)register: set of files containing identifiers assigned to items with descriptions of the associated items [ISO 19135-1]

(8)registry: information system on which a register is maintained [ISO 19135-1]

(9)registry service: Service that provides access to a register

(10)resource: asset or means that fulfils a requirement [ISO 19115]

NOTEA resource can be anything that has identity. In the context of the web as the network of INSPIRE, a resource will be identified by a URI. For resources managed in INSPIRE registers, the URIs will be persistent and dereferenceable. Dereferencing of the URI will return a representation of the resource in a well-known representation.

EXAMPLE: Dataset, service, document, person or organization. …

3.2Symbols and abbreviations

ISDSS / Interoperability of spatial data sets and services
ISO / International Organization for Standardization[2]
MD / Metadata
MS / Member state
RoR / Register of Registers
SKOS / Simple Knowledge Organization System
URL / Uniform Resource Locator
XSD / XML Schema Definition

3.3Verbal forms for the expression of provisions

In accordance with the ISO rules for drafting, the following verbal forms shall be interpreted in the given way:

  • “shall” / “shall not”: a requirement, mandatory to comply with the technical guidance
  • “should” / “should not”: a recommendation, but an alternative approach may be chosen for a specific case if there are reasons to do so
  • “may” / “need not”: a permission

Technical Guidance Conformance Classes notation

The Technical Guidance in this document is divided into Conformance Classes, so that it is possible to declare conformance to specific parts of the Technical Guidance. To conform to a Conformance Class it is necessary to meet all of the Requirements (see next section) in that Conformance Class.

Conformance Classes are identified in the document as follows:

TG Conformance Class #: [TITLE]conformanceclassesareshownusingthis style

Technical Guidance Requirements and Recommendations notation

Requirements and the recommendations for INSPIRE Spatial Data Services and services allowing spatial data services to be invoked within this technical guidance are highlighted and numbered as shown below:

TG Requirement #requirements are shown using this style

TG Recommendation #recommendations are shown using this style.

Requirements and recommendations belong to the conformance class in which they are found in this document.

Note: It is worth noting that requirements as specified in the INSPIRE Regulations and Implementing Rules are legally binding, and that requirements and recommendations as specified in INSPIRE Technical Guidance are not legally binding. Therefore, within this technical guidance we have used the terms ‘TG requirement’ and ‘TG recommendation’ to indicate what is technically required or recommended to conform to the Technical Guidance.

XML Example notation

XML Examples are shown using Courier New on a grey background with yellow for emphasis as below:

<inspire:example>

<inspire:highlight>

Highlighted Text for emphasis

</inspire:highlight>

</inspire:example>

Note: XML Examples are informative and are provided for information only and are expressly not normative.

3.4References

References within this document are denoted using “Section” or “Annex”. For example, Section 5.3.1 or Annex A.

References to other documents refer to the list of normative references in Section 1.1 and use the abbreviated title as indicated in Bold text. For example, [INS NS] uses the abbreviated title for the document as shown below: