Eclipse Instance Editor
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).
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.
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.
- Uninstall any previous version before installing a new version. See the uninstall file in the c:\cda_tools directory.
- 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):
- A popup will ask you to accept a default "Eclipse workspace" directory. Accept the suggested location.
- 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.
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”).
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
Bugs should be reported via this site (Bugzilla). The project name (within Bugzilla) is OHF, the Component name is H3ET.