Skip to content

FAQ

Jump to bottom
Jakob Voß edited this page Feb 11, 2022 · 4 revisions

How do I update an existing vocabulary?

First, find out which data source the vocabulary (aka concept scheme) is embedded from into your Cocoda instance. The source is shown in the vocabulary details card. Update the vocabulary in the corresponding data source or contact the maintainer of its registry to do so.

How to import new vocabularies

A detailed description in German is available here

Vocabularies need to be made available via a HTTP API to be used in Cocoda. There are several ways to do so:

  1. Convert the vocabulary into JSKOS format and import it into an instance of jskos-server. You can run your own instance of jskos-server or ask VZG to import the vocabulary into their public database.

  2. Make the vocabulary available in a system that is supported by a Cocoda provider. By now only Skosmos provider has been implemented.

  3. Implement core functionality of JSKOS API (see jskos-server) to wrap access to a vocabulary on a server. See wikidata-jskos for an example.

  4. Implement a custom Cocoda provider to wrap access to a vocabulary in the client. See Skosmos provider in cocoda-sdk for an example.

For converting into JSKOS format some tools exist, but any programming language can be used:

Please use jskos-validate to make sure the resulting data is actually
In practice each conversion may require some manual adjustment because of subtle differences in data formats. VZG may help if needed.

Clone this wiki locally