$TXT Created by Lilly,George at FORUM.OSEHRA.ORG (KIDS) on Thursday, 04/09/15 at 15:34 ============================================================================= Run Date: APR 09, 2015 Designation: HDIS*1.0*10002 Package : HDI - Health Data & Informatics Priority: Mandatory Version : 1.0 SEQ #11 Status: Released Compliance Date: APR 30, 2015 ============================================================================= Subject: INACTIVE ALLERGY SCREENING PATCH Category: - Routine - Enhancement (Mandatory) Description: ============ This patch issues a modification to one routine, HDISVF01, in the HEALTH DATA & INFORMATICS Package. The modification ensures that only active allergies will be selectable from the GMR ALLERGIES File (#120.82) and only active sign/symptoms from the SIGNS/SYMPTOMS file (120.83). Routine HDISVF01 invokes screening logic at entry point SCREEN for various files depending on whether or not VUIDs have been created. If VUIDs have not been created on a system, the screening logic is not invoked. Incomplete implementation of VUID creation on the version of VistA released via the Freedom of Information Act (FOIA) resulted in a situation where screening logic for this file -- which includes screening out inactive entries -- is not invoked. Thus, when selecting patient allergies using option GMRA PATIENT A/AR EDIT, if the user enters a string that partially matches multiple entries in the GMR ALLERGIES File, all such entries -- both active and inactive -- will be presented to the user. This can present a confusing set of seemingly identical or similar choices to the user. It can also complicate later activities such as attempting to find all patients who currently have, or have ever had, a particular allergy. Because VUID creation was fully implemented on VA medical center instances of VistA a number of years ago, this situation does not arise within the VA enterprise. It is only in evidence in FOIA VistA and derivatives of FOIA VistA that do not contain this or a similar patch. The patch implements a workaround by forcing the screening logic to be implemented for the GMR ALLERGIES File any time HDISVF01 is invoked at entry point SCREEN. If VUID creation is ever fully implemented on FOIA VistA, this issue should be fully resolved. Remediation to this problem is expected to come when the Master File Server (MFS) is used to update the HDIS files that govern the active/inactive checking of locked down files. Illustration of Problem and Resolution: ======================================= To recreate the problem, install the March 2015 FOIA distribution of VistA and invoke option GMRA PATIENT A/AR EDIT. For any patient (for simplicity, preferably one without current allergies), enter an allergy of ASPIRIN. The system should respond Now checking GMR ALLERGIES (#120.82) file for matches... 1 ASPIRIN 2 ASPIRIN RELATED MEDICATIONS CHOOSE 1-2: ASPIRIN is inactive and would not be displayed if VUID installation had been fully implemented. At this point, exit the system without making a selection. After applying this patch, perform the same function. The system should respond Now checking GMR ALLERGIES (#120.82) file for matches... RELATED MEDICATIONS ASPIRIN RELATED MEDICATIONS OK? Yes// Note that ASPIRIN (without RELATED MEDICATIONS), because it is inactive, no longer displays. Test: ===== The tests are available in the same zip files as this KIDS build. The tests are written using Munit that is namespaced %ut. To run the tests type the following: S DUZ=1 D ^XUP D ^ZZUTHDIS01 D ^ZZUTHDIS02 Sample Test runs: Before: OSEHRA>D ^ZZUTHDIS01 ALLERGY^ZZUTHDIS01 - that an inactive allergy is active - <1> vs <0> - Allergy screen not active SIGNS^ZZUTHDIS01 - that an inactive sign/symptom is active - <1> vs <0> - Sign/Symptom Screen not active . Ran 1 Routine, 3 Entry Tags Checked 3 tests, with 2 failures and encountered 0 errors. OSEHRA>D ^ZZUTHDIS02 ALLERGY^ZZUTHDIS01 - that an inactive allergy is active - <1> vs <0> - Allergy screen not active SIGNS^ZZUTHDIS01 - that an inactive sign/symptom is active - <1> vs <0> - Sign/Symptom Screen not active . Ran 1 Routine, 3 Entry Tags Checked 3 tests, with 2 failures and encountered 0 errors. After: OSEHRA>D ^ZZUTHDIS01 ... Ran 1 Routine, 3 Entry Tags Checked 3 tests, with 0 failures and encountered 0 errors. OSEHRA>D ^ZZUTHDIS02 ... Ran 1 Routine, 3 Entry Tags Checked 3 tests, with 0 failures and encountered 0 errors. OSEHRA> Future work: ============ None planned. Contents: ========= This patch includes file HDI-1_PAT-10002_T1.KID, which can be installed using the KIDS Build installation options on menu XPD INSTALLATION MENU. Test Sites: =========== DSS JIRA: ===== CONV-90 - Inactive GMR Allergies are selectable for Patient records http://issues.osehra.org/browse/CONV-90 INSTALLATION INSTRUCTIONS: ========================== This patch can be installed with users on the system with installation taking less than 10 minutes. Note: The following is a list of REQUIRED builds for HDI*1.0*10002. KIDS will not allow the installation of this patch without the prior installation of them. HDI*1.0*10002 1. Use the INSTALL/CHECK MESSAGE option on the PackMan menu. [Note: TEXT PRINT/DISPLAY option in the PackMan menu will display the patch text only.] or to load the patch manually use the Kernel Installation and Distribution System Menu, select the Installation menu then Load a Distribution 2. From the Kernel Installation and Distribution System Menu, select the Installation menu. 3. From this menu, you may elect to use the following options (when prompted for INSTALL NAME, enter HDI*1.0*10002): a. Backup a Transport Global b. Compare Transport Global to Current System c. Verify Checksums in Transport Global d. Print Transport Global 4. Use the Install Package(s) option and select the package HDI*1.0*8. 5. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//', respond NO. 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;HEALTH DATA & INFORMATICS;**1,10002**;Feb 22, 2005 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: HDISVF01 Before: ? After: ? **1,10002** Routine list of preceding patches: 1 ============================================================================= User Information: Entered By : SOME,ONE Date Entered : ? Completed By: SOME,ONE ELSE Date Completed: ? Released By : SOME,ONE DIFFERENT Date Released : ? =============================================================================