CSV Import

CSV Import¶

A Metadata import task can only be started from an existing .csv file on your system. Whether the CSV file contains a header or not does not matter. Each "csv" row will result in a presentation property. Each row must have exactly 6 fields in the following exact order: target entity, property name, label id, language, label name and the value.

Warning

An entry will be overridden if a new imported entry has the same target, property name, label id and language!

Target Entity Field¶

The target entity field must not be empty. The possible values are "Root" which targets the root project's collection, the name or the id (uuid) of a IIIFResource entity. IIIFResource entities are the following: Project, Collections, Sequences and Images. The name of a IIIFResource entity can be retrieved directly from the "show" interface.

Warning

Projects are IIIFResource entites, however metadata import is yet not available.

Property Name Field¶

The name of the presentation property to be added. Every property must have a non-blank name field. To ensure consistency the allowed property name field values are predetermined, namely: navdate, thumbnail, viewingHint, logo, description, attribution, license, label, metadata and viewingDirection. See also Which metadata can be imported?

Label Id Field¶

The label identifier of the property to be added. Properties may need a label id. Label Ids are used to group properties which need translations for label names. For example: The metadata property, which always need all field to not be blank should be specified, for the root collection would need be redacted in the .csv file for german and english translations in the following fashion:

Root, metadata, writer_label_id, de, Schriftsteller, Goethe Root, metadata, writer_label_id, en, Writer, Goethe

This allows the redactor to add multiple translations for the value and label name fields by matching the property's label id. All properties which require a label id field also require the language the label name fields to not be blank. The properties (Property Name) which require the label id field to not be blank are: metadata.

Language Field¶

The language abbreviation of the value or/and the label name field. Properties may need a language field. Properties which do not need/allow for the language field to be added exist only once (are thus unique) for the whole IIIFRessource and no additional translation can be added.

The properties (Property Name) which require a language value are: thumbnail, viewingHint, logo, description, attribution, license, label and metadata. The properties (Property Name) which do not allow for a language are: navdate and viewingDirection.

Label Name Field¶

The translated label name of the property to be added. Every property (Propert Name) which requires a label id field also requires the label name field to not be blank. See Label Id Field to find an example of how to redact label name translations.

The properties (Property Name) which require the label name field to not be blank are: metadata.

Value Field¶

The value of the presentation property to be added. This entry must not be blank for every presentation property added. The value field can represent a translation, if the language field is required, otherwise it represents a unique value.

Example CSV¶

Here ist an example of a CSV file to import the following metadata:

on collection level add information about license and rights holder into properties "license" and "attribution"
on sequence level add information about year and description in properties "metadata" and "description".

And a tabular view on the same example:

Visualize Metadata¶

At the bottom of each IIIFResource View page, you can find all the properties belonging to the IIIFResource entity.

Property entries with no translations ad no label translations are displayed in a single line:

Property entries with multiple translations are displayed with an "eye" icon:

To see all entries (redacted translations), click on the "eye" icon and all translations will be displayed:

For nested presentation properties, which also required a translated label, you can click first on the "eye" icon to display all labels:

Subsequently click on the "eye" icon at the right of the desired label in order to visualize its translations: