Eclipse Instance Editor

From Hl7book

The Eclipse Instance editor can be used to both edit, as well as validate, CDA instances. The validation process is based on the MIF of the CDA R-MIM as well as additional CDA specific constraints (e.g. structure of section.text).

Contents 1 Prepackaged version 1.1 Download 1.2 Use of the tool 2 Manual install 2.1 Installing Eclipse + WST 2.2 Installing CDA support 2.3 Get the CDA project 3 JAR for command-line / web site 4 Bug Reporting

Prepackaged version

Use this version if you don't (want to) know about Eclipse. The prepackaged version can be used on the Windows platform (only), and always installs in one predefined directory.

Download

The latest version of the editor can be downloaded from http://www.jivamedical.com/eclipse_update/CDAToolsInstall.exe (170 Mb). This full install package will install in the c:\cda_tools directory.

Pre-installation notes:

1. Uninstall any previous version before installing a new version. See the uninstall file in the c:\cda_tools directory.
2. Note: make sure you have a fairly recent Java JVM (In case of doubt, install the latest JVM 1.6 version). Download the latest version from http://www.java.com/getjava/.

Post-installation notes (upon starting the tool for the first time):

1. A popup will ask you to accept a default "Eclipse workspace" directory. Accept the suggested location.
2. See image below. To test the environment, select the [+] symbol in front of the name of the project (1). Select one of the sample CDA XML instance files (2).
   • If you get the error shown (3): select OK to get rid of this error message (and OK all subsequent error windows as well). Afterwards: click once on the name of the project (1). Press F5, or refresh off the right-click menu. Restart eclipse and try again. (The error occurs only once, after the restart of Eclipse it won't occur again)

Use of the tool

See Eclipse CDA Editor quick start guide for information.

Manual install

If you require more flexibility in terms of installation location, or want to have access to the latest versions, please use the installation instructions below:

Installing Eclipse + WST

• Download Eclipse (download RCP/Plugin bundle from www.eclipse.org) from http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-rcp-europa-winter-win32.zip
• Unzip to <anywhere>. (c:\temp\cda in the rest of these instructions)
• Start Eclipse. (c:\temp\cda\eclipse\eclipse.exe)
• Choose Workspace (c:\temp\cda\workspace for these instructions)

Installing CDA support

• Help --> Software Updates --> Find and Install
• Search for new features to install
• Click New Remote Site, add
  • Name = CDA Support
  • URL = http://www.jivamedical.com/eclipse_update/infoway_support/site.xml
• Click New Remote Site, add
  • Name = CDA
  • URL = http://www.jivamedical.com/eclipse_update/infoway/site.xml
• Check both “CDA” and “CDA support” are selected, and Finish
• Select both again, and Next
• Accept license agreements, Finish, Install All, then restart.

Get the CDA project

• Download org.hl7.cda.zip from http://www.jivamedical.com/eclipse_update/org.hl7.cda.zip
• Extract it into the workspace c:\temp\cda\workspace\org.hl7.cda\
• In Eclipse, close the welcome window if it is open
• File.. Import..
• Under General, choose “existing projects into workspace”
• Choose the workspace (c:\temp\cda\workspace) as the root directory
• Choose the org.hl7.cda project. (Do not click “copy projects into workspace”).
• Finish

JAR for command-line / web site

• The jar file for command line instance validator is at http://www.jivamedical.com/eclipse_update/InstanceValidator.jar
• doco for the jar file: just run it from the command line and it will print doco to std out / command line

Bug Reporting

Bugs should be reported via this site (Bugzilla). The project name (within Bugzilla) is OHF, the Component name is H3ET.