View source

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 [http://en.wikipedia.org/wiki/Eclipse_%28software%29 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 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:
#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/ 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)

[[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===
*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 [https://bugs.eclipse.org/bugs/enter_bug.cgi?product=OHF this site (Bugzilla)]. The project name (within Bugzilla) is '''OHF''', the Component name is '''H3ET'''.