Eclipse Instance Editor

From Hl7book

Jump to: navigation, search

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).


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.


The latest version of the editor can be downloaded from (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

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)

Image: Eclipse_sync_issue.gif

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

Installing CDA support

Get the CDA project

  • Download from
  • 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

Bug Reporting

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

Personal tools