| Table of Contents | ||||
|---|---|---|---|---|
|
Goal of the Metis Sandbox
The Metis Sandbox is a test environment for your datasets. It consists of two tools:
to get insight in your records and
preview what your records will look like on Europeana.eu.
Where to find the sandbox
The Sandbox can be accessed through https://metis-sandbox.europeana.eu/ .
How to prepare your dataset
A dataset for the Metix Sandbox can currently not exceed 1,000 records. If your dataset is bigger than you’ll see an error message. [ A future update will display a message that the first 1000 records will be used in the data archive instead of showing an error.]
...
| Note |
|---|
The Metis Sandbox is a testing environment that is under development. The Metis Sandbox also gets cleaned up at least once every two weeks. If you look for the dataset after this period, a warning message is dispalyed, eg. Dataset not found OK Http failure response for https://metis-sandbox-rest.eanadev.org/dataset/35: 400 OK As a result there is no clear indication how long a dataset stays available after uploading. Datasets that are deleted from the Metis Sandbox will need to be uploaded again for testing. |
General interface elements
There are several different methods to interact with the sandbox. Below is a list of the general interface elements and their uses.
Step indicators
...
The step indicators indicate the user’s location within the Sandbox. They behave as tab headers: clicking on a step will navigate to the corresponding section.
Navigation buttons
Navigating between the steps can also be done by using the navigation buttons.
...
The Next step button: allows you to go to the next page
Track and submit buttons
...
The Track and Submit buttons allow you to track or submit a dataset. These buttons are grey (disabled) when required information is missing in the form. The buttons become green (and clickable) when you enter correct information into the field(s) and the form can be submitted.
...
Links
...
Navigation Buttons
| Default state: the step has not been completed yet (green background), the step is not active (light / green border) and the data is not submittable (round shape) | |
| Active state: the step is active (heavy / yellow border) and the content for that step is being displayed | |
| Valid state: the form information for this step has been correctly specified (but is not yet submittable) | |
| Submittable state: the form information for this step has been correctly specified and the data is submittable | |
| Submitted state: the form information for this step is being submitted | |
| Processed state: the form information for this step has been submitted and processed (tick). The step is not active (green border) | |
| Processed and submittable state: the form information for this step has been submitted and processed (tick). The step contains valid information (orange background) that can be submitted (square shape). The step is active (heavy border) |
Home screen
The home screen gives you the option to track an existing dataset or create a new dataset. The options in the home screen are:
The menu toggle makes the different steps of the sandbox visible.
The Dataset ID bar can be used to enter the ID of a previous uploaded dataset
The Track button allows you to track the dataset entered in the dataset ID bar
The Create new dataset link can be used to start uploading a new dataset
Dataset ID
Each uploaded dataset gets a unique ID (see point 6.1 below). You will need to remember or save this ID for yourself to be able to get back to it later. Enter the dataset ID if you want to track its progress on different steps in the text field of the homepage and click on the “track” button, or to query the publish metis sandbox in a different tab/window browser
Create a new dataset
Click on “create a new dataset” on the Homepage or the Dataset Processing page. This will take you to the Dataset Name page.
Enter a Dataset Name
...
The dataset name is for you to identify the dataset yourself. A name does not have to be unique, because a unique ID is assigned to each dataset by the Sandbox. It is advised to choose a name that will make it easy for you to remember which dataset you’ve created and any details of that dataset. Spaces are not allowed in the name of the dataset.
Enter a name in the text field and click on the “Next step” button.
Enter the Dataset Details
...
In the “Dataset details” screen you need to add the details of the dataset. You will need to indicate the country and the language of the dataset from a drop down menu. The drop down menu is searchable: click on the down arrow and type the first letters of the language or country to jump to the country or language in the list. Click on the “Next step” button to go to the next step.
Configure the Data Source
...
There are two options to upload your records to the sandbox [TBC: OAI-PMH upload is not enabled currently. This functionality will support harvesting of the records, comparable to current functionality in Metis.]:
...
This field is mandatory. Zip Files are unzipped by the Sandbox. [MacOS has the tendency to add files to zip files, these extra files are automatically skipped. ]
Upload a file
...
Select the radio button left of “File upload”. A “Browse” button will appear.
Click on the “Browse” button. A pop up will appear to search for the file on your computer.
Select the file you wish to use. Click on OK in the pop up window. The Submit button will be enabled once a file has been selected.
Click the “Submit” button to start uploading the file.
...
[TBC: February 2022 update: Additional developments are in progress, such as imposing a limit of 1 terabyte per upload.]
Use HTTP Upload
Select the radio button next to “HTTP upload”. A text bar will appear.
Paste the entire url of the zipfile in the text bar, including http://.
Click on the “Submit” button to start uploading the file.
Processing and analysing
...
Processing dataset
A tracking screen will appear after uploading. The tracking screen displays
...
Green: step completed without errors, all records are considered for ingestion
Yellow: non critical warning. Problems with the records have been detected, but the records will still be considered for ingestion.
Red: critical warning. Incomplete records have been detected, these records will no longer be considered for ingestion.
View errors
...
Click on “view detail(s)” to see the details of the error message(s).
...
You can only view the information, it is not possible to make changes. You can go forward again by clicking on the corresponding icons or by using the forward arrow.
Preview records in Europeana
Click on “view preview” to view your data in a copy of the Europeana website. It can take up to 15 minutes for a preview to be generated. Please wait if your data is not showing yet.
...
Viewing Tier 0 items
It is possible that not all your items are shown in this view. Records with media Tier 0 are hidden by default. You can make these records visible by clicking on “More filters”, scroll down, click the button “Show only items not meeting our publishing criteria” and click to confirm this filter.
...