source: EDIS/trunk/java/README@ 1453

Last change on this file since 1453 was 1254, checked in by Solomon Blaz, 13 years ago

added information about configuring VistALink and SSL to README

File size: 3.3 KB
Line 
1# Emergency Department Integration Software
2
3Emergency 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.
4
5## How to build
6
7This project is built using maven (currently version 3.0.3). You can download
8and install maven from http://maven.apache.org. The whole build can be invoked
9from the command line from the tracking-parent directory:
10
11 $ mvn clean package
12
13The Flex user interface artifacts are built with the "flexmojos" maven plugin (currently version 4.0).
14In order for maven to run the Flex unit tests you will also need Adobe's Flash Player installed and in
15your PATH. See <https://docs.sonatype.org/display/FLEXMOJOS/Running+unit+tests> for more info. To skip
16the unit tests, use:
17
18 $ mvn clean package -DskipTests=true
19
20## Build Artifacts
21
22The main web application artifact produced by the build will be at:
23
24 tracking-server-main/target/main.war Main EDIS web application (including bigboard require user login)
25
26Optional artifacts include:
27
28 tracking-server-help/target/help.war Help files
29 tracking-server-bigboard/target/bigboard.war EDIS big board designed for use with no logged in user (requires configuration)
30 tracking-server-ear/target/edis.ear main.war, help.war, bigboard.war packaged as an .ear
31
32Pick and choose which are appropriate depending on your deployment platform and configuration.
33
34## Configuring VistALink
35
36Currently, VistALink connection settings are "baked in" to the web application in the following file:
37
38 tracking-server-main/src/main/web-app/WEB-INF/config/vistalink-config.xml
39
40You 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.
41
42Possible 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.
43
44## Configuring SSL
45
46Currently, 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:
47
48tracking-server-main/src/main/web-app/WEB-INF/config/security-config.xml
49
50The main web application uses the spring security framework (version 2.0.7) to implement its security layer. You can read more about it here:
51http://static.springsource.org/spring-security/site/docs/2.0.x/reference/springsecurity.html
52
53## EDIS Big Board Automatic Login with No User
54
55Currently 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.
56
57The 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.
Note: See TracBrowser for help on using the repository browser.