Harmonization Editor Manual (Installation)
The installation of all HL7 applications, and the preparation of the underlying operating environment is documented by the Tooling Committee in Installing and Configuring HL7 Tools.
Go to Vocabulary Tool installation instructions to find the installer and begin the installation
This section of the application manual simply points out the steps and then links to the relevant sections of the installation document.
Install Java Runtime
The Harmonization Editor is a Java-based tool that executes in the Eclipse platform. However, the Eclipse platform does not need to be installed as the Harmonization Editor installer installs a "runtime" version of the platform.
To find and install the latest Java runtime environment (JRE) see the installation instructions in the reference file.
The basic installation instructions are found in the installation resource file, but that file does not show the selection screens that appear as the installation proceeds. Once the user 'double-clicks the self-installing JAR file, the installation dialog windows appear in the following sequence. The captions identify the screen shot, and some figures have textual comments below them.
|Select "I agree..." radio button to enable "Next" button.||Note WindowsXP default is |
|Note This selection screen was dysfunctional, and hence was dropped. Instead, see the notes in the new version of the "final" screen below, as well as the hyper-link provided there.|
|Once the installation progress is complete, the Next button will be enabled.|
|As noted, the storage directory for Change Proposal XML files can be changed after installation. Go to Setting file preferences to change this.|
Setting File Preferences
Th location in which the application looks for and saves change proposal files can be changed through the Eclipse Preferences dialog.
Within the Preferences dialog (as shown at right), change the file location for Vocabulary Change Requests as follows:
Because this application is installed with a Java JAR-self-installer, it does not appear in the Windows "Add/Remove Programs" control panel. There is however an uninstall routine that is installed along with the application. It can be activated from the Start Programs menu as shown in the following figure:
Selecting the Uninstall HL7 Harmonization Editor option will launch the install process with the following screen:
The only selection other than Uninstall or Quit is whether to select the option Force the deletion of <<installation directory>>. The results of this option are:
- Not selected - The application will be removed, but data content, such as proposal files, that are stored under the installation directory will be retained.
- Selected - The application will be removed, and all files under the installation directory will be removed whether or not they were part of the original installation.
Selecting Uninstall converts this pane into a progress bar that continues until the removal is complete, and only the Quit remains, as below: