Skip to content

Experimental Dataverse 5.2 with SKOSMOS protocol for external controlled vocabularies
Compare
Choose a tag to compare
@4tikhonov 4tikhonov released this 11 Nov 21:44
· 180 commits to master since this release
5.2-cv
5ceab0f
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

This Dataverse v.5.2 release uses SKOSMOS as default protocol and supports ontologies provided by SKOSMOS and CESSDA Controlled Vocabulary Service. The functionality was developed by Data Archiving and Networked Services (DANS-KNAW) and funded by Social Sciences and Humanities Open Cloud (SSHOC) project.

Warning: it has experimental status as this functionality isn't merged to the master branch and intended for the testing purposes!

Installation

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

Upgrade Instructions

These instructions assume that you've already successfully upgraded to Dataverse 5.1 following the instructions in the Dataverse 5.2 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.2-cv.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 SKOS (Simple Knowledge Organization System) framework called SKOSMOS http://skosmos.org. By default Dataverse uses its protocol to connect to any SKOSMOS API and can do lookup for the suggested terms in the selected ontologies. The specification of the protocol available in SKOSMOS API https://api.finto.fi/doc/.

If you need to support another protocol, DANS-KNAW has developed a simple middleware service called Semantic Gateway https://github.com/Dans-labs/semantic-gateway. The default list of available controlled vocabularies can be easily extended with other ontologies:

  • 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)
Assets 7
Loading