Loading...
 

MINT end-user documentation

MINT Mapping Tool

  • Provides users the ability to perform a mapping of their own metadata schemas to reference domain models (In our case LIDO and EDM)
  • Follows a typical web based architecture
  • It was developed for ATHENA, but it is currently used for EUScreen, Europeana Fashion, CARARE, Judaica, ECLAP, DCA, Linked Heritage and other Europeana Aggregation projects


The User manual is divided in four (4) sections

  • User administration
  • Import of metadata
  • Mapping
  • Transformation – Publication to Europeana


1. USER ADMINISTRATION

The very first step that each provider has to make is to register himself/herself and also his/her institution – organization to the MINT mapping tool

1.1. User Registration

User Registration can be done in two ways

  • Self-registration from MINT Mapping Tool – The user registers directly
  • User creation under an organization by its administrator- The organization΄s administrator creates an account for a user
  • User registration without an organization
  • User registration under an existing organization
  • User management (&User creation under an organization by his administrator)
  • Organization Registration & Management

1.2. Self-registration from MINT Mapping Tool

Users can register and access the services at

Image


  • Fill in the form and click on “Submit”

Image



Leave the selected organization blank, you can register and then create an organization. The system will define you as Administrator (This user can create/update/delete users and children organizations for the organization he is administrating)

  • By clicking on the name of the user from the administration pane user΄s info is showing up

Image

VIDEO FOLLOWS

2. Create new Organization

  • After registering without an organization you logged in to MINT.

Image



On the left, under the pane MINT Home -that is the central functionality pane of MINT mapping tool- the following options appear

  • My workspace – By selecting it you can manage your imports. At this point it is not activated because you are registered under no organization, and therefore the creation of an organization is first required.
  • My account – By selecting it you can edit your account details.
  • Administration – By selecting it you can create an organization and users that work for it.
  • Locks – By selecting it you can unlock mappings locked by other users. Not available at this point
  • Mint Documentation – By selecting it you are directed to the MINT documentation page.
  • Clicking on “Administration” from MINT start page and then by selecting “Create new organization”

Image

  • Fill in the form and click on “Submit”

Image

VIDEO FOLLOWS

::

::

3. Create Children Organizations

An organization can have an hierarchical, tree like structure. Each organization can have sub organizations, each sub organization can have further sub-organizations

  • Βy clicking on “Administration” menu from MINT start page and then by selecting “Create new organization”, if a children organization exists
  • Create a new organization and this time set the parent organization

Image


  • set the parent organization and click on “ Submit”

Image

VIDEO FOLLOWS

4. Create new user for Parent organization (by its administrator)

For creating a new user or activating a user registered for the organization the administrator is logging on the MINT Mapping tool

  • Βy clicking on “Administration” menu from MINT start page and then by selecting “Create new user” ,

Image


  • Fill in the form and click on “Submit

Image



Note that the administrator has to Select the Organization, and set System Role from the drop-down list.

Image

Image

VIDEO FOLLOWS

5. User Registration Under Organization (Childern Organization)

A new User under organization can register at

Image


  • Fill in the form, select organization and click on “Submit”



Image

VIDEO FOLLOWS

6. Rights Assignment to user by Administrator

  • The administrator has to assign rights to users
  • Βy clicking on “Administration” menu from MINT start page, select the name of the user, click “edit” and choose the appropriate role

Image

A User can have one of the following roles

  • Administrator: This user can create/update/delete users and children organizations for the organization he is administering.
  • Annotator & Publisher: This user has all the rights of an annotator as well as rights to perform final publishing of data.
  • Annotator: This user can upload data for his/her organization (and any children organizations) and perform all available data handling functions (view items, delete items, mappings etc) provided by the system, apart from final publishing of data.
  • Data Viewer: This user only has viewing rights for his organization
  • No role: A user that has registered for an organization but has not yet been assigned any rights.

Image

An Administrator can delete or edit an existing organization by selecting it and pressing the ‘Delete’ or Edit "button"

Image

VIDEO FOLLOWS

7. Metadata Import

To import your metadata to the MINT mapping tool, you have to log in and select My Workspace from the MINT Home pane. Note that your role must have been assigned to Annotator or Annotator & Publisher or Administrator otherwise this option will not appear.

  • Select “My workspace” menu from MINT start page, “Import new archive” to import your metadata. Note that if you have access to more than one organizations, you need to specify for which organization you are performing the upload by selecting it from the drop down list.

Image

  • Click on “Upload file” Image

Image


Different upload protocols are supported Different upload protocols are supported.

a. HTTP Upload

Click "Upload a file" button and select the file containing your data. You can upload XML, CSV files or zip files containing XML files. Note that if you upload a CSV file, you have to tick on “This is a CSV upload” check box and specify the delimiter as shown in the figure below. It is also important to note at this point that only UTF-8 encoding is supported.



IMPORTANT NOTE: Every import that has at least one file is considered as a new upload of metadata and handled in the same way as if it had more than one. For this reason it is recommended to use zip archives with many XML or CSV files compressed and limit the ingestion of single XML or CSV files only for testing purposes.

b. Remote FTP/HTTP Upload

You can upload a file from a remote FTP/HTTP location. Useful when your files are available already on a remote server.

c. OAI URL

The MINT ingestion tool has an integrated OAI-PMH V2 harvester, which can be used to access data stored in a remote server that supports this protocol. You have to fill in the base URL of the OAI-PMH repository and then click on the Image button next to it in order to check its validity. You can also fetch data based on a specific date interval as it is defined by the OAI-PMH protocol. Finally, you can fetch the OAI-PMH sets and namespaces that the remote repository supports and choose from them the set and type of metadata you wish to import.

  • Import the file containing your data either via local upload, or via Remote FTP/ΗTTP , OAI URL upload and click ‘submit”

Image

  • By selecting on the uploaded file from “My workspace” view the “Dataset Options”
  • After importing a file to MINT Ingestion platform it can be viewed in “My Workspace menu” either with a green Image tick that indicates that the import was successful or with a red Image that indicates a problem during upload

::
Image

7.1. Wrong import

  • By selecting an unsuccessful import you can get feedback on the error occurred by clicking on the Show Log

Image

The Define Items and Dataset Statistics options appear but they don’t work since the import was not successful and the user that encounters this situation is suggested to click on Delete Data Upload to delete the Upload.

VIDEO FOLLOWS


8. Define Items

By clicking on ‘Define Items’ the user can set

  • the item level of your import (root item)
  • The item label of your import (title)
  • The identifier of your import

Image

by dragging and dropping the appropriate elements to the appropriate textboxes. On the right part of the panel there is a tree representing the structure of the XML file(s) you have imported. Items with a "+" on the left can be expanded, while items with a "-" can be collapsed.

Image


By clicking on the information icon ( Image ) on the left of each node you get information and statistics about the value of the node.

Image

Note that on the top of the tree there is a text field that can be used to search the tree structure of the XML file(s) you have imported. You have to set the following.

  • Item Level - Define the root node of every item. Drag & drop a node from the tree to the left in the box below, to set the item level.
  • Item Label - Define the label that will be used as the Item name in the Item Overview. Drag & drop a node from the tree to the left in the box below, to set the item label.
  • Item Id - Define the node that will be used as the Item native id. Drag & drop a node from the tree to the left in the box below, to set the item id. After setting the above click on “Done”

Image


After having defined the items the following options appear in the “Dataset Options” pane.

Image


VIDEO FOLLOWS


9. Dataset Statistics

After having defined the items by selecting ‘Show items’ you can view the items you have uploaded

Image

  • By clicking on the question mark ? the user can get definitions


Image



Image



After having defined the Items

  • By selecting “Data Statistics” users can see all the metadata elements of the imported dataset.
  • by clicking on an element users can view its values.
  • Elements with unique values are colored with green color

Image

In detail you can see all the xpaths of the imported dataset together with their distinct values count and the average length of their values, while by clicking on an element you can browse its values.

In the following screenshot we see the “title element”. In similar manner we can view the values of all metadata elements. Moreover, additional information is provided i.e. XPath, Namespace URI, count, Distinct count, Average length. In the example belowcount and distinct count have same values which means that this element has unique values.



Image