Making DMP Tools Actionable
As part of Data Stewardship 2019 lecture this tools allows to extract machine-actionable DMPs (maDMPs) from RDMO, a popular tool for managing DMPs.
This tool is licensed under the MIT License.
Copyright © 2019 Gerald Weber, Helmuth Breitenfellner
RDMO XML to RDA DMP Common Standard Converter
RDMO is a very handy tool to support the planning of data management in research projects.
The RDA DMP Common Standard defines a unified interface for the exchange of DMPs between different systems, allowing automation of steps required in a DMP.
This tool tries to bring the two together. It allows to export the DMP created in RDMO in a JSON file, compliant to the RDA DMP Common Standard Specification.
Mapping of Questions to maDMP JSON fields, JSON examples
RDMO uses its own datamodel (based on attributes) which is aimed at being a generic representation of questions arising in a Data Management Plan. In that way it is very similar to the RDA DMP Common Standard, except that it does not define an exchange format for interoperability with other tools, including possible automation systems.
A questionaire (as for example the questionaire for Horizon 2020 or FWF which we have created as an addition to RDMO) is mapping questions to these attributes.
A view (as for example the existing Horizon 2020 view which we adjusted, and the new FWF view which we have created as an addition to RDMO) is then mapping the attributes to some output fields.
Due to this architecture, this tool is mapping the attributes to output fields in the RDA DMP Common Standard JSON format. The mapping of fields is fully described in field mapping.
Some examples of the mapping:
- DMP 1 - FWF Template (PDF)
- DMP 1 - RDMO Export (XML)
- DMP 1 - RDA DMP Common Standard (JSON)
- DMP 2 - Horizon 2020 Template (PDF)
- DMP 2 - RDMO Export (XML)
- DMP 2 - RDA DMP Common Standard (JSON)
- DMP 3 - FWF Template (PDF)
- DMP 3 - RDMO Export (XML)
- DMP 3 - RDA DMP Common Standard (JSON)
- DMP 4 - Horizon 2020 Template (PDF)
- DMP 4 - RDMO Export (XML)
- DMP 4 - RDA DMP Common Standard (JSON)
Installation
This is a command-line based tool which is written in Python. It converts an XML export from RDMO into a RDA DMP Common Standard compliant JSON-encoded machine-actionable DMP.
To install the tool, the following steps are required:
- Download the script
- Install Prerequisites
Download the Script
It is sufficient to download the script xml2madmp.py.
No further files are needed.
Install Prerequisites
The script uses Python 3. It has been tested with version 3.6 and 3.7.
By default, all needed libraries are installed on a regular Python 3 installation.
Usage
Export the XML from RDMO
For each project, RDMO is showing an export link which will export the project as an XML file.
Export the project as XML using this link and save it to the file system.
Convert into maDMP
To convert the exported XML file, enter the following command on the command line:
python3 xml2madmp.py <rdmo-export.xml> <output-madmp.json>