...
The input fields are the white boxes where information must be entered by you. The description above the input field states what information should be entered. Every input field comes with a possible input example. Each field is mandatory.
...
4.2.2 Buttons
The radio buttons are used to select the upload method to upload EDM metadata records through OAI-PMH or file upload and to download the resulting manifests and enriched EDM data:
...
…or to refresh your harvesting results.
...
5 Upload a new dataset
The EDM2IIIF Manifest Creation tool was implemented as an open web service. Therefore it is not possible yet to create a user account (this may be implemented in v02). When uploading your EDM metadata records you have to make sure to choose a unique name for the upload. If the name already exists, you will be requested to confirm the override of the previous set. Please try not to delete other uploads by choosing the same name.
...
5.1 Data input
This screen allows you to start accessing the EDM2IIIF Manifest Creation tool. Here you can track existing data or initiate a new upload. The “Upload Data” form looks like shown in the figure below and can at the same time be used to track or later download a previous dataset.
...
Dataset Name Input: used to enter the unique name of a new dataset you want to create or a previously uploaded dataset you want to track.
Base URL for images: used to enter the base URL for your IIIF images.
Base URL for manifests: used to enter the base URL where you want to store your resulting IIIF manifests.
OAI-PMH upload: this box opens an input field for your OAI-PMH link.
File upload: this box opens an input field for uploading your EDM records via zip file.
Track dataset: this box enables tracking the status as well as downloading the created manifests and enriched EDM records.
First, enter a descriptive name for your dataset in the input field “Name”. The next step is to set the base URLs (where they are/will be located) for both the IIIF images and the IIIF manifests. We suggest taking the pre-filled URLs as an example.
The next step is to determine the “Harvest protocol”: how you want to upload your dataset. This is described in detail below. The “Submit” button at the bottom will be enabled when all information is filled in.
5.2 The harvest protocol
There are two ways to upload your datasets to the EDM2IIIF Manifest Creation tool:
OAI-PMH upload: Ingestion with OAI-PMH
File upload: upload a zip file
The “Submit” button will become enabled once you have filled all fields. Click the “Submit” button to upload your dataset. To track and download your data, see chapter 6.
If the upload has been successful, a green information window will appear (see following paragraphs).
5.2.1 OAI-PMH
To use the harvesting protocol OAI-PMH, you should enter an URL for harvesting your data. The URL of your OAI-PMH should look like this:
...
For more details on the appearance of the URL, please see the OAI-PMH specifications.
If the upload of your data was successful, the following message appears:
...
5.2.2 Zip file
This option allows you to upload a zip file with an EDM dataset (xml files) that is stored locally. Click on “Durchsuchen” (or “Search”; depending on the language setting on your computer) and choose the zip file with your data. It is important to know that only files with the ending .zip can be uploaded successfully.
...
If the upload of your data was successful, the following message appears:
...
6 Track dataset processing
After successfully submitting your dataset to be processed, the status can be checked in the following steps:
Enter dataset name
Choose Track/download harvested dataset as harvest protocol
Click the Submit button
As a result of the above steps, the new page with the harvest details will be opened. The following figure shows what the resulting page looks like. While the process is not completed, the "Refresh" button is enabled in the "Results" column.
...
When the process of data harvest is complete, the "Download" button becomes available (see figure below), which allows to download the resulting manifests, the enriched EDMs and the log.json file, with all of them compressed into a zip file.
...
The log.json file can also be downloaded from the "Process Info" column at any time so that you know what is happening with the processing of the records. More details about this file are provided in the next chapter.