VistA-EDIS/java
sblaz a04111bff9 commiting a copy of 0.1 version of vistalink-tester jar 2011-10-16 21:15:03 +00:00
..
tracking-ear integrated tracking-help into build, added build output ('target') directories to svn:ignore 2011-09-10 21:59:28 +00:00
tracking-help removed cruft related to KAAJEE, stubbed in spring-security/VistALink authentication implementation 2011-09-13 07:02:13 +00:00
tracking-maven-repository renamed tracking-maven-repository to match neighboring directories 2011-09-07 08:46:29 +00:00
tracking-parent removed cruft related to KAAJEE, stubbed in spring-security/VistALink authentication implementation 2011-09-13 07:02:13 +00:00
tracking-server-bigboard removed cruft related to KAAJEE, stubbed in spring-security/VistALink authentication implementation 2011-09-13 07:02:13 +00:00
tracking-server-core deleted duplicate classes from gov.va.med.edp.rpc package in favor of ones in gov.va.med.edp.vistalink and configured rest of application accordingly 2011-10-02 22:06:34 +00:00
tracking-server-main deleted duplicate classes from gov.va.med.edp.rpc package in favor of ones in gov.va.med.edp.vistalink and configured rest of application accordingly 2011-10-02 22:06:34 +00:00
tracking-server-vista deleted duplicate classes from gov.va.med.edp.rpc package in favor of ones in gov.va.med.edp.vistalink and configured rest of application accordingly 2011-10-02 22:06:34 +00:00
tracking-ui-bigboard committing first working version of EDIS maven build - upgraded to maven 3.0.3, flexmojos 3.8, flex sdk 3.6.0.16995, removed dependencies on KAAJEE and maven repository on VA intranet, replaced with one on filesystem 2011-09-07 08:29:40 +00:00
tracking-ui-core set version number embedded in flex application to match the one in the project pom.xml files: 1.0.1.WorldVistA-SNAPSHOT 2011-10-16 19:16:47 +00:00
tracking-ui-main committing first working version of EDIS maven build - upgraded to maven 3.0.3, flexmojos 3.8, flex sdk 3.6.0.16995, removed dependencies on KAAJEE and maven repository on VA intranet, replaced with one on filesystem 2011-09-07 08:29:40 +00:00
vistalink-tester commiting a copy of 0.1 version of vistalink-tester jar 2011-10-16 21:15:03 +00:00
README added information about configuring VistALink and SSL to README 2011-09-19 01:16:39 +00:00

README

# Emergency Department Integration Software

Emergency Department Integration Software (EDIS) incorporates several Web-based views that extend the current Computerized Patient Record System (CPRS) to help healthcare professionals track and manage the flow of patient care in the emergency- department setting.

## How to build

This project is built using maven (currently version 3.0.3).  You can download
and install maven from http://maven.apache.org.  The whole build can be invoked
from the command line from the tracking-parent directory:

	$ mvn clean package

The Flex user interface artifacts are built with the "flexmojos" maven plugin (currently version 4.0).
In order for maven to run the Flex unit tests you will also need Adobe's Flash Player installed and in
your PATH.  See <https://docs.sonatype.org/display/FLEXMOJOS/Running+unit+tests> for more info.  To skip
the unit tests, use:

	$ mvn clean package -DskipTests=true
	
## Build Artifacts	
	
The main web application artifact produced by the build will be at:

	tracking-server-main/target/main.war			Main EDIS web application (including bigboard require user login)

Optional artifacts include:

	tracking-server-help/target/help.war			Help files
	tracking-server-bigboard/target/bigboard.war	EDIS big board designed for use with no logged in user (requires configuration)
	tracking-server-ear/target/edis.ear				main.war, help.war, bigboard.war packaged as an .ear
	
Pick and choose which are appropriate depending on your deployment platform and configuration.

## Configuring VistALink

Currently, VistALink connection settings are "baked in" to the web application in the following file:

	tracking-server-main/src/main/web-app/WEB-INF/config/vistalink-config.xml
	
You can either edit this before performing a build so that main.war contains your connection settings, or do it after deploying main.war to your servlet container in "exploded" mode.

Possible future development could store this connection information with some alternative implementation, like in a relational database, for example. One could potentially write a VistALink connection info administration UI as well.

## Configuring SSL

Currently, EDIS is not configured to enforce channel security over SSL, though it should be able to run over SSL if you have configured your servlet container to serve it over SSL, which you most certainly should do.  If you'd like it to serve user-friendly welcome pages over port 80 and still require SSL for other bits, you will need to tweak the spring-security configuration located at:

tracking-server-main/src/main/web-app/WEB-INF/config/security-config.xml

The main web application uses the spring security framework (version 2.0.7) to implement its security layer.  You can read more about it here:
http://static.springsource.org/spring-security/site/docs/2.0.x/reference/springsecurity.html

## EDIS Big Board Automatic Login with No User

Currently the EDIS Big Board web application (bigboard.war) has no authentication mechanism configured at all.  VA's implementation was a WebLogic specific 2-way SSL authentication mechanism.  If you want automatically authenticating big boards you will need to implement the equivalent yourself.

The main EDIS application (main.war) contains a copy of the Big Board that runs as a signed-in user, which should work as a starting point.