============================================================================= Run Date: MAR 09, 2021 Designation: PXRM*2*44 Package : PXRM - CLINICAL REMINDERS Priority: Mandatory Version : 2 SEQ #57 Status: Released Compliance Date: APR 09, 2021 ============================================================================= Associated patches: (v)PXRM*2*47 <<= must be installed BEFORE `PXRM*2*44' Subject: PREVIOUS ENCOUNTER DIAGNOSIS API Category: - Routine Description: ============ General Overview: ----------------- PREVIOUS ENCOUNTER DIAGNOSIS 1.0 is a multi-package build which introduces the previous diagnoses enhancements that are documented in NSR 20160107: Problem List Diagnosis Menu. Within Encounters, users have several options to enter diagnoses codes using Encounter Forms, Problem List Items, or adding a new diagnosis through the Lexicon Search which has become daunting and very time consuming with the ICD-10 Update project. This request recommends adding the ability for users to view previous diagnoses of completed encounters on a patient record. PREVIOUS ENCOUNTER DIAGNOSIS 1.0 contains the builds: PXRM*2.0*44 and OR*3.0*476. PXRM*2.0*44 releases the API: $$PRENDIAG^PXRMPDX(DFN,BDT,ENCDATE,.DIAGLIST). It is called from ORWPCE to obtain the list of the patient's previous diagnosis. The ICR for this API is #6991. This API searches the V POV file for previous encounter diagnoses for a patient using the Clinical Reminders Index. The arguments are: DFN - The patient BDT - Each V POV entry has an associated date, this is the Event Date and Time and if that does not exist it is the Visit/Admit Date&Time. This argument specifies how far back to start the search. It can be any valid FileMan date and including symbolic dates of the form T-NX where N is an integer and X can be one of the following: D = days M = months Y = years T-3M would start the search three months prior to today, T-2Y would start the search 2 years prior to today. ENCDATE - The encounter date, only diagnoses that are active as of the encounter date will be returned. DIAGLIST - The list of diagnoses that were found, this is in a format that is compatible with the API GETLST^IBDF18A so that the list created by this API can be passed into GETLST^IBDF18A and have the additional diagnoses defined for a specified encounter form added to the list. DIAGLIST(0)=The number that were found DIAGLIST(1)="^PREVIOUS ENCOUNTER DIAGNOSES" DIAGLIST(2) to DIAGLIST(2+number found) An "^" separated string where Piece 1 is the code Piece 2 is the short description of the code Piece 9 is the code pointer, the internal entry number of the code in file #80 Piece 10 is the long description of the code If no diagnoses are found, then DIAGLIST(2)="^None found" The return values are: -1 - The Clinical Reminders Index for V POV is missing so the search cannot be performed N - The number of diagnoses that were found For a diagnosis to be added to the list it must be associated with an encounter that has a status of "CHECKED OUT". OR*3.0*476 updates the routine ORWPCE to call PRENDIAG^PXRMPDX to obtain the list of the patient's previous diagnoses and passes them to CPRS so the user can view and select previous encounter diagnoses. Test Sites: =========== Salisbury Wilmington Software & Documentation Retrieval Instructions: ================================================ The software for this patch is being distributed as a host file, the name of the host file is: PREVIOUS_ENCOUNTER_DIAGNOSIS_1_0.KID. The host file is available at the following location: /srv/vista/patches/SOFTWARE/PREVIOUS_ENCOUNTER_DIAGNOSIS_1_0.KID If the above link is not functional, this URL can be used to retrieve the host file: https://download.vista.domain.ext/index.html/SOFTWARE In Chrome and Edge, right click on PREVIOUS_ENCOUNTER_DIAGNOSIS_1_0.KID and use Save link as. There is no documentation for this build. Build Components: ================= Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- None Forms Associated: ----------------- None Mail Groups Associated: ----------------------- None Options Associated: ------------------- None Protocols Associated: --------------------- None Security Keys Associated: ------------------------- None Templates Associated: --------------------- None Additional Information: New Service Requests (NSRs): ---------------------------- 20160107 Patient Safety Issues (PSIs): ----------------------------- None Service Now Ticket(s) & Overview: --------------------------------- None Pre/Post Installation Overview: =============================== None Installation Instructions: ========================== Required builds: OR*3.0*377 PXRM*2.0*47 This build can be installed with users on the system, but it should be done during off-hours. Estimated installation time is less than 5 minutes. 1. Use the 'Load a Distribution' option on the KIDS installation menu. When prompted to enter a host file type in: [DIRECTORY]PREVIOUS_ENCOUNTER_DIAGNOSIS_1_0.KID Where DIRECTORY is the full path to where the host file is stored. 2. On the KIDS Installation menu use the following options: Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. When you select this option you will see the following prompt: Only a Single Package Build can do a Build Backup. PREVIOUS ENCOUNTER DIAGNOSIS 1.0 is of type Multi-Package You can only Backup the Routines. Select one of the following: R Routines Enter response: Select "R" as the response. If desired you may use the following options: Print Transport Global - This option will allow you to view the components of the KIDs build. Compare Transport Global to Current System - This option will allow you to view all the changes that will be made when the build is installed. 3. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//", respond 'NO'. 4. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//", respond 'NO'. 5. When prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//", respond 'NO'. 6. When prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// respond 'NO'. Routine Information: ==================== The second line of each of these routines now looks like: ;;2.0;CLINICAL REMINDERS;**[Patch List]**;Feb 04, 2005;Build 10 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PXRMPDX Before: n/a After: B3900777 **44** ============================================================================= User Information: Entered By : Date Entered : MAR 26, 2014 Completed By: Date Completed: MAR 05, 2021 Released By : Date Released : MAR 09, 2021 ============================================================================= Packman Mail Message: ===================== No routines included