Overview
These are the instructions for deploying the CDA Redaction Web Service under the Glassfish application server.
The CDA Web Service implements a "reduce" call which operates as follows:
- Accepts a list of files
- Looks through the list to determine is a consent document has been supplied
- Generates a redaction map based on supplied consent information
- Converts clinical documents to a single VMR
- Submits the VMR to the redaction OpenCDS service
- The redaction OpenCDS service classifies the VMR entries with a set of ILHIE redaction states
- Receives the response back from the redaction OpenCDS service
- Applies the consent map decisions with respect to the redaction OpenCDS service classifications
- Redacts the original clinical documents accordingly
- Returns the documents redacted to the caller
The OpenCDS call can be disabled if desired. See below for instructions.
See "// ENTRY POINT FOR ALTERNATIVE REDACTION CODE" in CdaServiceMGR.java for extending redaction processing.
Downloads
Visit this projects build page for source build instructions.
Prerequisites
- Install Java SE 7
- Install Glassfish 3.1.2 and configure and start a domain
Consult with the Java SE and Glassfish documentation for installation guides.
Deploying Service
- Download or build the appropriate distribution
- Optional: Disable OpenCDS calls
- Extract the cda-ws-ear.ear file
- Extract the cda-ws-ejb.jar
- Edit the cda-ws-ejb.jar's META-INF/ejb-jar.xml file and set OPENCDS_ENABLED = false'
- Archive the cda-ws-ejb.jar with the changed META-INF/ejb-jar.xml file
- Archive the cda-ws-ear.ear file with the changed cda-ws-ejb.jar file
- Copy the cda-ws-ear.ear file to the autodeploy directory of the Glassfish domain you have setup
Web Service Endpoint
The deployed endpoint will be:
http://<domain hostname>:<domain port>/CdaService/Evaluate?wsdl