Project Organization

The project organization window consists of three sections:

• On the top, there is a list of all projects.
  If there are none, you will need to add one; otherwise the buttons are mostly greyed out.
• On the bottom left, there is a preview of the RDF representation of the selected project.
• On the bottom right, there are the buttons for the available actions to perform.
  All buttons, except adding a new project, require a project to be selected. If not, they will be greyed out.

Graphical User Interface

Project List

The project list shows the available projects.

For each projects, it displays the associated folder, the project name, shortcode and a list of associated files. It also gives indication of the status, i.e. validity of the project and the number of missing properties.

RDF Preview

The RDF preview displays a turtle serialization of the metadata of the selected project.

Actions

The following actions can be performed:

• Add new Project
  Adds a new project to the list.
  To be able to add a project, you need to know its shortcode as well as associate a folder on your local file system with it. For details, see below.
• Import Project
  Lets you import a project from binaries (see "Zip and Export") and add it to the list.
• Remove selected Project
  Removes the selected project from the list. Note: This can not be undone.
• Edit selected Project
  Opens the form for collecting metadata.
• Validate selected Project
  Validates the selected project against the ontology.
• Export selected Project as RDF
  Exports the selected project metadata as Turtle, RDF/XML and JSON-LD.
  The files are stored in the folder associated with the project.
• Zip and Export Project
  This action creates a Zip archive, containing all the files associated with the project, RDF serializations of the metadata, and a binary serialization of the project for reimport into this tool.

Concepts

Project Shortcode

The project shortcode is a four digit hexadecimal number that is assigned by the DaSCH to each project on the DSP.

To be able to add a project to the list, you need to enter the shortcode.

The shortcode can not be altered after the project has been created. Be sure to have the shortcode ready at hand when you want to add a new project. If you do not have a a shortcode for your project yet, please get in touch with the DaSCH Client Services.

Folder and Files

Folder

When adding a new project, after entering the project shortcode, you need to select a folder of your local file system, that is associated with the project.

Note: Do not move or remove that folder, it might cause you to lose all data related to this project - or in the worst case, cause the tool to crash.

This folder must hold all files you want to associate with the project. It is also where the RDF is exported to.

Files

If you not only want to submit project metadata, but also primary project data with it (e.g. like this is done on Zenodo), this data should come in the simplest possible form. Ideally, all data should be combined into one ZIP archive.

When creating a project and associating the folder with it, all files in this folder are automatically associated with the project. However, files can be added or removed at any time in the project base data, provided that the files are in the folder.

Local Data Storage

The metadata tool stores all data (except data you export) as binary data in the file ~/DaSCH/config/repos.data.

If you want to back up your working data, be sure to make backups of this file as well as all folders you associated with projects.

Deleting this file will remove all projects and cause irreversible loss of all data you have entered.

When the tool has a major update with breaking changes to the API, you will need to delete this file manually.