dataverse-controlledvocabulary

Controlled vocabulary used by the CDSP.

Dataverse metadata blocks

We created custom TSV files following the CESSDA Metadata Model.

Borschewski, Kerrin, Hermann, Julia, Zenk-Möltgen, Wolfgang, Bockaj, Brigita, Bolko, Irena, Vipavc Brvar, Irena, … Bell, Darren. (2019). CMM CESSDA Metadata Model (Version 0.1). Zenodo.

We consulted also this Metadata Crosswalk: The Dataverse Project. (2020, February). Dataverse 4.0+ Metadata Crosswalk. https://docs.google.com/spreadsheets/d/10Luzti7svVTVKTA-px27oq3RxCUM-QbiTkm8iMd5C54

Fields added or modified (<cessda_field> → <dataverse_field>)

citation.tsv:

• KindOfData → kindOfDataType
• TopicClassification → topicClassValue

social_science.tsv:

• AnalysisUnit → unitOfAnalysis
• ModeOfCollection → collectionMode
• SamplingProcedure → samplingProcedure
• TimeMethod → timeMethod
• TypeOfInstrument → researchInstrument

We also changed the geospacial.tsv file to update country values using ISO 3166. We needed to update the values in two steps:

1. geospatial_0.tsv adds the IDs to each value
2. geospatial.tsv updates the values

Translation

The script create-properties.py is used to generate dataverse properties from a CSV containing controlled vocabulary with their translation (see controlled_vocabulary.csv). These properties need to be added to the corresponding property files in the languages.zip (https://guides.dataverse.org/en/latest/installation/config.html#creating-a-languages-zip-file).

The script edit-properties.py is used to update old languages.zip properties packages to new version of Dataverse:

1. unzip the latest languages.zip available in a folder
2. get the latest property files corresponding to the version targeted (switch branch/tag)
3. python3 edit-properties.py -n CUSTOM_PROP_FOLDER NEW_DV_FILES -c -w this will check for new properties and add them to the old ones (you may have to run this command multiples times if new files are created for example)
4. python3 edit-properties.py -t CUSTOM_PROP_FOLDER NEW_DV_FILES -c -w this will check for missing translations and add them without values (you may not want to use the -w / -c flags here if you don't intend to translate everything)
5. zip -j languages_TAG.zip CUSTOM_PROP_FOLDER/*.properties