Skip to content

Latest commit

 

History

History
executable file
·
192 lines (136 loc) · 4.86 KB

README.md

File metadata and controls

executable file
·
192 lines (136 loc) · 4.86 KB

Geospatial User Feedback schema plugin

This is the Geospatial User Feedback (GUF) schema plugin for GeoNetwork 3.2.x or greater version.

Reference documents:

Description:

Schema can be used to describe structure of user feedback items on catalogue items.

This plugin is composed of:

  • indexing
  • editing (Angular editor only)
  • editor associated resources
  • directory support for contact, logo and format.
  • viewing
  • CSW
  • from/to DUV conversion
  • multilingual metadata support
  • validation (XSD and Schematron)

Metadata rules:

Metadata identifier

The metadata identifier is stored in the element guf:GUF_FeedbackItem/guf:itemIdentifier. Only the code is set by default but more complete description may be defined (see authority, codeSpace, version, description).

<guf:itemIdentifier>
  <mcc:MD_Identifier>
    <mcc:code>
      <gco:CharacterString>GCL2000_feedack_item_1</gco:CharacterString>
    </mcc:code>
  </mcc:MD_Identifier>
</guf:itemIdentifier>

Target metadata

The target metadata record is referenced using the following form from the editor:

<guf:GUF_FeedbackTarget>
  <guf:resourceRef xlink:href="http://www-gvm.jrc.it/glc2000">
    <cit:CI_Citation>
      <cit:title/>
      <cit:identifier>
        <mcc:MD_Identifier>
          <mcc:code>
            <gco:CharacterString>GLC2000</gco:CharacterString>
          </mcc:code>
          <mcc:codeSpace>
            <gco:CharacterString>jrc.ec.europa.eu</gco:CharacterString>
          </mcc:codeSpace>
        </mcc:MD_Identifier>
      </cit:identifier>
    </cit:CI_Citation>
  </guf:resourceRef>
</guf:GUF_FeedbackTarget>

Nevertheless, the citation code is also indexed.

Validation

## CSW requests:

To retrieve the record in GUF10, use http://www.opengis.net/guf/1.0/core output schema.

<?xml version="1.0"?>
<csw:GetRecordById xmlns:csw="http://www.opengis.net/cat/csw/2.0.2"
  service="CSW"
  version="2.0.2"
  outputSchema="http://www.opengis.net/guf/1.0/core">
    <csw:Id>cecd1ebf-719e-4b1f-b6a7-86c17ed02c62</csw:Id>
    <csw:ElementSetName>brief</csw:ElementSetName>
</csw:GetRecordById>

Note: outputSchema = own will also return the record in GUF10.

Installing the plugin

### GeoNetwork version to use with this plugin

It'll not be supported in 2.10.x series so don't plug it into it! Use GeoNetwork 3.2.x+ version.

Adding the plugin to the source code

The best approach is to add the plugin as a submodule into GeoNetwork schema module. Note that this schema depends on iso19115-3.

cd schemas
git submodule add https://github.com/metadata101/iso19115-3.git iso19115-3
git submodule add https://github.com/metadata101/guf10.git guf10

Add the new modules to the schema/pom.xml:

  <module>iso19115-3</module>
  <module>guf</module>
</modules>

Add the dependencies in the web module in web/pom.xml:

<dependency>
  <groupId>${project.groupId}</groupId>
  <artifactId>schema-iso19115-3</artifactId>
  <version>${project.version}</version>
</dependency>

Add the module to the webapp in web/pom.xml:

<execution>
  <id>copy-schemas</id>
  <phase>process-resources</phase>
  ...
  <resource>
    <directory>${project.basedir}/../schemas/ISO19115-3/src/main/plugin</directory>
    <targetPath>${basedir}/src/main/webapp/WEB-INF/data/config/schema_plugins</targetPath>
  </resource>
  <resource>
    <directory>${project.basedir}/../schemas/GUF10/src/main/plugin</directory>
    <targetPath>${basedir}/src/main/webapp/WEB-INF/data/config/schema_plugins</targetPath>
  </resource>

Build the application.

Adding editor configuration

Once the application started, check the plugin is loaded in the admin > standard page. Then in admin > Settings, add to metadata/editor/schemaConfig the editor configuration for the schema:

"guf10":{
  "defaultTab":"default",
  "displayToolTip":false,
  "related":{
    "display":true,
    "categories":[]},
  "suggestion":{"display":true},
  "validation":{"display":true}}

Adding the conversion to the import record page

Potential further development

Formatter

  • html formatter should include schema.org/Review annotations
  • rdf formatter should include DUV annotations https://www.w3.org/TR/vocab-duv/
  • GeoNetwork UI should be able to manage GFU metadata with dedicated feedback widgets

Documentation / Translation

Community

Comments and questions to geonetwork-developers or geonetwork-users mailing lists.

Contributors

  • Paul van Genuchten (GeoCat)
  • Jose Garcia (GeoCat)

License

This project is licensed under EUPL 1.2 license https://joinup.ec.europa.eu/sites/default/files/eupl_v1.2_en.pdf Project has recieved funding from EU as part of ELISE action