DPT manual The Tabs
The right part of the screen contains five tabs: Summary, Validation, Conversion, Europeana conversion and Edition.
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.
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.
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 of a finding aid, a report on the data quality or completeness of the file will be displayed, indicating the number of missing or wrong information for four EAD elements:
- Missing content for title information (unittitle)
- Missing normalised date information (unitdate@normal)
- Missing information on digital object type (dao@xlink:role)
- Wrong information on digital object link (dao@xlink:href)
This information also can be downloaded via the button Download report of XML QUALITY in the tab: it is saved in the report file which can 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 or by adding rules for date conversion and by indicating the digital object type.
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:
- For finding aids 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".
