DPT manual The Tabs

From Archives Portal Europe Wiki
Revision as of 11:48, 1 August 2018 by Admin (Talk | contribs) (Validation tab)

Jump to: navigation, search

The right part of the screen contains five tabs: Summary, Validation, Conversion, Europeana conversion and Edition.

APE DPT manual, figure 34: overview of the tabs




Summary tab

The first and main tab is the Summary tab. It's opened by default when you start the tool. This is where you can apply operations to your XML files. When a file is selected in the list, you can, from this tab, convert the file to the Archives Portal Europe format, pass it to the validator or convert it to the Europeana format. You have the possibility to choose the style sheet to be used for the conversion, even - when you have uploaded one - your own style sheet. The same goes for the schemas. Please note that the action buttons and radio buttons are available only if the action is possible for the selected file.

APE DPT manual, figure 35: the Summary tab


Validation tab

The second tab is the Validation tab. In this tab you will find the results of a validation for the selected file. It can either contain a sentence saying the validation succeeded, show an error message, or a list of all the errors found during the validation process, with the indication of the lines and columns where the errors have been found. You can find in Annex 1 a list of the possible errors, their meaning and the actions to be taken to avoid them.

APE DPT manual, figure 36: the Validation tab showing an error


Please note that if you validate a file before the conversion, the lines indicated in the error report will be the ones of your original file, but if you validate a file after the conversion, the lines indicated will be the ones of the new converted file, therefore will not exactly correspond to your original file. In that case it's best to save the file to the output folder for evaluating the error message.

In case of a successful validation, a report on the data quality or completeness of the file will be displayed, indicating the number of missing or wrong information for four elements:

APE DPT manual, figure 37: the Validation tab showing a data quality report


This information also can be downloaded via the button download report of XML quality in the tab: it is saved in the report file to be found in the output folder of the tool. To save this information for several files, you have to use the same command from the File menu. You can improve the data quality of your files by editing them (see chapter 6 paragraph 5: Edition tab), or by adding rules for date conversion and by indicating the digital object type (see chapter 4 paragraph 2: Options menu).

Conversion tab

The third tab is the Conversion tab and this will display information on the transformation performed on the files and the problems encountered:

APE DPT manual, figure 38: the Conversion tab showing results


  • The tab lists the elements (and their attributes, if applicable) that are being excluded either because they are not recognised, either because they do not comply to the apeEAD profile which is more restrictive than the EAD2002.
  • The tabs also indicate the problems due to the c-element hierarchy, when a c-level is not understood.

Note that the conversion tab does not list all changes made to the file, but only the elements discarded during the conversion.

Europeana conversion tab

The fourth tab is Europeana conversion and here is displayed information on the EDM conversion. Files that are transformed into EDM format are automatically saved in the output folder (or an alternatively chosen default folder for saved files, see chapter 4 paragraph 2: Options menu). Their names stay the same with an additional "-edm" before the file extension. For more information regarding the conversion to EDM, please see chapter 7 paragraph 4: EDM conversion.

Edition tab

The last tab is Edition. When an EAD file is selected in the list, it is read and displayed in a tree like view. Some elements only can be edited, they are marked in green or blue (see figure 6):

  • eadid @mainagencycode
  • eadid @countrycode
  • eadid / text
  • langusage / language
  • langusage / language / text
  • langmaterial / language
  • langmaterial / language / text
  • unitdate@normal
  • titleproper / text
  • c @level

The eadid is mandatory to validate your file. The elements and attributes related to the language are useful for the display and refinement of the search results. The same goes for the date: a date is searchable only if normalised. An empty titleproper will be displayed as "no title".