Import and define

Mapping and Preview



Manage mappings




Why can’t I find my organization in Mint. Can you create an organization for me?

At the login screen, a new user can click register.  At the registration form, the user can choose not to join any of the existing organizations. After login, the new user can create the new organization in the administration tab by providing some details about the new organization.

Import and Define

Can I import .rar files?

A user can import  .xml file or .csv and .tgz, .tar.gz, .zip.  The idea is to try to upload a zip or tgz containing a lot of similar xml files and then try to create only one mapping to transform the whole dataset at once.

After importing a dataset in csv format, there is an issue with the encoding of some records; more specifically “?” appears in many cases.

When uploading a csv file, it should be encoded in utf8.

I successfully imported a dataset in Mint, what to I do next?

The next step would be to click on Define Items, where you must define the items for the data upload you have made. In general,  the steps would be to create or use an existing mapping and transform the items.

After importing my dataset I clicked on Define Items but I don’t know what items to define?

Defining items consists of the following procedure:

Defining by drag and drop the following items (1 and 3 are mandatory):

  1. item level is the xml element under which, the metadata items reside.
  2. item label is the xml element, containing the name of each item.
  3. item id is an xml element where a unique value, that identifies the elements, resides.

Mint might show a warning about the selected value if it si not actually a unique identifier of the dataset. Even though it is accepted , this means that some items whose specific element value is missing or it is not distinct, will not be accounted-defined.
A user can see statistics about every element and its values by clicking on the icon Information-icon-150x150   next to every element at the tree view on the left.

Mapping and Preview

How can I see what mappings are mandatory for the target schema I am mapping to?

During mapping you can click on Navigation and then click on the red icon. This will show mappings that are mandatory. Also by clicking Preview, you can preview the item before the actual transformation.

While creating a mapping preview does not show up?-Can’t access the preview?

In order to activate the mapping preview follow this two steps:
While on the mapping editor click on Preview and under the Preview options on the left:

  • in the panel called “Select item views for the first and second column”: select a value, for example “import item” on the first column (optionally at this point you can  select “transformed item” on the second column, as this will be useful)
  •  click on remember selected views.

After this the preview will be working as expected, and by selecting an item from the list on the left,  Preview will show up.  It is a bug in our code and we will fix it soon.

How to use Preview while at the mapping editor?

To enable preview see the above question. While in the Preview screen, looking at the transformed item, all errors will be highlighted in red.  Also if you hover the mouse over these error lines you will get a description error.

The mapping I’m trying to use is locked although there are no locks set in the locks view?

In the locks view a user can see only his own locks, and the mapping is locked by another user.


I have imported a dataset, defined items but I can’t transform, why?

While at the upload screen, during the import, make sure you have NOT selected “this import conforms” (to a specified schema) choice, if the imported dataset schema does not conform to any of the predefined schemas. This choice affects the Mint workflow.

 I get error messages during transformation, what can I do?

The mapping needs further editing. Next step will be to have a look  at the transformed invalid items, either by downloading the transformed invalid items; or most preferably by using Preview at  the mapping editor.

Is there a way to validate the mapping before actually transforming?

Yes, by using Preview at the mapping editor.

Transforming a dataset shows the message: “java.lang.Exception: No item was validated”.What does it mean?

The imported  dataset under transformation does not have properly defined items, thus no items can be produced during transformation.


Why are  my published datasets in More platform and the published item counts not as expected?- What  the publish to More button actually does?

Every time you publish a dataset to More, Mint builds a union set of all your published datasets and sends them to More. If you publish 4 datasets, first you essentially send only one, then two together, then three together and finally 4 together to More.

There are various ways how the item count of the final thing deviates from the initial item count. Illegal records, duplications (software errors?). If you access the log of one the published datasets, it might say something about the actual published item count.

Why the “Publish to More” option is not showing up?

Most likely the transformation, that took place did not produce a dataset that conforms to the publication schema or its specific version set  up for publication.

Manage mappings

I just deleted a transformation, why is transformation still appearing?

A user can make multiple transformations on the same dataset with the same, maybe edited,  mapping. The list of transformations always shows the latest transformation that took place. Thus, if deleted  once and an older transformation exists, it actually replaces the deleted one, like rolling back. A user trying to delete a transformation might be needed to delete more than one transformations actually as deleting only deletes the latest one.

I just deleted a mapping. Why is it still appearing in the recent mappings list?

The panel that shows the mapping list needs to be reloaded by clicking on the refresh icon of the panel.


What does the “Element edm:isShownAt should not have both rdf:resource attribute and text value populated “ means?

It means the  schema expects an attribute value in this element, for example:  <edm:isShownAt rdf:resource=”http://urtegaard.no/“/>