ADL Workbench Help Page - Testing

User Interface

Main Window
The Tester interface consists of a table containing the archetype tree and other columns indicating test execution status, and a number of controls on the right hand side, used to manage execution of the tests.

The archetype tree is collapsible, and contains the same information as the explorer tree from the Viewer part of the application.

The second column contains check boxes used to mark an archetype for testing or not. Setting or clearing the check box of a node also sets or clears all of its child nodes. A quick way to set or clear all nodes is by clicking the check box of the Root node at the top.

The remaining columns are used to indicate the results of executing the tests, which currently include:

Parse: parse ADL file, in the same manner as the Viewer does. If the Remove Unused Codes check box on the right-hand side is selected, unused "at" and "ac" codes from the archetype ontology are removed.
Save to ADL: save the differential archetype in ADL format to .adls files.
Reparse: this test parses the result of the "Save to ADL". Passing this test indicates that the serialisation (i.e. save operation) generated valid ADL.
Diff: this test compares the original archetype file to that produced by the save-to-ADL operation.

The effect on the file system of running the tests is to create new (or overwritten) .adls files.

Tasks

Run all Tests As soon as the workbench starts up, the Go button can be used to start a full test run. The test run can be interrupted at any time by pushing the same button; it can be resumed from the same archetype by pushing the button again, and so on. The status of each test is indicated by a green "tick" or red cross in the relevant right-hand column. Any errors, or other information to do with the tests, are appended to the status window at the bottom.
Test only selected Archetypes To test only selected archetypes: Start the tool, or use the Refresh button to restore the original state Collapse the archetype tree as desired to view archetypes of interest Click the Root node's check box to uncheck all archetypes Select archetypes to be tested by checking the boxes in the second column Use the Go button to run the tests.
Remove unused Ontology codes from Archetypes Due to iterative development, some archetypes may have obsolete codes in their ontology sections. These can be deleted by checking the "Remove unused codes" checkbox and running all (or only some) tests. If the Overwrite ADL checkbox is also checked, this will cause the original ADL files to be overwritten, with the changes.
Update Languages, translations to ADL 1.4 Archetypes are converted to being ADL 1.4 compliant in saved .adls files. The changes made are: remove the primary_language and languages_available items from the 'ontology' section add an ADL 1.4-compliant 'languages' section, containing the appropriate items taken from the removed ontology items upgrade String values of language names (e.g. "en") to CODE_PHRASEs where dictated by the AOM.
Resynchronise with File System The Tester can be resynchronised at any time with the file system by pressing the Refresh button on the right hand side.