= Add Support for Inspire Download Service As Atom Feed =

|| '''Date''' || 2012/09/18 ||
|| '''Contact(s)''' || Paul van Genuchten ||
|| '''Last edited''' || ||
|| '''Status''' || OnGoing ||
|| '''Assigned to release''' || 2.x ||
|| '''Resources''' || ||
|| '''Ticket #''' || ||
|| '''Github source''' ||  ||



== Proposal ==

'''Generate Atom'''

Inspire requires either WFS service or Atom xml for downloading datasets. These days governments are uploading xml-files as Atom-files and link to that document from the Geonetwork data download link. The Atom document contains roughly the same information as an Inspire iso19115/9 record in GN. So seems quite usefull to generate this feed document as an output format for Geonetwork. More info can be read in technical guidence for download services doc 3.0rc1 and/or http://wiki.geonovum.nl/index.php/Download_Service_via_Atom_feed (in dutch).

{{{
http://.../geonetwork/srv/eng/ATOM?uuid=a3d33-...
}}}

Would return a document like:

{{{

<feed xmlns="http://www.w3.org/2005/Atom"
    xmlns:georss="http://www.georss.org/georss"
    xmlns:inspire_dls="http://inspire.ec.europa.eu/schemas/inspire_dls/1.0">
    <!-- feed title -->
    <title xml:lang="nl">Demonstratie INSPIRE Download Service 3.0, ATOM - Service Feed</title>
    <!-- feed subtitle -->
    <subtitle xml:lang="nl">INSPIRE Download Service van Geonovum als demonstratie van een Download Service met voorgedefinieerde datasets voor Geografische namen en Administratieve eenheden</subtitle>
    <!-- links to metadata and alternative representations -->
    <link href="http://s01.geonovum.site4u.nl/download/metadata_atom_servicefeed.xml" rel="describedby" type="application/vnd.iso.19139+xml"/>
    <link href="http://s01.geonovum.site4u.nl/download/downloadservice_atom_servicefeed.xml" rel="self" type="application/atom+xml"
        hreflang="nl" title="Demonstratie INSPIRE Download Service 3.0 - Service Feed"/>
    <link rel="search" href="http://s01.geonovum.site4u.nl/download/opensearch_description.xml" type="application/opensearchdescription+xml" title="Open Search Description voor Demonstratie INSPIRE Download Service 3.0, ATOM - Service Feed"/>
    <!-- identifier -->
    <id>http://s01.geonovum.site4u.nl/download/downloadservice_atom_servicefeed.xml</id>
    <!-- rights, access restrictions -->
    <rights>geen toegangsbeperkingen</rights>
    <!-- date/time of last update of feed -->
    <updated>2012-06-18T15:35:06Z</updated>
    <!-- author info -->
    <author>
        <name>Geonovum</name>
        <email>jj@jj.org</email>
    </author>
    <entry>
        <!-- title for pre-defined dataset -->
        <title xml:lang="nl">Geografische namen (DEMO) NamedPlaces - Parent Feed (CRS)</title>

		<!-- Spatial Dataset Unique Resourse Identifier voor de dataset -->
		<inspire_dls:spatial_dataset_identifier_code>06b6c650-cdb1-11dd-ad8b-0800200c9a79</inspire_dls:spatial_dataset_identifier_code>
		<!-- Geonovum: de namespace voor de code, van toepassing op de dataset. Nadere invulling hiervan volgt nog. -->
		<inspire_dls:spatial_dataset_identifier_namespace>http://s01.geonovum.site4u.nl/download</inspire_dls:spatial_dataset_identifier_namespace>
        <link href="http://nationaalgeoregister.nl/geonetwork/srv/nl/iso19139.xml?uuid=81ff84ec-42a4-4481-840b-12713bbb5d38" rel="describedby" type="application/xml"/>
        <!-- Link naar Dataset feed -->
        <link href="http://s01.geonovum.site4u.nl/download/downloadservice_atom_dataset1.xml" rel="alternate" type="application/atom+xml"
            hreflang="nl" title="Geografische namen (DEMO) - Download Service voorgedefinieerde dataset"/>            
        <id>http://s01.geonovum.site4u.nl/download/downloadservice_atom_dataset1.xml</id>
	    <updated>2012-06-18T15:35:04Z</updated>
        <!-- Optioneel: een samenvatting / omschrijving  -->
		<summary>Download de dataset Geografische namen (DEMO) NamedPlaces, via deze feed</summary>
        <!-- The service feed contains the boundingbox, in polygon format -->
        <georss:polygon>50.7539 3.37087 50.7539 7.21097 53.4658 7.21097 53.4658 3.37087 50.7539 3.37087</georss:polygon>
        <!-- For each entry provide CRS information -->
        <category term="http://www.opengis.net/def/crs/EPSG:4258"
            label="ETRS89"/>
        <category term="http://www.opengis.net/def/crs/EPSG:4326"
            label="WGS84"/>
    </entry>
</feed>


}}}

'''Validate Atom'''

Before being able to harvest metadata from Atom Feeds i guess we'll need Atom XSD in GN

'''Harvest ATOM'''

Similar to a WMS-capabilities harvest. An Atom harvest would be able to harvest iso19115 and iso19119 metadata records from an Atom feed.

'''Display Atom Contents'''

The atom link can be referred to from the Inspire iso19115 and Inspire iso19119 records in the catalogue

{{{
<srv:connectPoint><gmd:CI_OnlineResource><gmd:linkage><gmd:URL>http://.../geonetwork/srv/eng/ATOM?uuid=a3d33-...</gmd:URL></gmd:linkage></gmd:CI_OnlineResource></srv:connectPoint>
}}}

An example reord can be viewed at: http://www.nationaalgeoregister.nl/geonetwork/srv/nl/iso19139.xml?id=448130

If GN finds such an atom feed url in the gmd:url field, the metadata record-view could get the feed contents and return the linked datasets inside the Atom document and present them as hyperlinks

'''Inspire validation of the introduced tooling'''

Geonovum (dutch government) has used SoapUi to build a complience test framework for view & download services, http://www.geonovum.nl/dossiers/inspire/implementatie/conformiteit. This framework can be used to check whether the 
introduced tooling complies with the inspire directives. Goal is to minimize manual duplication of metadata elements.

'''TODO:'''
 
 * create Atom output format (new metadata.show endpoint using custom xslt)
 * Add option to iso19115 'online resource' section to auto generate a hyperlink to an Atom feed referring to the uploaded dataset
 * Add option to harvest iso19115/iso19119 metadata from an Atom Feed
 * If online resource section contains atom link, present as human readable in metadata record view
 * Complience testing

=== Proposal Type ===

 * '''Type''': Inspire download service improvement
 * '''App''': GeoNetwork
 * '''Module''': Inspire

=== Voting history ===

Vote proposed by Paul on 2012/MM/DD, result was
 * ?

== Risks ==
 * ?

== Participants ==
 * Paul van Genuchten
 * Steven Smolders
 * Heikki Doeleman
 * Jose Garcia