$TXT Created by ACKERMAN,NIEN-CHIN at DEV.DEV.FO-HINES.MED.VA.GOV (KIDS) on Monday, 06/21/04 at 09:08 ============================================================================= Run Date: JUN 30, 2004 Designation: MD*1*1 Package : MD - CLINICAL PROCEDURES Priority: Mandatory Version : 1 SEQ #1 Status: Released Compliance Date: JUL 31, 2004 ============================================================================= Subject: API FOR EKG DATA Category: - Routine - Enhancement (Mandatory) Description: ============ ************************************************************************ ATTENTION Clinical Procedures v.1.0 is a Controlled Release. Therefore, the compliance dates that are exported with released patches will ONLY apply to all sites that have installed and implemented Clinical Procedures in their Production Account. For the sites that have not installed or implemented Clinical Procedures, the compliance dates for all released patches will be 30 days AFTER each site has installed and implemented Clinical Procedures into its Production Account and has signed off with the Technical Support Office that the package is running successfully with at least one medical device in their Production Account. ************************************************************************ ASSOCIATED NOIS =============== N/A ASSOCIATED E3R ============== 18984 Test Sites ========== Bay Pines Test Lab (Cheyenne Cache/NT Platform) Big Spring Charleston Little Rock Memphis Northport Palo Alto Providence San Francisco (Tested KIDS Warning message) Washington Routine MDAPI1 provides the Application Program Interface to retrieve the Electrocardiogram data in file #691.5. Database Integration Agreement #3854 documents the Clinical Procedures interface provided by this patch. The following documents the input and output requirements for this interface. Entry Point: GET^MDAPI1(RESULTS,MDARDFN,MDSDT,MDEDT,MDFLDS) Input: RESULTS - the global ^TMP array in (Required) which to return results. MDARDFN - the patient DFN. (Required) MDSDT - the start date of the date (Required) range to return the data. This must be in FM internal format. MDEDT - the end date of the date (Required) range to return the data. This must be in FM internal format. MDFLDS - a list of fields from file #691.5 to (Required) be returned in RESULTS. MDFLDS should contain a list of fields delimited by ";" example: MDFLDS=".01;11;20..." Output: RESULTS (Passed by Reference) Global array returned in the FM DIQ call format. Example API call: S RESULTS="^TMP(""NAMESPACE"",$J)" D GET^MDAPI1(.RESULTS,162,2900101,3021001,".01;11") return: ^TMP("NAMESPACE",$J,file #,record ien_",",field #,"E")=Data ^TMP("NAMESPACE",$J,subfile #,entry #_","_record ien, field of the multiple,"E")=data Only the Electrocardiogram records in the following statuses will be returned in the list: RELEASED ON-LINE VERIFIED RELEASED OFF-LINE VERIFIED RELEASED NOT VERIFIED RELEASED ON-LINE VERIFIED OF SUPERSEDED RELEASED OFF-LINE VERIFIED OF SUPERSEDED ^TMP("NAMESPACE",$J,0) will equal one of the following, if the call failed: -1^No Patient DFN. -1^No Start Date Range. -1^No End Date Range. -1^Start Date greater than End Date. -1^No fields defined If a local variable is defined in RESULTS, ^TMP("MDAPI",$J,0) equals -1^Global TMP array only. If no return array defined,^TMP("MDAPI",$J,0) equals -1^No return array global. If no data, ^TMP("NAMESPACE",$J,0) equals -1^No data for patient. ROUTINE SUMMARY ================= The following is a list of the routine(s) included in this patch. The second line of each of these routine(s) will look like: ;;1.0;Clinical Procedures;**[patch list]**;Apr 1, 2004 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== ========== MDAPI1 N/A 2192084 **1** DOCUMENTATION ============= There are no documentation changes for this patch. INSTALLATION INSTRUCTIONS: ========================== Users may remain on the system but this patch should be installed at non-peak hours due to the high volume use of the routines included. Installation should take less than 3 minutes. 1. Use the INSTALL/CHECK MESSAGE option on the PackMan menu. 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 MD*1.0*1): a. Backup a Transport Global b. Compare Transport Global to Current System c. Verify Checksums in Transport Global 4. Use the Install Package(s) option and select the patch MD*1.0*1 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. 7. When prompted 'Delay Install (Minutes): (0-60): 0//', respond '0'. Routine Information: ==================== Routine Name: - MDAPI1 Routine Checksum: ============================================================================= User Information: Entered By : ACKERMAN,NIEN-CHIN Date Entered : AUG 14, 2002 Completed By: REZNIK,CHARMAINE Date Completed: JUN 30, 2004 Released By : THORNTON,NANCY Date Released : JUN 30, 2004 ============================================================================= Packman Mail Message: ===================== $END TXT