GUI Client-Patient Registration for World Vista EHR

Welcome to the GUI Registration home page. I am Jim Bell, a volunteer with WorldVistA, and can be contacted at jbellco65 at gmail dot com. This product is a cooperative effort between WorldVistA and Bell-Felder Productions.

About the GUI Registration Application

The application was developed to aide users of the WorldVistA EHR in loading and editing client/patient data, avoiding the use of the standard VA based "roll 'n scroll" screen editing. Field editing is based on the use of Fileman input templates that are locally designed. The application then presents those fields for editing in a standard GUI type environment.

Client side: Delphi compiled executable (vwPR.exe) using remote procedure calls to your server system
Server side: GT.m/Fileman M(umps) based routines
Recommended Reading: ​http://www.hardhats.org/fileman/FMmain.html

State of the application

The app is currently in Alpha phase as it has not had any thorough testing at this point. I think it is very important to first install to your test environment.
Also, all instructions and help files are in the zip files.

Licensing

TBD

Do I Want To Download The Zip Files

Sure. There are the following zip files (If you have already installed,you only need to do the updates, preferably in order):

https://trac.opensourcevista.net/svn/GUIRegistration/tag/1.0/VWGUIREG.zip The main installation file containing all necessary files.
https://trac.opensourcevista.net/svn/GUIRegistration/tag/1.0/VWGUIREG_Update_03232014.zip The first update with finishing features for making an input template in the application. https://trac.opensourcevista.net/svn/GUIRegistration/tag/1.0/VWGUIREG_Update_04152014.zip
https://trac.opensourcevista.net/svn/GUIRegistration/tag/1.0/VWGUIREG_UPDATE_06042014.zip Minor update - see the README file in the zip.

Unzipping

Unzip the file VWGUIREG.zip to C:/VWREG folder. The application will always look in this folder for all relevant files (images, etc...) Then without installing you can read the tech, installation, and any other help files. Help files used by the application are browser based documents.
Only unzip and run the VWGUIREG.zip_Update... after the first file is installed on the server side.

Installation Example

-----------------------Example: Load and Install the KID File-------------------------------------------
>D ^XUP (or use the menu system at EVE->PROGRAMMER OPTIONS->Kernel Installation & Distribution System)
Setting up programmer environment
This is a TEST account.
Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System
 Edits and Distribution ...
 Utilities ...
 Installation ...
 Patch Monitor Main Menu ...
Select Kernel Installation & Distribution System Option: INStallation
Select INSTALLATION OPTION:
 1 Load a Distribution
 2 Verify Checksums in Transport Global
 3 Print Transport Global
 4 Compare Transport Global to Current System
 5 Backup a Transport Global
 6 Install Package[[BR]]
Select INSTALLATION OPTION: 1 Load a Distribution[[BR]]

Enter a Host File: /home/vista/VWREG_1_0_1alpha_12252013.KID <-or Your location of the KID install
KIDS Distribution saved on Dec 25, 2013@09:32
Comment: WorldVistA/BellFelder Prod GUI Pat Reg (alpha) c2013
This Distribution contains Transport Globals for the following Package(s):
VWREGIT*1.0*1
Distribution OK!
-------------------RESULTS------------------------------------------------
Install Started for VWREGIT*1.0*1 :
Dec 24, 2013@17:59:31
Build Distribution Date: Dec 24, 2013
Installing Routines:....
Dec 24, 2013@17:59:31
Installing Data Dictionaries: ........
Dec 24, 2013@17:59:33
Installing Data: .
Dec 24, 2013@17:59:34
Installing PACKAGE COMPONENTS:
Installing INPUT TEMPLATE..
Installing MAIL GROUP..
Installing REMOTE PROCEDURE............
Installing OPTION...
Installing PARAMETER DEFINITION..
Dec 24, 2013@17:59:34
Running Post-Install Routine: PI^VWREGIT2.
Updating Routine file......
Updating KIDS files.....
VWREGIT*1.0*1 Installed.
Dec 24, 2013@17:59:34
No link to PACKAGE file
NO Install Message sent 
------------------------END OF INSTALL-----------------------------------------
Check the mail group VW REG ERROR REPORT:
>D Q^DI
Select OPTION: INQUIRE TO FILE ENTRIES
OUTPUT FROM WHAT FILE: 3.8 MAIL GROUP (264 entries)
Select MAIL GROUP NAME: VW REG ERROR REPORT
ANOTHER ONE:<RETURN>
STANDARD CAPTIONED OUTPUT? Yes// <RETURN> (Yes)
Include COMPUTED fields: (N/Y/R/B): NO// BOTH Computed Fields and Record Number
(IEN)
-------------------RESULTS---------------------------------------------------
NUMBER: 275 NAME: VW REG ERROR REPORT
TYPE: public ALLOW SELF ENROLLMENT?: YES
COORDINATOR: BELL,JIM
DESCRIPTION: Errors in VW Registration are sent to this group
ORGANIZER: BELL,JIM
REMOTE MEMBER: jbellco65@gmail.com <I've included my gmail account>
Edit the mail group to add yourself and/or others:
Select OPTION: ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: MAIL GROUP//
EDIT WHICH FIELD: ALL//<RETURN>
Select MAIL GROUP NAME: VW REG ERROR REPORT
NAME: VW REG ERROR REPORT//< RETURN >
Select MEMBER: BELL,JIM JB mas <yourself and/or others>
Are you adding 'BELL,JIM' as a new MEMBER (the 1ST for this MAIL GROUP)? No//
Y (Yes)
TYPE: ?
Choose from:
C CC
I INFO
TYPE: I INFO
Select MEMBER:<RETURN when you've added everyone you want>
DESCRIPTION:
1>Errors in VW Registration are sent to this group
EDIT Option:<RETURN>
TYPE: public//<RETURN>
ORGANIZER: BELL,JIM//<Your name>
COORDINATOR: BELL,JIM// <answered in the install>
Select AUTHORIZED SENDER:<RETURN>
ALLOW SELF ENROLLMENT?: YES//<YES OR NO>
REFERENCE COUNT:<RETURN>
LAST REFERENCED:<RETURN>
RESTRICTIONS:<RETURN>
Select MEMBER GROUP NAME:<OPTIONAL but you can add other mgs here>
Select REMOTE MEMBER: jbellco65@gmail.com// <LEAVE ME IN>
Select DISTRIBUTION LIST: <RETURN>
Select FAX RECIPIENT: <RETURN>
Select FAX GROUP: <RETURN>
--------------------------------------End of mail group editing-----------------------------
--Initial editing of the PARAMETER system to set the home directory for regit.txt—
Check to see if the installation filed a home directory (which you can change using the GUI). At the programmer prompt:
>W $$GET^XPAR("ALL","VW GUI REG TEMPLATE DIRECTORY")
It will return
/home/vista/regparam/
If you get that response then you do can skip to Appendix B. If the check above returned nothing then you will need to make [[BR]]
an initial entry for the Parameter File value for your home directory (where the regit.txt file is located). This is sometimes a[[BR]]
confusing option to use so don't hesitate to contact me for a conference call:
>D ^XUP
Select OPTION NAME: XPAR MENU TOOLS General Parameter Tools
LV List Values for a Selected Parameter
LE List Values for a Selected Entity
LP List Values for a Selected Package
LT List Values for a Selected Template
EP Edit Parameter Values
ET Edit Parameter Values with Template
EK Edit Parameter Definition Keyword
Select General Parameter Tools Option: EP Edit Parameter Values
--- Edit Parameter Values ---
Select PARAMETER DEFINITION NAME: VW GUI REG TEMPLATE DIRECTORY Host Home Directory
VW GUI REG TEMPLATE DIRECTORY may be set for the following:
1 User USR [choose from NEW PERSON]
3 Division DIV [choose from INSTITUTION]
5 Package PKG [choose from PACKAGE]
7 Class CLS [choose from USR CLASS]
9 System SYS [WVEHR309.OPENFORUM.OPENSOURCEVISTA.NET]
Enter selection: 9 System <This will reflect whatever your Kernel system displays>
Setting VW GUI REG TEMPLATE DIRECTORY for System: WVEHR309.OPENFORUM.OPENSOURCEVISTA.NET
Path for local Home Directory: <Enter the directory where regit.txt is located>
VW GUI REG TEMPLATE DIRECTORY may be set for the following:
1 User USR [choose from NEW PERSON]
3 Division DIV [choose from INSTITUTION]
5 Package PKG [choose from PACKAGE]
7 Class CLS [choose from USR CLASS]
9 System SYS [WVEHR309.OPENFORUM.OPENSOURCEVISTA.NET]
Enter selection: 3 Division <RETURN>
LV List Values for a Selected Parameter
LE List Values for a Selected Entity
LP List Values for a Selected Package
LT List Values for a Selected Template
EP Edit Parameter Values
ET Edit Parameter Values with Template
EK Edit Parameter Definition Keyword
Select General Parameter Tools Option:<RETURN when done>
--------------------------END PARAMETER EDITING--------------------------------------------
-------------------Get the VWREG EXAMPLE template IEN---------------------------------
OUTPUT FROM WHAT FILE: PATIENT// INPUT TEMPLATE<RETURN> (1556 entries)
Select INPUT TEMPLATE: VWREG EXAMPLE<RETURN> (Dec 24, 2013@12:07) File #2
ANOTHER ONE: <RETURN>
STANDARD CAPTIONED OUTPUT? Yes// N (No) <RETURN>
FIRST PRINT FIELD: NUMBER<RETURN>
THEN PRINT FIELD: <RETURN>
Heading (S/C): INPUT TEMPLATE LIST//<RETURN>
DEVICE: <RETURN>
Results:
INPUT TEMPLATE LIST DEC 25,2013 12:09 PAGE 1
NUMBER
--------------------------------------------------------------------------------
1767 <- This is the number that you want to put in the regit.txt file. With no other entries the file should look like this:
[TEMPLATES]
VWREG EXAMPLE(1767) (or what ever your IEN is...)
[ID]
With this entry, the GUI will produce it for use. Note also that using the Set Up button (if you have the VW REG IT CONTROL in your [[BR]]
secondary menu) will allow to you select and add templates to the regit.txt file. (Warning: I strongly recommend that you stay away from [[BR]]
any existing templates that have been included by the VA)

Credits & Thank you

Big thanks to Nasir Mahmood and Tony Reed for helping with non-U.S.A. issues in data, and Sam Habiel for assisting with Fileman Data Base Server and M(umps) code issues.

future

Very dependent on what feedback is received.

Feedback

I will check my email (noted above) twice a day.

Applause, commendation, comments, compliments, condemnation, criticism, disapproval, disparagement, ideas, proposals, recommendations, reproach, requests, suggestions
ALL received with a smile and a thank you. (You'll have to trust me on the "smile" part...)

Jim Bell