| 1 | MAGDTR01 ;WOIFO/PMK - Unread List for Consult/Procedure Request ; 20 Sep 2006  9:04 AM | 
|---|
| 2 | ;;3.0;IMAGING;**46**;16-February-2007;;Build 1023 | 
|---|
| 3 | ;; Per VHA Directive 2004-038, this routine should not be modified. | 
|---|
| 4 | ;; +---------------------------------------------------------------+ | 
|---|
| 5 | ;; | Property of the US Government.                                | | 
|---|
| 6 | ;; | No permission to copy or redistribute this software is given. | | 
|---|
| 7 | ;; | Use of unreleased versions of this software requires the user | | 
|---|
| 8 | ;; | to execute a written test agreement with the VistA Imaging    | | 
|---|
| 9 | ;; | Development Office of the Department of Veterans Affairs,     | | 
|---|
| 10 | ;; | telephone (301) 734-0100.                                     | | 
|---|
| 11 | ;; | The Food and Drug Administration classifies this software as  | | 
|---|
| 12 | ;; | a medical device.  As such, it may not be changed in any way. | | 
|---|
| 13 | ;; | Modifications to this software may result in an adulterated   | | 
|---|
| 14 | ;; | medical device under 21CFR820, the use of which is considered | | 
|---|
| 15 | ;; | to be a violation of US Federal Statutes.                     | | 
|---|
| 16 | ;; +---------------------------------------------------------------+ | 
|---|
| 17 | ;; | 
|---|
| 18 | ENTRY ; entry point from ^MAGDHWC for a consult request | 
|---|
| 19 | N GMRCSTS ;-- GMRC request status | 
|---|
| 20 | N RESULT ;--- scratch variable | 
|---|
| 21 | ; | 
|---|
| 22 | ; check for an "OK" order control value in the ORC segment | 
|---|
| 23 | I $P(HL7ORC,DEL)="OK" D  Q  ; new order | 
|---|
| 24 | . D ADD^MAGDTR03(.RESULT,GMRCIEN,"O") ; add if "on order" is set | 
|---|
| 25 | . Q | 
|---|
| 26 | ; | 
|---|
| 27 | ; check for a discontinued order | 
|---|
| 28 | I " CA CR DC DR OC OD "[(" "_$P(HL7ORC,DEL)_" ") D  Q | 
|---|
| 29 | . D CANCEL^MAGDTR03 ; record the order as cancelled | 
|---|
| 30 | . Q | 
|---|
| 31 | ; | 
|---|
| 32 | ; check for a FORWARD in the ORC segment | 
|---|
| 33 | I $P($P(HL7ORC,DEL,16),DEL2,5)="FORWARD" D  Q | 
|---|
| 34 | . D FORWARD^MAGDTR02 ; handle forward for Unread List | 
|---|
| 35 | . Q | 
|---|
| 36 | ; | 
|---|
| 37 | ; drive it off the GMRC request status | 
|---|
| 38 | S GMRCSTS=$$GET1^DIQ(123,GMRCIEN,8) | 
|---|
| 39 | I (GMRCSTS="PENDING")!(GMRCSTS="ACTIVE") D  Q | 
|---|
| 40 | . D ADD^MAGDTR03(.RESULT,GMRCIEN,"O") ; add if "on order" is set | 
|---|
| 41 | . Q | 
|---|
| 42 | I GMRCSTS="COMPLETE" D  Q | 
|---|
| 43 | . D COMPLETE^MAGDTR03 ; tag study as completed | 
|---|
| 44 | . Q | 
|---|
| 45 | I (GMRCSTS="CANCELLED")!(GMRCSTS="DISCONTINUED") D  Q | 
|---|
| 46 | . D CANCEL^MAGDTR03 ; tag study as cancelled | 
|---|
| 47 | . Q | 
|---|
| 48 | Q | 
|---|
| 49 | ; | 
|---|
| 50 | ORRIN ; entry point for processing IFC responses | 
|---|
| 51 | N MAGETLVL,$ET | 
|---|
| 52 | S $ET="D ORRINER1^"_$T(+0),MAGETLVL=$ST+1 | 
|---|
| 53 | D ORRINPRC | 
|---|
| 54 | Q | 
|---|
| 55 | ; | 
|---|
| 56 | ORRINER1 ; Log the error | 
|---|
| 57 | D ^%ZTER | 
|---|
| 58 | S $ET="D ORRINER2^"_$T(+0) | 
|---|
| 59 | I $ST>MAGETLVL Q:$Q "" Q | 
|---|
| 60 | S $EC="" | 
|---|
| 61 | Q | 
|---|
| 62 | ; | 
|---|
| 63 | ORRINER2 ; Unwind | 
|---|
| 64 | I $ST>MAGETLVL Q:$Q "" Q | 
|---|
| 65 | S $EC="" | 
|---|
| 66 | Q | 
|---|
| 67 | ; | 
|---|
| 68 | ORRINPRC ; | 
|---|
| 69 | ; this is "piggy-backed" onto the GMRC IFC ORM EVENT protocol | 
|---|
| 70 | ; see the RESPONSE PROCESSING ROUTINE for this protocol | 
|---|
| 71 | ; the HL7 event handler first invokes ORRIN^GMRCIMSG and then this | 
|---|
| 72 | ; | 
|---|
| 73 | N GMRCIEN ;-- IEN of consult | 
|---|
| 74 | N ORDCTRL ;-- order control code from ORC segment | 
|---|
| 75 | N UNREAD ;--- IEN of entry on ^MAG(2006.5849) | 
|---|
| 76 | N TIMESTMP ;- FileMan time stamp of unread item | 
|---|
| 77 | N LISTDATA ;- unread list info from ^MAG(2006.5849) | 
|---|
| 78 | N ACQSITE ;-- acquisition site | 
|---|
| 79 | N IPROCIDX ;- procedure index | 
|---|
| 80 | N ISPECIDX ;- specialty index | 
|---|
| 81 | ; | 
|---|
| 82 | D GETHL7A^MAGDTR01(.ORDCTRL,.GMRCIEN) Q:ORDCTRL'="OK" | 
|---|
| 83 | Q:'$$FINDLIST^MAGDTR01(GMRCIEN)  ; not in unread list | 
|---|
| 84 | S UNREAD=$$UNREAD^MAGDTR02(GMRCIEN) Q:'UNREAD   ; not there yet | 
|---|
| 85 | S TIMESTMP=$$TIMESTMP^MAGDTR02(UNREAD) ; update the timestamp | 
|---|
| 86 | S LISTDATA=^MAG(2006.5849,UNREAD,0) | 
|---|
| 87 | ; record time of IFC response | 
|---|
| 88 | S:$P(LISTDATA,"^",6)="" $P(^MAG(2006.5849,UNREAD,0),"^",6)=TIMESTMP | 
|---|
| 89 | ; now change status to "Unread", if it was a "Waiting" previously | 
|---|
| 90 | I $P(LISTDATA,"^",11)="W" D  ; switch status and update cross reference | 
|---|
| 91 | . S $P(^MAG(2006.5849,UNREAD,0),"^",11)="U" | 
|---|
| 92 | . S ACQSITE=$P(LISTDATA,"^",2),ISPECIDX=$P(LISTDATA,"^",3) | 
|---|
| 93 | . S IPROCIDX=$P(LISTDATA,"^",4) | 
|---|
| 94 | . K ^MAG(2006.5849,"D",ACQSITE,ISPECIDX,IPROCIDX,"W",UNREAD) | 
|---|
| 95 | . S ^MAG(2006.5849,"D",ACQSITE,ISPECIDX,IPROCIDX,"U",UNREAD)="" | 
|---|
| 96 | . Q | 
|---|
| 97 | Q | 
|---|
| 98 | ; | 
|---|
| 99 | GETHL7A(STATUS,GMRCIEN) ; get data from HL7 message - called from above | 
|---|
| 100 | ; input:  none | 
|---|
| 101 | ; output:  PERSON     name of person ordering the consult | 
|---|
| 102 | ;          LOCATION   IEN of the location from which the consult is ordered | 
|---|
| 103 | ; | 
|---|
| 104 | N HL7PARSE ;- name of parsed HL7 array defined by GETHL7 | 
|---|
| 105 | N HL7RAW ;--- name of raw HL7 array defined by GETHL7 | 
|---|
| 106 | N HL7SEGNO ;- segment number index returned by $$GETSEG^MAGDHRC0 | 
|---|
| 107 | ; | 
|---|
| 108 | D GETHL7 | 
|---|
| 109 | S (STATUS,GMRCIEN)="" | 
|---|
| 110 | S HL7SEGNO=$$GETSEG^MAGDHRC0("ORC") | 
|---|
| 111 | I HL7SEGNO D | 
|---|
| 112 | . S STATUS=$$GETDATA^MAGDHRC0(1) | 
|---|
| 113 | . S GMRCIEN=$$GETDATA^MAGDHRC0(2,1,1) | 
|---|
| 114 | . Q | 
|---|
| 115 | K @HL7PARSE | 
|---|
| 116 | Q | 
|---|
| 117 | ; | 
|---|
| 118 | GETHL7B(PERSON,LOCATION) ; get data from HL7 message - call from ^MAGDTR03 | 
|---|
| 119 | ; input:  none | 
|---|
| 120 | ; output:  PERSON     name of person ordering the consult | 
|---|
| 121 | ;          LOCATION   IEN of the location from which the consult is ordered | 
|---|
| 122 | ; | 
|---|
| 123 | N HL7PARSE ;- name of parsed HL7 array defined by GETHL7 | 
|---|
| 124 | N HL7RAW ;--- name of raw HL7 array defined by GETHL7 | 
|---|
| 125 | N HL7SEGNO ;- segment number index returned by $$GETSEG^MAGDHRC0 | 
|---|
| 126 | N IPERSON ;-- field number in ORC segment that contains responsible/entered-by person | 
|---|
| 127 | ; | 
|---|
| 128 | D GETHL7 | 
|---|
| 129 | K PERSON S LOCATION="" | 
|---|
| 130 | S HL7SEGNO=$$GETSEG^MAGDHRC0("ORC") | 
|---|
| 131 | ; get "responsible person" from ORC-12 or "entered by" person from ORC-10 | 
|---|
| 132 | S IPERSON=$S($$GETDATA^MAGDHRC0(12)="":10,1:12) | 
|---|
| 133 | S PERSON("FAMILY")=$$GETDATA^MAGDHRC0(IPERSON,1,1) | 
|---|
| 134 | S PERSON("GIVEN")=$$GETDATA^MAGDHRC0(IPERSON,1,2) | 
|---|
| 135 | S PERSON("MIDDLE")=$$GETDATA^MAGDHRC0(IPERSON,1,3) | 
|---|
| 136 | S PERSON("SUFFIX")=$$GETDATA^MAGDHRC0(IPERSON,1,4) | 
|---|
| 137 | S PERSON=PERSON("FAMILY") | 
|---|
| 138 | I PERSON("GIVEN")'="" S PERSON=PERSON_","_PERSON("GIVEN") | 
|---|
| 139 | I PERSON("MIDDLE")'="" S PERSON=PERSON_" "_PERSON("MIDDLE") | 
|---|
| 140 | I PERSON("SUFFIX")'="" S PERSON=PERSON_" "_PERSON("SUFFIX") | 
|---|
| 141 | ; location of the consult is in OBX-5.3(?) | 
|---|
| 142 | S HL7SEGNO=$$GETSEG^MAGDHRC0("OBX") | 
|---|
| 143 | S:HL7SEGNO LOCATION=$$IEN^XUAF4($$GETDATA^MAGDHRC0(5,1,3)) | 
|---|
| 144 | K @HL7PARSE | 
|---|
| 145 | Q | 
|---|
| 146 | ; | 
|---|
| 147 | GETHL7 ; get data from HL7 message | 
|---|
| 148 | ; called from above and also called from ^MAGDTR03 | 
|---|
| 149 | ; | 
|---|
| 150 | ; returns: HL7PARSE (name of parsed HL7 array) | 
|---|
| 151 | ;          HL7RAW   (name of array of unparsed HL7 segments) | 
|---|
| 152 | ; | 
|---|
| 153 | N HLNODE ;--- a full HL7 segment returned by X HLNEXT | 
|---|
| 154 | N I ;-------- scratch array index | 
|---|
| 155 | N X ;-------- dummy status return from $$PARSE^MAG7UP | 
|---|
| 156 | ; | 
|---|
| 157 | S HL7PARSE=$NAME(^TMP("MAG",$J,"HL7","PARSED")) | 
|---|
| 158 | S HL7RAW="HL7RAW" | 
|---|
| 159 | K @HL7PARSE ; initialize the destination global | 
|---|
| 160 | ; copy HL7 message from ^TMP to HL7RAW global array | 
|---|
| 161 | F I=1:1 X HLNEXT Q:HLQUIT'>0  S @HL7RAW@(I)=HLNODE | 
|---|
| 162 | S X=$$PARSE^MAG7UP(HL7RAW,HL7PARSE) ; build the parsed HL7 array | 
|---|
| 163 | Q | 
|---|
| 164 | ; | 
|---|
| 165 | FINDLIST(GMRCIEN,ISPECIDX,IPROCIDX,ACQSITE,TRIGGER,TIUNOTE,ALTSERV) ; | 
|---|
| 166 | ; find the read/unread list for this consult | 
|---|
| 167 | N CONSPROC,PROC,TOSERV,X,XREF | 
|---|
| 168 | S (ISPECIDX,IPROCIDX,ACQSITE,TRIGGER,TIUNOTE)="" | 
|---|
| 169 | Q:'$G(GMRCIEN) 0 | 
|---|
| 170 | S TOSERV=$G(ALTSERV) ; optional argument | 
|---|
| 171 | I TOSERV="" S TOSERV=+$$GET1^DIQ(123,GMRCIEN,1,"I") | 
|---|
| 172 | S CONSPROC=$$GET1^DIQ(123,GMRCIEN,13,"I") | 
|---|
| 173 | S PROC=$S(CONSPROC="C":"",1:$$GET1^DIQ(123,GMRCIEN,4,"I")) | 
|---|
| 174 | S XREF=$O(^MAG(2006.5841,"AC",TOSERV,+PROC,"")) | 
|---|
| 175 | I 'XREF Q 0 ; no read/unread list | 
|---|
| 176 | S X=$G(^MAG(2006.5841,XREF,0)) | 
|---|
| 177 | S ISPECIDX=$P(X,"^",3),IPROCIDX=$P(X,"^",4),ACQSITE=$P(X,"^",5) | 
|---|
| 178 | S TRIGGER=$P(X,"^",6),TIUNOTE=$P(X,"^",7) | 
|---|
| 179 | Q XREF | 
|---|
| 180 | ; | 
|---|