View source for DPT manual The Tabs

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

[[File:APE_DPT_manual_34.png|400px|thumb|left|APE DPT manual, figure 34: overview of the tabs]]
<br clear=all>
<div><br/>__TOC__<br/></div>
== 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 - [[DPT_manual_The_Menus#Use_own_stylesheet|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.

[[File:APE_DPT_manual_35.png|400px|thumb|left|APE DPT manual, figure 35: the Summary tab]]
<br clear=all>

== 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 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 the 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.

Besides, 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:

----- Data quality -----
Missing content for title information (unittitle): 0
Missing normalised date information (unitdate@normal): 0
Missing information on digital object type (dao@xlink:role): 0
Wrong information on digital object link (dao@xlink:href):0

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 Conversion and here is displayed information on the transformation operated on the files and the problems encountered:

* 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.

Please 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".

[[Category:Tools_DPT_manual]]