= Editing metadata related resources =

|| '''Date''' || 2013-01-02 ||
|| '''Contact(s)''' || Francois Prunayre ||
|| '''Status''' || Being discussed, in progress, initial implementation in progress ||
|| '''Assigned to release''' || 2.9.x ||
|| '''Resources''' || Available (funding Ifremer) ||
|| '''Ticket #''' || #XYZ ||
|| '''Github dev branch ''' || https://github.com/fxprunayre/core-geonetwork/tree/improvement/relations ||

== Overview ==

This proposal aims to improve the way a resource is linked to a metadata in editing mode. Indeed, !GeoNetwork provides multiples ways of adding link to external or internal resources in different places of the editor. We could list:
 * in the editor using the binocular to search for a record to link (eg. parentIdentifier, sources, featureCatalog, operatesOn, aggregates)
 * file upload for thumbnail or online sources
 * custom UI for service/dataset link

This proposal provide a main component to view, add or remove the related resources.

A related resource could be:
 * A thumbnail (URL or file to upload)
 * A parent metadata record (UUID to the metadata)
 * A service metadata record
 * A dataset metadata record
 * A online source (URL or file to upload)
 * A feature catalog (UUID to the metadata in ISO19110 format)
 * A sibling (See http://trac.osgeo.org/geonetwork/wiki/MetadataSiblings)


This component is only available for ISO19139 records (or ISO19139 profiles) but when related resources are metadata records, those records could be in any of the catalog supported standards (eg. ISO19110 for feature catalog).


=== Proposal Type ===
 * '''Type''': GUI Change
 * '''App''': !GeoNetwork
 * '''Module''': Widgets

=== Links ===
 * '''Documents''': 

=== Voting History ===
 * Vote not yet proposed.

== Motivations ==
Make relation management easier.

== Proposal == 

This related resource panel rely on:
 * the relation services (to retrieve current relation for a record)
 * XSL processing to add or remove a relation

=== Add a thumbnail ===

Two types of thumbnails could be linked to a metadata record:
 * an image linked using its URL (the image needs to be published online)
 * an image uploaded in the record data directory. After upload a small thumbnail could be created if requested.


The thumbnail upload form provide a simple way to add thumbnails:
[[Image(geonetwork-add-thumbnail.png)]]

The relation panel allows to quickly remove a thumbnail.


When the image is uploaded, the XML snippet corresponding to the image is the following:
{{{
<gmd:graphicOverview>
	<gmd:MD_BrowseGraphic>
		<gmd:fileName>
			<gco:CharacterString>http://www.cyber-heritage.co.uk/maps/map3.jpg</gco:CharacterString>
		</gmd:fileName>
	</gmd:MD_BrowseGraphic>
</gmd:graphicOverview>
<gmd:graphicOverview xmlns:srv="http://www.isotc211.org/2005/srv">
	<gmd:MD_BrowseGraphic>
		<gmd:fileName>
			<gco:CharacterString>http://localhost:8080/geonetwork/srv/eng/resources.get?uuid=7e512c38-f916-43ba-8367-85f17dcadca1&amp;fname=thumbnail.jpg</gco:CharacterString>
		</gmd:fileName>
		<gmd:fileDescription>
			<gco:CharacterString>large_thumbnail</gco:CharacterString>
		</gmd:fileDescription>
		<gmd:fileType>
			<gco:CharacterString>jpg</gco:CharacterString>
		</gmd:fileType>
	</gmd:MD_BrowseGraphic>
</gmd:graphicOverview>
}}}

When linking using a URL, the following XML snippet is inserted
{{{
<gmd:graphicOverview>
	<gmd:MD_BrowseGraphic>
		<gmd:fileName>
			<gco:CharacterString>http://organization.org/images/thumbnail.jpg</gco:CharacterString>
		</gmd:fileName>
	</gmd:MD_BrowseGraphic>
</gmd:graphicOverview>
}}}

In both cases, the information could be improved or updated using the editor from the advanced view > identification section.



=== Add an online source ===


=== Add a dataset to a metadata about a service ===


=== Add a service to a metadata about a dataset ===


=== Add a service to a metadata about a dataset ===


=== Backwards Compatibility Issues ===
None.

=== New libraries added ===
None.

== Risks ==
Everything involves some element of risk....

== Participants ==
 * Francois Prunayre
 * Ifremer
 * Camptocamp
 * Others?