$TXT Created by TSTVSR.DOMAIN.EXT (KIDS) on Wednesday, 09/09/20 at 15:05 ============================================================================= Run Date: OCT 01, 2020 Designation: SD*5.3*745 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #618 Status: Released Compliance Date: NOV 01, 2020 ============================================================================= Associated patches: (v)SD*5.3*694 <<= must be installed BEFORE `SD*5.3*745' Subject: COVID-19 VISTA CHANGES FOR VS GUI RELEASE 1.7.1 Category: - Routine Description: ============ ************************************************************************** * GUI UPDATE NOTICE * *----------------------------------------------------------------------- * * This patch MUST be installed before the Graphical User Interface (GUI) * * update for release 1.7.1 of VistA Scheduling (VS) is installed. * * * * NOTE: This patch should not be installed at Columbus, OH or Spokane, WA* * due to the EHRM Cerner Millennium Change Freeze. * * * ************************************************************************** In addition to the items listed in the Defect Tracking Ticket(s) & Overviews section, the following enhancements were made: 1. Deleted the following unused Remote Procedure Calls (RPCs) SDEC APBLKALL SDEC APPTEVLG SDEC CLINCAN SDEC REBKCLIN SDEC SUMMGET SDEC UNDOCANA 2. Modified the SDEC FAPPTGET RPC to send back two new parameters: SDLNK = APPT REQUEST TYPE Field (#.22) from the SDEC APPOINTMENT File (#409.84) CANDATE = Cancelled date or No-show date RETURN: Successful Return: Global Array in which each array entry contains the appointment data from the PATIENT File (#2) Data is separated by ^: 1. DFN - Data File Number 2. CLINIC_IEN - Clinic Internal Entry Number (IEN) 3. CLINIC_NAME - Clinic Name 4. APPT_DATE - Appointment Date in external format 5. STATUS - Status text 6. ANCTXT - Ancillary Text 7. SDLNK - APPT REQUEST TYPE Field (#.22) from the SDEC APPOINTMENT File (#409.84) 8. IEN - Appointment request IEN 9. APPTYPE_IEN - Appointment type IEN 10. APPTYPE_NAME - Appointment type name 11. SDSTD T - Cancelled Date/No-show Date 3. Integration Agreements (IAs) - added a new parameter of variable SDF into IA #7064. 7064 NAME: Cancel Appointment Application Programming Interface (API) VARIABLES: Input SDF Flag to be passed in by external applications to determine whether a cancelled appointment should be re-opened. SDF=1 or null (default) - Appointment reopened SDF=2 - Appointment not reopened. Appointment closed with disposition of "REMOVED/EXTERNAL APP" Note: This field first appears in patch SD*5.3*745. 4. Updated the Help Desk link in the Help Pane to read VA Enterprise Service Desk (ESD) (855) 673-4357. This resides in HELP LINK TEXT multiple (#409.981) of the SDEC SETTINGS File (#409.98). This action is accompanied by post-install routine SDEC745P. 5. Updated the following fields in the SDEC SETTINGS File (#409.98) with post-install routine SDEC745P: CURRENT GUI VERISON Field (#2) GUI VERSION EFFECTIVE DATE Field (#3) 6. Updated routine SDEC08 to correctly use the variable SDECAPTID (Appointment ID) in place of variable SDECPATID (Patient ID). This routine is used for cancelling an appointment. 7. Updated routine SDEC51 to send the ORDERING FACILITY Field (#.05) of the REQUESTS/CONSULTATION File (#123) for Inter-facility Consults (IFCs). Regular consults send the FROM Field (#2). This field will populate the REQUESTED BY column in the Request Management (RM) Grid. Patch Components ================ Files & Fields Associated: File Name (#) Field Name (#) New/Modified/Deleted ------------- --------------------- -------------------- CANCELLATION REASONS #409.2 PANDEMIC NEW SDEC APPT REQUEST #409.85 DISPOSITION (#21) MODIFIED SDEC WAIT LIST #409.3 DISPOSITION (#21) MODIFIED Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- n/a Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- n/a Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- SDEC PENDING RTC - DATE Routine New SDEC PENDING RTC - FULL Routine New SDSUP Menu Modified SDECRPC Broker (Client Server) Modified Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- n/a Security Keys Associated: Security Key Name ----------------- n/a Templates Associated: Template Name Type File Name (#) New/Modified/Deleted ------------- ---- ------------------ -------------------- n/a Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC APBLKALL DELETED SDEC APPTEVLG DELETED SDEC CLINCAN DELETED SDEC REBKCLIN DELETED SDEC SUMMGET DELETED SDEC UNDOCANA DELETED SDEC APPDEL MODIFIED SDEC ARGET MODIFIED SDEC WAITLIST MODIFIED SDEC REQGET MODIFIED SDEC RECGET MODIFIED Additional Information: New Service Requests (NSRs): ----------------------------- n/a Patient Safety Issues (PSIs): ------------------------------ n/a Defect Tracking Ticket(s) & Overviews: ------------------------------------- 1. Rational # 1181077 M Programming Standards and Conventions (SAC) Compliance Fix (XINDEX Scan) Problem: ------- An XINDEX Scan revealed the use of ". . ." as part of the parameters within multiple tag lines within the SDEC routine. The ". . ." structure allows a variable number of parameters to be passed and pushed into an array of values. The use of the ". . ." parameter passing is not Standards and Conventions Committee (SACC) compliant. Resolution: ---------- Modified the code to accept passed-in parameters and created an array to be used in place of the '...' array in the original code. Modified Routines - SDEC,SDEC52A,SDEC53,SDECAR,SDECAR2,SDECWL,SDECWL2 2. Rational #1235815, #1246779 - Accept Flags from External Applications into the Appointment Cancellation Routine Problem: ------- External applications need the ability to cancel appointments without them being reopened and placed back onto the RM Grid. Resolution: ----------- Allow external applications to send a #2 flag to VS when cancelling an appointment so that the appointment will be automatically dispositioned as REMOVED/EXTERNAL APP and not returned to the RM Grid. Updated SDEC APPDEL RPC to add the input parameter of SDF. Also updated IA #7064 to include the SDF flag as an input parameter. Modified Routines - SDEC08, SDECAR, SDECWL Split routine SDEC08 due to XINDEX size restraints and created new routine SDEC08A. Modified RPC - SDEC APPDEL Added the new disposition "EA-REMOVED/EXTERNAL APP" to: SDEC APPT REQUEST (#409.85), DISPOSITION Field (#21) SD WAIT LIST FILE (#409.3), DISPOSITION Field (#21) 3. Rational #1248080 - Display Computerized Patient Record System (CPRS) Consult Tab Details Problem: ------- Users need to see the CPRS consult tab details as the view request details option for Consults, Procedures, and IFCs in the RM Grid. Resolution: ---------- VistA Scheduling was added as a subscriber to IA #1672 ORQQCN DETAIL RPC. The VS GUI directly calls this RPC to display the consult details. No VistA coding changes were needed. 4. Rational #862593 - Update Patient Indicated Date (PID) when rescheduling an appointment that was cancelled by the patient or no-showed, so that the wait time data associated with active appointments is accurate. Problem: ------- The PID must be enabled (not greyed out) and saved when rescheduling an appointment that was cancelled by patient or no-showed so that the wait time data associated with active appointment is accurate. Resolution: ---------- There were no VistA routine changes needed. The PID was enabled in the VS GUI for requests that had previously been no-showed or cancelled by patient. Once the PID was enabled on the edit request screen, the PID was saved into the SDEC APPOINTMENT REQUEST file #(409.85). 5. Rational #1252679 - New COVID-19 Cancellation Reason Code Problem: ------- A new reason code, PANDEMIC, is needed for COVID-19 response. Resolution: ---------- A new cancellation reason code, PANDEMIC, was added to the CANCELLATION REASONS File (#409.2). 6. Rational #1249141 - Display contact attempt information in the RM Grid Problem: ------- Users need to see whether a contact attempt has been logged against a request so that they can follow up accordingly. Resolution: ---------- Modified the following RPCs to include sending back the number of call attempts made and the last date a letter was sent: SDEC ARGET - added to return string at positions 120^121 SDEC WLGET - added to return string at positions 114^115 SDEC REQGET - added to return string at positions 98^99 SDEC RECGET - added to return string at positions 97^98 The following data will be return SDECALL^SDECLET. Modified routines - SDECAR1, SDECAR1A, SDECWL1, SDEC51, SDEC52 7. Rational #1245780 - Background Job to Disposition Open CPRS Return to Clinic (RTC) Orders Scheduled in VistA Problem: ------- The RTC orders in the ORDER File (#100) remain open when the corresponding SDEC APPOINTMENT REQUEST File (#409.85) is manually dispositioned using FileMan. Resolution: ---------- Upgraded Class 3 software developed for the St. Louis VA Medical Center (VAMC). The new routine and associated options identify closed RTC appointment requests (#409.85) that are not closed in the ORDER File (#101). Health Level 7 (HL7) messages are produced to complete or discontinue the RTC orders in CPRS. New routine - SDECRTCF New options added - SDEC PENDING RTC - DATE and SDEC PENDING RTC - FULL Test Sites: ----------- Detroit, MI Fayetteville, NC North Texas Software and Documentation Retrieval Instructions: ------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library (VDL) at: https://www.domain.ext/vdl/ Documentation Title File Name FTP Mode -------------------------------------------------------------------------- VistA Scheduling VS_GUI_Release_1.7.1_DIBR.PDF BINARY (DIBR = Deployment, Installation, Backout, and Rollback Guide) VistA Scheduling VS_GUI_Release_1.7.1_Release_Notes.PDF BINARY Release Notes VistA Scheduling VS_GUI_Release_1.7.1_Technical_Manual.PDF BINARY Technical Manual VistA Scheduling VS_GUI_Release_1.7.1_User_Guide_ BINARY User Guide Addendum Addendum.PDF VistA Scheduling VS_GUI_Release_1.7.1_VDD.PDF BINARY (VDD = Version Description Document) Patch Installation: Pre/Post Installation Overview ------------------------------ This patch may be installed with users on the system, although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. Installation Instructions ------------------------- 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System (KIDS) Menu, select the Installation Menu. From this menu, you may elect to use the following option. When prompted for the INSTALL enter the patch # (SD*5.3*745): a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not back up any other changes such as Data Dictionaries (DDs) or templates. b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all components of this patch (routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install. 5. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', respond YES. 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', respond NO. 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//', respond NO. 8. If prompted 'Delay Install (Minutes): (0 - 60): 0//', respond 0. Post-Installation Instructions: ------------------------------ Post-install routine SDEC745P will update the link to the Help Desk in the Help Pane to read VA Enterprise Service Desk (ESD) (855)-673-4357. This resides in HELP LINK TEXT multiple (#409.981) of the SDEC SETTINGS File (#409.98). It will also update the CURRENT GUI VERSION Field (#2) and the GUI VERSION EFFECTIVE DATE Field (#3) in the SDEC SETTINGS File (#409.98) to reflect the new GUI version 1.7.1 R1. Backout Plan: ------------ Restore the routines using the routine save set created when installing the patch. Delete the new items added to the SDSUP option (SDEC PENDING RTC - DATE and SDEC PENDING RTC - FULL) and delete the corresponding options. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 40 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDEC Before:B133763102 After:B136404289 **627,643,642,651,658,665,672, 679,686,694,745** Routine Name: SDEC08 Before:B226009434 After:B208402907 **627,651,658,665,722,740,744, 694,745** Routine Name: SDEC08A Before: n/a After: B5555377 **745** Routine Name: SDEC50 Before:B187919656 After:B189140313 **627,658,665,672,722,723,737, 694,745** Routine Name: SDEC51 Before:B175129662 After:B188351010 **627,642,651,658,686,745** Routine Name: SDEC52 Before:B179392596 After:B184547232 **627,642,651,658,745** Routine Name: SDEC52A Before: B58047562 After: B58375687 **627,658,694,745** Routine Name: SDEC53 Before:B224580253 After:B225419936 **627,658,679,745** Routine Name: SDEC745P Before: n/a After: B3820680 **745** Routine Name: SDECAR Before: B90430673 After: B92361326 **627,642,671,745** Routine Name: SDECAR1 Before:B182103175 After:B187704855 **627,642,658,686,694,745** Routine Name: SDECAR1A Before: B18726146 After: B50599861 **658,745** Routine Name: SDECAR2 Before:B203864151 After:B205445845 **627,642,658,671,686,694,745** Routine Name: SDECRTCF Before: n/a After: B41223478 **745** Routine Name: SDECWL Before:B106737488 After:B109501114 **627,642,665,672,694,745** Routine Name: SDECWL1 Before:B150057230 After:B155302120 **627,642,658,745** Routine Name: SDECWL2 Before:B133202461 After:B134481431 **627,642,658,665,694,745** Routine list of preceding patches: 694 ============================================================================= User Information: Entered By : Date Entered : MAR 19, 2020 Completed By: Date Completed: SEP 30, 2020 Released By : Date Released : OCT 01, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT