TG Download - Data-service linking simplification for Atom

[heidivanparys]

Change proposal description

This change proposal is the outcome of the work done in https://github.com/INSPIRE-MIF/gp-data-service-linking-simplification/ that relates to the Atom implementation in the TG Download.

Addressed TG

Technical Guidance for the implementation of INSPIRE Download Services

Location

Section 5.1, Atom “Download Service Feed” containing an entry for a Pre-defined dataset. The main changes will occur in section 5.1.3 Download Service Feed: feed “link” element – service metadata, but other sections will have to be updated consequentially.

Issue faced

Section 5.1.3 Download Service Feed: feed “link” element – service metadata should be updated to contain a second option (also called scenario), in which the Download Service metadata elements are published only in the download service feed, not in a metadata record in a discovery service.

Proposed solution

1 – Update TG Requirement 6 from

(see also https://github.com/inspire-eu-validation/download-atom/blob/3.1/atom-pre-defined/download-service-feed-link-to-metadata-record.md).

to

The INSPIRE Metadata for the Download Service shall be linked to in one of the following ways:

1. The Download Service Feed shall contain an Atom link element that links to the metadata record for this Download Service. The value of the rel attribute of this element shall be describedby and the value of the type attribute shall be either application/xml or application/vnd.ogc.csw.GetRecordByIdResponse_xml;
2. The Download Service Feed shall contain the INSPIRE Metadata for the Download Service in accordance with Table x.

and add table x as present below:

Table x

INSPIRE Metadata element	Atom	Fallback
Resource Title (M)	/feed/title
Resource Abstract (M)	/feed/subtitle
Resource Type (M)	-	Is by default “service”
Resource Locator (C)	/feed/link[@rel="self"] in the top Atom feed	Resource Locator of the data set
Coupled Resource (C)	/feed/entry/link[@rel="describedby"] in the top Atom feed
Spatial Data Service Type (M)	-	gmd:MD_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:transferOptions/gmd:MD_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource/gmd:applicationProfile in the ISO/TS 19139:2007 metadata record dataset
Keyword (M)	/feed/category; note that a keyword indicating the spatial data service category is required, see example below this table.
Geographic Bounding Box (M)	-	Geographic Bounding Box of the data set
Temporal Reference (M)	/feed/updated
Spatial Resolution (C)	Spatial Resolution of the data set
Conformity (M)	atom:category element	Using a atom:category element for each specification against which the service is conformant
Conditions for Access and Use (M)	-	identificationInfo[1]/*/resourceConstraints/*/accessConstraints in the ISO/TS 19139:2007 metadata record dataset
Limitations on Public Access (M)	/feed/rights in the top Atom feed
Responsible Organisation (M)	/feed/author in the top Atom feed
Metadata Point of Contact (M)	/feed/author in the top Atom feed
Metadata Date (M)	/feed/updated
Metadata Language (M)	gmd:MD_Metadata/gmd:language/gmd:LanguageCode in dataset metadata for main language, other supported language (if any) will be mapped to the xml:lang

Example for the spatial data service category:

<atom:category term="http://inspire.ec.europa.eu/metadata-codelist/SpatialDataServiceCategory/infoFeatureAccessService" scheme="http://inspire.ec.europa.eu/metadata-codelist/SpatialDataServiceCategory"/>

2 – Remove the sentence below table 17, move table 17 to section 5.1.3 and give it title “Mapping of INSPIRE metadata elements to Atom for option 1”.

INSPIRE Metadata element	Atom	Note
Resource Title (M)	/feed/title	Will typically correspond with the Resource Title in the metadata record in the discovery service
Resource Abstract (M)	/feed/subtitle	Will typically correspond with the Resource Abstract in the metadata record in the discovery service
Resource Type (M)	-	See Resource Type in the metadata record in the discovery service
Resource Locator (C)	/feed/link[@rel="self"] in the top Atom feed
Coupled Resource (C)	/feed/entry/link[@rel="describedby"] in the top Atom feed
Spatial Data Service Type (M)	-	See Spatial Data Service Type in the metadata record in the discovery service
Keyword (M)	-	See Keyword in the metadata record in the discovery service
Geographic Bounding Box (M)	-	See Geographic Bounding Box in the metadata record in the discovery service
Temporal Reference (M)	-	See Temporal Reference in the metadata record in the discovery service
Spatial Resolution (C)	-	See Spatial Resolution in the metadata record in the discovery service
Conformity (M)	-	See Conformity in the metadata record in the discovery service
Conditions for Access and Use (M)	-	See Conditions For Access and Use in the metadata record in the discovery service
Limitations on Public Access (M)	/feed/rights in the top Atom feed	Will typically correspond with the Limitations on Public Access in the metadata record in the discovery service
Responsible Organisation (M)	/feed/author in the top Atom feed
Metadata Point of Contact (M)	-	See Metadata Point of Contact in the metadata record in the discovery service
Metadata Date (M)	/feed/updated
Metadata Language (M)	/feed/link[@rel="self"]/@hreflang

3 – Remove the following sentences, as their meaning is included in the table above.

• Typically this will correspond with the 'Resource Title' in the corresponding service metadata record. (section 5.1.1)
• Typically this will correspond with the 'Resource Abstract' in the corresponding service metadata record. (section 5.1.2)
• Typically this will correspond with the value of 'accessConstraints' in the corresponding service metadata record. (section 5.1.9)

Pull request

TODO (note: the TG download is not yet available as Asciidoc in https://github.com/INSPIRE-MIF/technical-guidelines/, see the conversion plan)

Additional information

Relevant legislation

Get Download Service Metadata operation

Impact on IR

No impact.

Impact on INSPIRE validator

This impacts test Download service feed: Provide link to metadata record for the download service.

Linked issue

N/A

Impact on INSPIRE XML schemas

No impact.

Impact on INSPIRE code lists

No impact.

Change proposer

Subgroup 2.3.2 (Data and Service Linking simplification)

References

https://github.com/INSPIRE-MIF/gp-data-service-linking-simplification

[pvgenuchten]

this will impact the download service validator

[heidivanparys]

this will impact the download service validator

Yes indeed, that is also stated in the change proposal.

[heidivanparys]

Created INSPIRE-MIF/technical-guidelines#105, so closing this one. Please review the new issue, as the TG Download was not available back then when the changes were discussed.