| 8 | | == About the GUI Registration Application == |
| 9 | | 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. |
| 10 | | |
| 11 | | '''Client side: '''Delphi compiled executable (vwPR.exe) using remote procedure calls to your server system[[BR]] |
| 12 | | '''Server side: '''GT.m/Fileman M(umps) based routines[[BR]] |
| 13 | | '''Recommended Reading: '''[http://www.hardhats.org/fileman/FMmain.html][[BR]] |
| 14 | | |
| 15 | | === State of the application === |
| 16 | | 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.[[BR]] |
| 17 | | Also, all instructions and help files are in the zip files. |
| 18 | | |
| 19 | | == Licensing == |
| 20 | | '''TBD''' |
| 21 | | |
| 22 | | == Do I Want To Download The Zip Files == |
| 23 | | Sure. There are the following zip files (If you have already installed,you only need to do the updates, preferably in order): |
| 24 | | |
| 25 | | Check back often |
| 26 | | |
| 27 | | === Unzipping === |
| 28 | | Unzip the file VWGUIREG.zip to C:/VWREG folder. The application will always look in this folder for all relevant files (images, etc...) |
| 29 | | Then without installing you can read the tech, installation, and any other help files. Help files used by the application are browser based documents.[[BR]] |
| 30 | | Only unzip and run the VWGUIREG.zip_Update... after the first file is installed on the server side. |
| 31 | | |
| 32 | | == Installation Example == |
| 33 | | {{{ |
| 34 | | -----------------------Example: Load and Install the KID File------------------------------------------- |
| 35 | | >D ^XUP (or use the menu system at EVE->PROGRAMMER OPTIONS->Kernel Installation & Distribution System) |
| 36 | | Setting up programmer environment |
| 37 | | This is a TEST account. |
| 38 | | Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System |
| 39 | | Edits and Distribution ... |
| 40 | | Utilities ... |
| 41 | | Installation ... |
| 42 | | Patch Monitor Main Menu ... |
| 43 | | Select Kernel Installation & Distribution System Option: INStallation |
| 44 | | Select INSTALLATION OPTION: |
| 45 | | 1 Load a Distribution |
| 46 | | 2 Verify Checksums in Transport Global |
| 47 | | 3 Print Transport Global |
| 48 | | 4 Compare Transport Global to Current System |
| 49 | | 5 Backup a Transport Global |
| 50 | | 6 Install Package[[BR]] |
| 51 | | Select INSTALLATION OPTION: 1 Load a Distribution[[BR]] |
| 52 | | |
| 53 | | Enter a Host File: /home/vista/VWREG_1_0_1alpha_12252013.KID <-or Your location of the KID install |
| 54 | | KIDS Distribution saved on Dec 25, 2013@09:32 |
| 55 | | Comment: WorldVistA/BellFelder Prod GUI Pat Reg (alpha) c2013 |
| 56 | | This Distribution contains Transport Globals for the following Package(s): |
| 57 | | VWREGIT*1.0*1 |
| 58 | | Distribution OK! |
| 59 | | -------------------RESULTS------------------------------------------------ |
| 60 | | Install Started for VWREGIT*1.0*1 : |
| 61 | | Dec 24, 2013@17:59:31 |
| 62 | | Build Distribution Date: Dec 24, 2013 |
| 63 | | Installing Routines:.... |
| 64 | | Dec 24, 2013@17:59:31 |
| 65 | | Installing Data Dictionaries: ........ |
| 66 | | Dec 24, 2013@17:59:33 |
| 67 | | Installing Data: . |
| 68 | | Dec 24, 2013@17:59:34 |
| 69 | | Installing PACKAGE COMPONENTS: |
| 70 | | Installing INPUT TEMPLATE.. |
| 71 | | Installing MAIL GROUP.. |
| 72 | | Installing REMOTE PROCEDURE............ |
| 73 | | Installing OPTION... |
| 74 | | Installing PARAMETER DEFINITION.. |
| 75 | | Dec 24, 2013@17:59:34 |
| 76 | | Running Post-Install Routine: PI^VWREGIT2. |
| 77 | | Updating Routine file...... |
| 78 | | Updating KIDS files..... |
| 79 | | VWREGIT*1.0*1 Installed. |
| 80 | | Dec 24, 2013@17:59:34 |
| 81 | | No link to PACKAGE file |
| 82 | | NO Install Message sent |
| 83 | | ------------------------END OF INSTALL----------------------------------------- |
| 84 | | Check the mail group VW REG ERROR REPORT: |
| 85 | | >D Q^DI |
| 86 | | Select OPTION: INQUIRE TO FILE ENTRIES |
| 87 | | OUTPUT FROM WHAT FILE: 3.8 MAIL GROUP (264 entries) |
| 88 | | Select MAIL GROUP NAME: VW REG ERROR REPORT |
| 89 | | ANOTHER ONE:<RETURN> |
| 90 | | STANDARD CAPTIONED OUTPUT? Yes// <RETURN> (Yes) |
| 91 | | Include COMPUTED fields: (N/Y/R/B): NO// BOTH Computed Fields and Record Number |
| 92 | | (IEN) |
| 93 | | -------------------RESULTS--------------------------------------------------- |
| 94 | | NUMBER: 275 NAME: VW REG ERROR REPORT |
| 95 | | TYPE: public ALLOW SELF ENROLLMENT?: YES |
| 96 | | COORDINATOR: BELL,JIM |
| 97 | | DESCRIPTION: Errors in VW Registration are sent to this group |
| 98 | | ORGANIZER: BELL,JIM |
| 99 | | REMOTE MEMBER: jbellco65@gmail.com <I've included my gmail account> |
| 100 | | Edit the mail group to add yourself and/or others: |
| 101 | | Select OPTION: ENTER OR EDIT FILE ENTRIES |
| 102 | | INPUT TO WHAT FILE: MAIL GROUP// |
| 103 | | EDIT WHICH FIELD: ALL//<RETURN> |
| 104 | | Select MAIL GROUP NAME: VW REG ERROR REPORT |
| 105 | | NAME: VW REG ERROR REPORT//< RETURN > |
| 106 | | Select MEMBER: BELL,JIM JB mas <yourself and/or others> |
| 107 | | Are you adding 'BELL,JIM' as a new MEMBER (the 1ST for this MAIL GROUP)? No// |
| 108 | | Y (Yes) |
| 109 | | TYPE: ? |
| 110 | | Choose from: |
| 111 | | C CC |
| 112 | | I INFO |
| 113 | | TYPE: I INFO |
| 114 | | Select MEMBER:<RETURN when you've added everyone you want> |
| 115 | | DESCRIPTION: |
| 116 | | 1>Errors in VW Registration are sent to this group |
| 117 | | EDIT Option:<RETURN> |
| 118 | | TYPE: public//<RETURN> |
| 119 | | ORGANIZER: BELL,JIM//<Your name> |
| 120 | | COORDINATOR: BELL,JIM// <answered in the install> |
| 121 | | Select AUTHORIZED SENDER:<RETURN> |
| 122 | | ALLOW SELF ENROLLMENT?: YES//<YES OR NO> |
| 123 | | REFERENCE COUNT:<RETURN> |
| 124 | | LAST REFERENCED:<RETURN> |
| 125 | | RESTRICTIONS:<RETURN> |
| 126 | | Select MEMBER GROUP NAME:<OPTIONAL but you can add other mgs here> |
| 127 | | Select REMOTE MEMBER: jbellco65@gmail.com// <LEAVE ME IN> |
| 128 | | Select DISTRIBUTION LIST: <RETURN> |
| 129 | | Select FAX RECIPIENT: <RETURN> |
| 130 | | Select FAX GROUP: <RETURN> |
| 131 | | --------------------------------------End of mail group editing----------------------------- |
| 132 | | --Initial editing of the PARAMETER system to set the home directory for regit.txt— |
| 133 | | Check to see if the installation filed a home directory (which you can change using the GUI). At the programmer prompt: |
| 134 | | >W $$GET^XPAR("ALL","VW GUI REG TEMPLATE DIRECTORY") |
| 135 | | It will return |
| 136 | | /home/vista/regparam/ |
| 137 | | 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]] |
| 138 | | an initial entry for the Parameter File value for your home directory (where the regit.txt file is located). This is sometimes a[[BR]] |
| 139 | | confusing option to use so don't hesitate to contact me for a conference call: |
| 140 | | >D ^XUP |
| 141 | | Select OPTION NAME: XPAR MENU TOOLS General Parameter Tools |
| 142 | | LV List Values for a Selected Parameter |
| 143 | | LE List Values for a Selected Entity |
| 144 | | LP List Values for a Selected Package |
| 145 | | LT List Values for a Selected Template |
| 146 | | EP Edit Parameter Values |
| 147 | | ET Edit Parameter Values with Template |
| 148 | | EK Edit Parameter Definition Keyword |
| 149 | | Select General Parameter Tools Option: EP Edit Parameter Values |
| 150 | | --- Edit Parameter Values --- |
| 151 | | Select PARAMETER DEFINITION NAME: VW GUI REG TEMPLATE DIRECTORY Host Home Directory |
| 152 | | VW GUI REG TEMPLATE DIRECTORY may be set for the following: |
| 153 | | 1 User USR [choose from NEW PERSON] |
| 154 | | 3 Division DIV [choose from INSTITUTION] |
| 155 | | 5 Package PKG [choose from PACKAGE] |
| 156 | | 7 Class CLS [choose from USR CLASS] |
| 157 | | 9 System SYS [WVEHR309.OPENFORUM.OPENSOURCEVISTA.NET] |
| 158 | | Enter selection: 9 System <This will reflect whatever your Kernel system displays> |
| 159 | | Setting VW GUI REG TEMPLATE DIRECTORY for System: WVEHR309.OPENFORUM.OPENSOURCEVISTA.NET |
| 160 | | Path for local Home Directory: <Enter the directory where regit.txt is located> |
| 161 | | VW GUI REG TEMPLATE DIRECTORY may be set for the following: |
| 162 | | 1 User USR [choose from NEW PERSON] |
| 163 | | 3 Division DIV [choose from INSTITUTION] |
| 164 | | 5 Package PKG [choose from PACKAGE] |
| 165 | | 7 Class CLS [choose from USR CLASS] |
| 166 | | 9 System SYS [WVEHR309.OPENFORUM.OPENSOURCEVISTA.NET] |
| 167 | | Enter selection: 3 Division <RETURN> |
| 168 | | LV List Values for a Selected Parameter |
| 169 | | LE List Values for a Selected Entity |
| 170 | | LP List Values for a Selected Package |
| 171 | | LT List Values for a Selected Template |
| 172 | | EP Edit Parameter Values |
| 173 | | ET Edit Parameter Values with Template |
| 174 | | EK Edit Parameter Definition Keyword |
| 175 | | Select General Parameter Tools Option:<RETURN when done> |
| 176 | | --------------------------END PARAMETER EDITING-------------------------------------------- |
| 177 | | -------------------Get the VWREG EXAMPLE template IEN--------------------------------- |
| 178 | | OUTPUT FROM WHAT FILE: PATIENT// INPUT TEMPLATE<RETURN> (1556 entries) |
| 179 | | Select INPUT TEMPLATE: VWREG EXAMPLE<RETURN> (Dec 24, 2013@12:07) File #2 |
| 180 | | ANOTHER ONE: <RETURN> |
| 181 | | STANDARD CAPTIONED OUTPUT? Yes// N (No) <RETURN> |
| 182 | | FIRST PRINT FIELD: NUMBER<RETURN> |
| 183 | | THEN PRINT FIELD: <RETURN> |
| 184 | | Heading (S/C): INPUT TEMPLATE LIST//<RETURN> |
| 185 | | DEVICE: <RETURN> |
| 186 | | Results: |
| 187 | | INPUT TEMPLATE LIST DEC 25,2013 12:09 PAGE 1 |
| 188 | | NUMBER |
| 189 | | -------------------------------------------------------------------------------- |
| 190 | | 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: |
| 191 | | [TEMPLATES] |
| 192 | | VWREG EXAMPLE(1767) (or what ever your IEN is...) |
| 193 | | [ID] |
| 194 | | 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]] |
| 195 | | 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]] |
| 196 | | any existing templates that have been included by the VA) |
| 197 | | }}} |
| 198 | | |
| 199 | | == Credits & Thank you == |
| 200 | | 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. |
| 201 | | |
| 202 | | == future == |
| 203 | | Very dependent on what feedback is received. |
| 204 | | |
| 205 | | == Feedback == |
| 206 | | I will check my email (noted above) twice a day.[[BR]] |
| 207 | | |
| 208 | | Applause, commendation, comments, compliments, condemnation, criticism, disapproval, disparagement, ideas, proposals, recommendations, reproach, requests, suggestions[[BR]] |
| 209 | | '''ALL''' received with a smile and a thank you. (You'll have to trust me on the "smile" part...) |
