Orpheus Instituut - Resounding Libraries

Repository for the Resounding Libraries research cluster at Orpheus Instituut.

Credentials

After cloning this repository, you should create a credentials folder to store all your sensible data. All credentials are stored in credentials.json file in this form:

{
	"koha": {
		"oauth_credentials": {
    	"description": "username",
    	"client_id": "clientid generated by Koha",
    	"secret_key": "secret key generated by Koha"
		},
	"basic_credentials": {
    	"user": "user@email.com",
    	"password": "password"
		}

	},
	"resourcespace": {
		"rs_api_url": "https://your.rs.domain/api/v1/",
		"secret_key": "secret key" 
	},

	"orcid": {
    "client_id": "xxx",
    "client_secret": "yyyy",
    "redirect_uri": "https://example.org"
}
}

ResourceSpace

Resourcespace is an open source digital assets management system.

In the folder resourcespace you can find some useful Python scripts to dynamically interact with your Resourcespace instance. Metadata for each record are pulled through Koha and ingested to Resource Space fields, collections and resources.

Pipeline

Koha

This folder collects a series of Python scripts, build upon pyMARC, to allow batch operation for your library catalogue, Koha API and other mappings useful for enriching metadata with external, linked open data information.

Pipeline

• Koha reports enhancement to JSON.
• MARC authorities and biblioitems conversion to JSON.
• MARC abbreviations conversion.
• ...

ORCID

ORCID is a non-profit organization that provides a persistent digital identifier (an ORCID iD) that distinguishes you from every other researcher. Since 2023, Orpheus Instituut registers the research output of its members through the Koha catalogue. Each research output is stored as record and a plugin has been developed to batch export the data to FRIS.

In the folder orcid you can find some useful Python scripts, build upon pyOrcidto dynamically interact with your ORCID instance.

Pipeline

• Connect researchers' ORCID records to Koha via API
• [ x ] Generate a mapping between MARC fields and BibTex
• Import Koha research output records back to ORCID

TO-DO

• [ x ] Connect to ORCID API
• [ x ] Try mapping in YAML between MARC fields and BibTex. No 1-1 relations...
• [ x ] Import ORCID ID works as JSON from API
• Create a script for more reliable mapping between MARC and BibTex
• Get research output records form Koha (API,report,batch import)
• Convert records to BibTex and send them to ORCID.