Release Notes for LiU Archetype Editor v0.5.2

Updates

New versions of the editor and more information can be found at either of these pages:

http://www.imt.liu.se/mi/ehr (Compiled and packaged for end users)
http://svn.openehr.org/liu_knowledge_tools/TRUNK/project_page.htm (Sourcecode for developers)

Important mailing lists:

In order to be notified of updates, do not forget to subscribe to the moderated low-traffic mailinglist liu-tools-announce@openehr.org
Subscribe at http://www.chime.ucl.ac.uk/mailman/listinfo/liu-tools-announce
Discussion, feature requests, bug reports etc should instead go to the open mailinglist liu-tools-discussion@openehr.org
Subscribe at http://www.chime.ucl.ac.uk/mailman/listinfo/liu-tools-discussion

Installation

Extract the ZIP-file in which the LiU Archetype Editor is packaged.
The directory you chose to extract to will contain a directory with archetypes (‘archetypes’), a Java Executable Archive file (JAR-file) and a batch-file that can be used to start up the program if double-clicking the JAR-file does not work.

To run the editor on your system you must have Java Runtime Environment 5.0 (1.5.0) or newer. Java Runtime Environment (JRE) 5.0 can be downloaded here: http://java.sun.com/j2se/1.5.0/download.jsp. If you have a fully working installation of Java Runtime Environment 5.0 or later the application will start when you double-click the JAR-file. If that does not work, you can run the program from the system console with the command ‘java -jar filename.jar’ or try double-clicking the batch-file (.bat) if you are using Windows.

General usage

The editor comes without archetypes. Download archetypes from the openEHR Clinical Knowledge Repository (http://svn.openehr.org/knowledge/project_page.htm)
In the ‘Settings’ menu, point ‘Archetype repository’ to the directory where you store downloaded and/or created archetypes. This will aid the editor when creating nested archetype structures.
Archetype terms can be looked up and bound to UMLS if you have an account at http://www.nlm.nih.gov/research/umls and you have granted your IP address in your settings for the UMLS Knowledge Source Server http://umlsks.nlm.nih.gov.
If you have granted your IP address but have problems connecting, try changing to the standard UMLS Knowledge Source Server: //umlsks.nlm.nih.gov/KSSRetriever .
The different views in the editor can be cycled through with Alt + Left/Right. Other shortcut keys are shown in the menus.
Please note that everything related to the ‘Experimental’ menu is under development and not fully working. A new version of the editor that adds more functionality to the MoST and SNOMED CT terminology services will probably be released later.

Notable limitations (also see the files todo.txt and known_bugs.txt)

Archetypes cannot be version controlled from within the archetype editor as of yet, but plans to add support for an archetype service have been discussed.
The editor has a field for archetype package URI, but it is not yet supported by third-party software.
The interface view is far from fully developed and the interface generated from some archetypes or parts of archetypes may be blank, incomplete and incomprehensive.
Demographic archetypes are not supported by the editor.

openEHR software used

The LiU Archetype Editor uses third-party software provided by openEHR. This software is often referred to as the Java reference implementation of openEHR (read more about it here: http://svn.openehr.org/ref_impl_java/TRUNK/project_page.htm). The current version of the software that the editor uses is 1.0.1-RC1 and primarily the editor uses the following components:

openehr-aom Java implementation of the Archetype Object Model (AOM)
openehr-ap Java implementation of the openEHR Archetype Profile (AP)
adl-serializer ADL serialization from AOM, AP objects
adl-parser Archetypes in ADL format to AOM, AP objects

Acknowledgements

This work was performed in the framework of the EU-funded Network of Excellence entitled Semantic Interoperability and Data Mining in Medicine (http://www.semanticmining.org).