============================================================================= Run Date: JUN 04, 2020 Designation: XU*8*653 Package : XU - KERNEL Priority: Mandatory Version : 8 SEQ #568 Status: Released Compliance Date: SEP 30, 2020 ============================================================================= Associated patches: (v)XU*8*602 <<= must be installed BEFORE `XU*8*653' Subject: DEFERRED ALERT FOR CPRS Category: - Routine - Data Dictionary Description: ============ This patch is part of CPRS v31b updates. Below is a list of all the applications involved in this project along with their patch numbers: APPLICATION/VERSION PATCH --------------------------------------------------------------- KERNEL v8.0 XU*8.0*653 TOOLKIT v7.3 XT*7.3*142 TEXT INTEGRATION UTILITIES v1.0 TIU*1.0*290 WOMEN'S HEALTH v1.0 WV*1.0*24 HEALTH SUMMARY v2.7 GMTS*2.7*67 REGISTRATION v5.3 DG*5.3*932 CLINICAL REMINDERS v2.0 PXRM*2.0*45 ADVERSE REACTION TRACKING v4.0 GMRA*4.0*53 CONSULT/REQUEST TRACKING v3.0 GMRC*3.0*88 OUTPATIENT PHARMACY v7.0 PSO*7.0*477 ORDER ENTRY/RESULTS REPORTING v3.0 OR*3.0*377 Patches XU*8.0*653 and XT*7.3*142 are being released in their individual Kernel Installation and Distribution System (KIDS) Host files. The other patches (TIU*1.0*290, WV*1.0*24, GMTS*2.7*67, DG*5.3*932, PXRM*2.0*45, GMRA*4.0*53, GMRC*3.0*88, PSO*7.0*477, and OR*3.0*377) are being released in the KIDS multi-package build CPRS V31B REQUIRED PATCHES 1.0. The Computerized Patient Record System (CPRS) Clinical Work Group approved a change request to allow users to defer alerts in CPRS to a later time. CPRS will add a new "Defer" button on the screen that shows the alerts. When an alert is selected and the "Defer" button is clicked, a dialog will display asking the user a date/time to defer the alert until. The CPRS team felt the information should be kept in a central repository (ALERT file) so all applications can have access to this information. To accommodate this request a new field ALERT DEFERRED DATE/TIME (#.06) has been added to the ALERT file (#8992) to store a date/time an alert will be deferred for. The alert deferred date cannot be greater than 14 days in the future. Code has been written to check for the date time not Greater than 14 days and to store a valid date in the call to API: DEFALERT^XQALDATA. If an alert is deferred, it will not show up on a list of alerts for a user to process until the deferred date/time has passed. Code has been modified to flag the deferred Alert and to not display it to the screen in a call to the API: GETUSER1^XQALDATA. Two new calls have been added to the code in XQALDATA. GETPAT2, GETPAT3, and GETPAGE have been added to get a specific range(determined by page and limit) of a single patient's alerts. The GETPAT2, and GETPAT2 APIs would be called from CPRS. Changes were also made to routine XQALDEL to accommodate the deferred alert functionality. The field length of the DISPLAY TEXT field (#1.01) in the ALERT TRACKING file (#8992.1) has been extended from 70 characters to 95 characters. The women's health high risk medications component of CPRS v31 has a requirement to generate alerts with longer display text values. Code has been edited to accommodate this change in routine XQALSET. The field length of the MESSAGE TEXT (#.03) in the ALERT DATE/TIME SUB-FILE (#8992.01) has been extended from 60 characters to 95 characters to accommodate longer rewording of some alert texts The API ALERTDAT^XQALBUTL has been edited to display the LONG INFO TEXT field (4) in the ALERT TRACKING file (#8992.1) correctly. The field data was not displaying and should have been. Patch Components =============== Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- ALERT (8992) ALERT DEFERRED DATE/TIME (.06) New ALERT TRACKING (8992.1) DISPLAY TEXT (1.01) Modified ALERT DATE/TIME(8992.01) MESSAGE TEXT(.03) Modified Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- NA Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- NA Options Associated: ================ Option Name Type New/Modified/Deleted ----------- ---- -------------------- NA Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- NA Security Keys Associated: Security Key Name ----------------- NA Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- NA Additional Information: NA Blood Bank Team Coordination: ============================= Blood Bank Clearance: 10/09/2018 EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch XU*8*653 contains changes to a package referenced in VHA OI SEPG SOP 192-023 Review of VISTA Patches for Effects on VISTA Blood Bank Software. This patch does not alter or modify any VistA Blood Bank software design safeguards or safety critical elements functions. RISK ANALYSIS: Changes made by patch XU*8*653 have no effect on Blood Bank software functionality, therefore RISK is none. New Service Requests (NSRs): ---------------------------- NA Patient Safety Issues (PSIs): ----------------------------- NA Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1.INC000001033565 : new request for CPRS Problem: ------- A new field is being requested in the alert file regarding the deferral date. The field will need to be either an R directory or an API (GETUSERONE^XQALDATA). The way CPRS will utilize the field is it will not show the alert to the specific user until the deferral date is in the past. Also requesting an extension of the field length Of the DISPLAY TEXT field (1.01) in the ALERT TRACKING file (8992.1) from 70 to 95. ---------- Resolution: ---------- Added a new field ALERT DEFERRED DATE/TIME (.06) in File ALERT TRACKING (#8992.1) and added new code to accommodate This request. Also extended the field length for MESSAGE TEXT ALERT TRACKING file (8992.1). Test Sites: (Patch Tracking Message #) ---------- - ATLANTA, GA VAMC - CLEVELAND, OH VAMC - HAMPTON, VA VAMC - NORTHPORT, NY VAMC Software and Documentation Retrieval Instructions: ---------------------------------------------------- Sites may retrieve the software and/or documentation directly using the Secure File Transfer Protocol (SFTP) address as directed by the CPRS Implementation team. Installation instructions will be distributed when your site begins the implementation process. Documentation can also be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ The updated documentation will not be on the vdl until after the phased deployment has completed. Update Install Instructions Please refer to the "CPRS v31b Deployment, Installation, Back Out and Rollback Guide" for installation and set-up information. This document is exported as OR_30_377_IG.doc and OR_30_377_IG.pdf and is included in OR_30_377.ZIP and will be emailed to the installation point of contacts by the CPRS Implementation team. Installation of these host files must be coordinated among the personnel affected because these host files will be installed in one installation session. Title File Name FTP Mode ----------------------------------------------------------------------- NA Patch Installation: Pre/Post Installation Overview: ------------------------------- There are no steps to perform. Pre-Installation Instructions: ----------------------------- This patch is installed when users are not on the system. It should take less than 5 minutes to install. Installation Instructions ------------------------- Refer to the CPRS v31b Installation Guide (or_30_377_ig.docx). Post-Installation Instructions ------------------------------ There is no further step needed after the installation. Backout and Rollback Procedure: ------------------------------- This patch consists of a new database definition. If assistance is needed to rollback/backout the patch please, log a CA Service Desk Manager (SDM) ticket so the development team can assist in this process. Routine Information: ==================== The second line of each of these routines now looks like: ;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995;Build 19 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: XQALBUTL Before: B78074082 After: B83370145 **114,125,171,285,602,653** Routine Name: XQALDATA Before: B11271249 After: B33101097 **207,285,443,513,602,653** Routine Name: XQALDEL Before: B56273165 After: B61838554 **6,24,65,114,174,285,443,602,653** Routine Name: XQALSET Before: B72705650 After: B72706141 **1,6,65,75,114,125,173,207, 285,443,602,653** Routine list of preceding patches: 602 ============================================================================= User Information: Entered By : Date Entered : SEP 23, 2014 Completed By: Date Completed: JUN 03, 2020 Released By : Date Released : JUN 04, 2020 ============================================================================= Packman Mail Message: ===================== No routines included