Skip to content

Dataverse 5.1.1 with external controlled vocabularies

Compare
Choose a tag to compare
@4tikhonov 4tikhonov released this 14 Oct 19:05
· 189 commits to master since this release

This Dataverse v.5.1.1 release works with Semantic Gateway that supports ontologies provided by NDE, SKOSMOS and SPARQL endpoints. This functionality was developed by Data Archiving and Networked Services (DANS-KNAW) and funded by Social Sciences and Humanities Open Cloud (SSHOC) project.

Installation

If this is a new installation, please see Dataverse Installation Guide http://guides.dataverse.org/en/5.1.1/installation/

Upgrade Instructions

These instructions assume that you've already successfully upgraded to Dataverse 5.1 following the instructions in the Dataverse 5.1 Release Notes.

Undeploy the previous version.

<payara install path>/bin/asadmin list-applications
<payara install path>/bin/asadmin undeploy dataverse<-version>

Stop payara and remove the generated directory, start:
service payara stop

  • remove the generated directory:
    rm -rf <payara install path>/payara/domains/domain1/generated
    service payara start

  • Deploy this version.
    <payara install path>/bin/asadmin deploy dataverse-5.1.1.war

  • Restart payara

Configuration

Download configuration files and apply sql statements to update Dataverse database and change the order of the metadata fields linked to controlled vocabularies. It should be Vocabulary, Term, VocabularyURI:
psql dvndb -f cv-update.sql
Warning: dvndb is postgresql database, it can be different in your installation.

Download and update controlled vocabularies supported by Dataverse:
curl -H "Content-Type: application/json" -X PUT --data-binary @cv-keywords.json localhost:8080/api/admin/settings/:CVMConf

How to test controlled vocabularies support

You'll get "keyword" and "topicClassification" fields linked to the middleware service called Semantic Gateway https://github.com/Dans-labs/semantic-gateway. The default list of available controlled vocabularies can be easily extended:

  • Unesco
  • Wikidata
  • MeSH (Medical Subject Headings)
  • Thesaurus (INRAE, Paris)
  • IPTC (International Press Telecommunications Council)
  • Agrovoc (controlled vocabulary of the Food and Agriculture Organization (FAO) of the United Nations)
  • Fächersystematik (Fächersystematik Hochschulbildung in Deutschland)