Page History

Loading of Entities and Fields

OpenAIRE4 features depends on Entities the entities feature on DSpace 7 and it's based on a set of configurations. In order to have your repository compliant with OpenAIRE4 guidelines you need to follow some steps:

The default submission-forms.xml file configures the form fields that allow the creation of the specific OpenAIRE entities and their relationships. In order to use those forms you need to configure your item-submission.xml and add these to the <submission-map>:

<name-map collection-handle="123456789/2" submission-name="openAIREPublicationSubmission" />
<name-map collection-handle="123456789/3" submission-name="openAIREPersonSubmission" />
<name-map collection-handle="123456789/5" submission-name="openAIREProjectSubmission" />
<name-map collection-handle="123456789/4" submission-name="openAIREOrganizationSubmission" />

Please note that my collection-handle="123456789/4" will be different in your system and it refers to the collection that will gather a specific Entity type like Publications, Persons, Projects or Organizations.

To load OpenAIRE Entities model you must firstly run the following:

[/dspace]/bin/dspace initialize-entities -f [/dspace]/config/registries/openaire4-relationships.xml

 and load the required fields

[/dspace]/bin/dspace registry-loader -metadata [/dspace]/config/registries/openaire4-types.xml
[/dspace]/bin/dspace registry-loader -metadata [/dspace]/config/registries/datacite-types.xml

After those steps your repository will have the required fields and entities for the compliancy.

OAI interface

As decided in our Entities meeting (2019-11-19 DSpace 7 Entities WG Meeting), the XOAI Default Context should only display Publications or non Entity Items. For OpenAIRE4 it will also be considered only Publications as the main Entity to be processed and all the related ones will be loaded in the process.

OpenAIRE4 is accessible in a specific OAI context through the URL:
http://[dspace-server-url]/oai/openaire4?verb=ListRecords&metadataPrefix=oai_openaire

in order to use it, you must first ensure you have the oai.cfg setting uncommented:
oai.enabled = true
(NOTE: you may need to restart your tomcat service)

If you need to display additional metadata at the oai_openaire metadata format, you could rename the file:

[/dspace/]config/spring/api/virtual-metadata.xml.openaire 

and replace it with the existing one:

 [/dspace/]config/spring/api/virtual-metadata.xml 

Please note if you do this you should restart your tomcat service container.

This additional virtual metadata will enable to represent something like this in this XML in the oai_openaire metadata format, where you have, for instance, author identifiers:

<datacite:creators>
  <datacite:creator>
    <datacite:creatorName>Evans, R.J.</datacite:creatorName>
    <datacite:affiliation>Institute of Science and Technology</datacite:affiliation>
    <datacite:nameIdentifier nameIdentifierScheme="ORCID"
                    schemeURI="http://orcid.org">
      1234-1234-1234-1234
    </datacite:nameIdentifier>
  </datacite:creator>
</datacite:creators>

Then you may need to run the OAI import from the command line with the cleaning cache parameter to reload all data to OAI:
 [/dspace/]/bin/dspace oai import -c