With the recent announcement of the open source release of OpenVista REST, we wanted to quickly document how to get running with this project. This document assumes that you have java 1.6, bazaar, apache ant and tomcat installed.
The first step is to obtain the source from Launchpad.net with the following command:
bzr branch lp:ovrest
Upon completion, you should have an ovrest directory. You can build it by:
cd ovrest
ant
Upon a successful build, you'll find a OpenVistaRESTServer.war file in the dist directory. This can be deployed to tomcat. By default, OpenVista REST is configured to use an RPC Broker running on the localhost at port 9201. If this needs to change, you can use system properties, or even source overrides to modify this. Future releases will make it easier to configure, but for now, peruse the ovrest/src/us/contineo/ContineoResource.java to see how this is done.
Next, you'll need to setup the proper permissions in OpenVista. A new OPTION named CONTINEO must be created with some assigned RPCs, as follows:
MSC FileMan 22.1030
Identity = man,sys MANAGER,SYSTEM pb SYSTEM MANAGER
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
Input to what File: OPTION// OPTION
1 OPTION (9561 entries)
2 OPTION SCHEDULING (13 entries)
CHOOSE 1-2: 1 OPTION (9561 entries)
EDIT WHICH FIELD: ALL// .01 NAME
THEN EDIT FIELD: 1 MENU TEXT
THEN EDIT FIELD: RPC (multiple)
EDIT WHICH RPC SUB-FIELD: ALL// .01 RPC
THEN EDIT RPC SUB-FIELD:
THEN EDIT FIELD:
Select OPTION NAME: CONTINEO
Not a known package or a local namespace.
Are you adding 'CONTINEO' as a new OPTION (the 9562ND)? No// Yes (Yes)
OPTION MENU TEXT: CONTINEO
MENU TEXT: CONTINEO//
Select RPC: ORWU USERINFO
Are you adding 'ORWU USERINFO' as a new RPC (the 1ST for this OPTION)? No// y
(Yes)
Select RPC: ORB DELETE ALERT
Are you adding 'ORB DELETE ALERT' as a new RPC (the 2ND for this OPTION)? No/
/ y (Yes)
Select RPC: ORB FORWARD ALERT
Are you adding 'ORB FORWARD ALERT' as a new RPC (the 3RD for this OPTION)? No
// y (Yes)
Select RPC: ORB RENEW ALERT
Are you adding 'ORB RENEW ALERT' as a new RPC (the 4TH for this OPTION)? No//
y (Yes)
Select RPC: ORWORB FASTUSER
Are you adding 'ORWORB FASTUSER' as a new RPC (the 5TH for this OPTION)? No//
y (Yes)
Select RPC: SC PATIENT LOOKUP
Are you adding 'SC PATIENT LOOKUP' as a new RPC (the 6TH for this OPTION)? No
// y (Yes)
Select RPC: ORQPT DEFAULT PATIENT LIST
Are you adding 'ORQPT DEFAULT PATIENT LIST' as a new RPC? No// y (Yes)
Select RPC: ORRC TASK ADD
Are you adding 'ORRC TASK ADD' as a new RPC (the 8TH for this OPTION)? No// y
(Yes)
Select RPC: ORRC TASK COMPLETE
Are you adding 'ORRC TASK COMPLETE' as a new RPC (the 9TH for this OPTION)? N
o// y (Yes)
Select RPC: ORRC TASKS BY PATIENT
Are you adding 'ORRC TASKS BY PATIENT' as a new RPC? No// y (Yes)
Select RPC: ORRC ALERTS BY PATIENT
Are you adding 'ORRC ALERTS BY PATIENT' as a new RPC? No// y (Yes)
Select RPC: ORQQPL LIST
Are you adding 'ORQQPL LIST' as a new RPC (the 12TH for this OPTION)? No// y
(Yes)
Select RPC: ORQQAL LIST
1 ORQQAL LIST
2 ORQQAL LIST REPORT
CHOOSE 1-2: 1 ORQQAL LIST
Are you adding 'ORQQAL LIST' as a new RPC (the 13TH for this OPTION)? No// y
(Yes)
Select RPC: ORWPS ACTIVE
Are you adding 'ORWPS ACTIVE' as a new RPC (the 14TH for this OPTION)? No// y
(Yes)
Select RPC: ORRC ORDERS BY ID
Are you adding 'ORRC ORDERS BY ID' as a new RPC (the 15TH for this OPTION)? N
o// y (Yes)
Select RPC: ORRC EVENTS BY PATIENT
Are you adding 'ORRC EVENTS BY PATIENT' as a new RPC? No// y (Yes)
Select RPC: ORRC ORDERS BY PATIENT
Are you adding 'ORRC ORDERS BY PATIENT' as a new RPC? No// y (Yes)
Select RPC: ORRC RESULTS BY DATE
Are you adding 'ORRC RESULTS BY DATE' as a new RPC (the 18TH for this OPTION)
? No// y (Yes)
Select RPC: ORRC RESULTS BY ID
Are you adding 'ORRC RESULTS BY ID' as a new RPC (the 19TH for this OPTION)?
No// y (Yes)
Select RPC: ORRC VITALS BY PATIENT
Are you adding 'ORRC VITALS BY PATIENT' as a new RPC? No// y (Yes)
Select RPC: ORRC VITALS BY ID
Are you adding 'ORRC VITALS BY ID' as a new RPC (the 21ST for this OPTION)? N
o// y (Yes)
Select RPC:
Select OPTION NAME:
Select OPTION:
Next, for each user who neecs to permission to run OpenVista REST, you need to assign the following options: CONTINEO, OR CPRS GUI CHART and GMV V/M GUI, as follows:
MSC FileMan 22.1030
Identity = man,sys MANAGER,SYSTEM pb SYSTEM MANAGER
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
Input to what File: OPTION// NEW PERSON (57 entries)
EDIT WHICH FIELD: ALL// 203 SECONDARY MENU OPTIONS (multiple)
EDIT WHICH SECONDARY MENU OPTIONS SUB-FIELD: ALL// .01 SECONDARY MENU OPTION
S
THEN EDIT SECONDARY MENU OPTIONS SUB-FIELD:
THEN EDIT FIELD:
Select NEW PERSON NAME: USER,CONTINEO CON
Select SECONDARY MENU OPTIONS: CONTINEO CONTINEO
Are you adding 'CONTINEO' as a new SECONDARY MENU OPTIONS? No// Y (Yes)
Select SECONDARY MENU OPTIONS: OR CPRS GUI CHART CPRSChart version 1.0.26.
66
Are you adding 'OR CPRS GUI CHART' as
a new SECONDARY MENU OPTIONS (the 2ND for this NEW PERSON)? No// Y (Yes)
Select SECONDARY MENU OPTIONS: GMV V/M GUI Vitals/Measurements GUI Applica
tion
Are you adding 'GMV V/M GUI' as
a new SECONDARY MENU OPTIONS (the 3RD for this NEW PERSON)? No// Y (Yes)
Select SECONDARY MENU OPTIONS:
Select NEW PERSON NAME:
Select OPTION:
Next, to test it out, try logging in by pointing your web browser to an OpenVista REST deployed in tomcat as:
http://localhost:8080/OpenVistaRESTServer/login?accessCode=CU1234&verifyCode=CU1234!!
... where CU1234/CU1234!! is the Access/Verify code for the user to which we assigned the options above. If successful, you should see a result similar to:
<User>
<ID>55</ID>
<Name>USER,CONTINEO</Name>
</User>
... indicating a successful login.
Also, there are JUnit tests located with the project that are easy to run using an IDE that supports JUnit, such as eclipse.
If you have questions, feel free to post them here. If you find bugs or have requests for enhancements, please post them to the ovrest project in Launchpad using the Bug Tracker interface.
