Home   Package List   Routine Alphabetical List   Global Alphabetical List   FileMan Files List   FileMan Sub-Files List   Package Component Lists   Package-Namespace Mapping  
Routine: GMVVDEF1

GMVVDEF1.m

Go to the documentation of this file.
  1. GMVVDEF1 ;BPOIFO/JG,HIOFO/FT - BUILD HL7 ORU^R01 MESSAGE FOR VITALS ; 20 Sep 2005 4:36 PM
  1. ;;5.0;GEN. MED. REC. - VITALS;**5,8,12,17,11**;Oct 31, 2002
  1. ;11/30/2005 KAM/BAY Remedy Calls 121661 and 122742 changes for HL7 message
  1. VALID ;;VDEF HL7 MESSAGE BUILDER
  1. ; Creates HL7 V2.4 ORU^R01 message for vitals
  1. ;
  1. ; This routine uses the following IAs:
  1. ; #93 - FILE 44 references (controlled)
  1. ; #557 - FILE 40.7 references (controlled)
  1. ; #2432 - FILE 44 references (controlled)
  1. ; #3630 - VAFCQRY calls (controlled)
  1. ; #4248 - VDEFEL calls (controlled)
  1. ; #4571 - VDEFREQ calls (controlled)
  1. ; #10035 - DPT( references (supported)
  1. ; #10040 - FILE 44 references (supported)
  1. ; #10112 - VASITE calls (supported)
  1. ;
  1. ; This routine is called at tag EN as a Function by VDEFREQ1
  1. ;
  1. Q
  1. ;
  1. EN(EVIEN,KEY,VFLAG,OUT,MSHP) ; Entry point
  1. ;
  1. ; Inputs: EVIEN = IEN of VDEF Event in file 577
  1. ; KEY - IEN of file to create message from
  1. ; VFLAG - "V" for VistA HL7 destination (default)
  1. ; OUT - target array, passed by reference
  1. ; MSHP - Piece 4 contains message subtype
  1. ;
  1. ; Output: Two part string with parts separated by "^"
  1. ; Part 1: "LM" - output in local array passed in "OUT" parameter
  1. ; "GM" - output in ^TMP("HLS",$J)
  1. ; Part 2: No longer used
  1. ;
  1. N DFN,HLFS,HLCM,HLSC,HLRP,HLES,HLQ,VTLDAT,UM,VTLTYP,DTE,DTP
  1. N VTLERR,VAL,I,S,X,XX,Y,QUALS,HL7RC,PIDSEG,IEN1,SEQ,STOPCD,EIEVUID
  1. N SEPF,SEPC,SEPR,SEPE,SEPS,VTLNAM,ARRAY,O2SUP,OUTX,ADD,VTLVUID
  1. ;
  1. ; Initialize stuff
  1. K ^TMP("HLS",$J) S S=0,ARRAY="OUT("_"""HLS"""_",S)",TARGET="LM^"
  1. ;
  1. ; Set up HL7 delimiters
  1. S HLCM=$E(VDEFHL("ECH")),HLRP=$E(VDEFHL("ECH"),2),HLSC=$E(VDEFHL("ECH"),4),HLES=$E(VDEFHL("ECH"),3)
  1. S HLFS=VDEFHL("FS"),HLQ=VDEFHL("Q"),HL7RC=HLES_HLFS_HLCM_HLRP_HLSC
  1. D SETDLMS^VDEFEL
  1. ;
  1. ; Get the vitals measurement record & patient ID
  1. S VTLDAT=$$EN^GMVHDR(KEY)
  1. I 'VTLDAT D ERR^VDEFREQ("Invalid data in file GMR(120.5) for IEN "_KEY) S ZTSTOP=1 G EXIT
  1. S DFN=$P(VTLDAT,U,2),VTLTYP=$P(VTLDAT,U,7)
  1. S VTLVUID=$$GET^GMVUID(120.51,.01,+VTLTYP_",") ;vital type vuid
  1. S O2SUP=$P(VTLDAT,U,10),VTLERR=$P(VTLDAT,U,11)
  1. S X=$P(VTLDAT,U,5) I +X'=X!(X<0) S $P(VTLDAT,U,5)=""
  1. S STOPCD=""
  1. I $P(VTLDAT,U,5)'="" D
  1. . S STOPCD=$P($G(^SC($P(VTLDAT,U,5),0)),U,7) Q:STOPCD=""
  1. . S STOPCD=$G(^DIC(40.7,STOPCD,0))
  1. . S STOPCD=$$HL7RC($P(STOPCD,U,2))_";"_$$HL7RC($P(STOPCD,U))
  1. ;
  1. ; Build segments for message in OUTX, $P # = HL7 field #
  1. ;
  1. ; PID - Use MPI PID builder
  1. PID K PIDSEG S OUTX="",S=1,SEQ=""
  1. I $G(^DPT(DFN,0))="" D ERR^VDEFREQ("No entry in file DPT for DFN "_DFN) S ZTSTOP=1 G EXIT
  1. D BLDPID^VAFCQRY(DFN,1,SEQ,.PIDSEG,.VDEFHL)
  1. F I=2:1 Q:$G(PIDSEG(I))="" S PIDSEG(1,I-1)=PIDSEG(I) K PIDSEG(I)
  1. M OUTX=PIDSEG(1) K PIDSEG D SAVE
  1. ;
  1. ; ORC
  1. ORC S S=S+1,OUTX="RE"
  1. ;
  1. ; Filler ID
  1. S X=KEY_HLCM_$$HL7RC($P(SITEPARM,U,6))_"_120.5",$P(OUTX,HLFS,3)=X
  1. ;
  1. ; Enterer's location
  1. I $P(VTLDAT,U,5)'="" D
  1. . S X=$G(^SC($P(VTLDAT,U,5),0)),VAL=$$HL7RC($P(X,U,2))_HLCM_$P(VTLDAT,U,5)
  1. . S $P(VAL,HLCM,9)=$$HL7RC($P(X,U)),$P(OUTX,HLFS,13)=VAL
  1. . I +$P(X,U,15) S X=$$SITE^VASITE($P(VTLDAT,U),$P(X,U,15)) S:X=-1 X=""
  1. . E S X=""
  1. . S VAL=$$HL7RC($P(X,U,3))_HLCM_$$HL7RC($P(X,U,2))_HLCM_"L",$P(OUTX,HLFS,17)=VAL
  1. ; Parent Facility (Added 04/17/2006)
  1. S $P(OUTX,HLFS,21)=$P($$SITE^VASITE(),"^",2)
  1. ;
  1. S VAL=$P(OUTX,HLFS,3),OUTX="ORC"_HLFS_OUTX D SAVE
  1. ;
  1. ; OBR
  1. OBR S S=S+1,OUTX="",VTLNAM=$$HL7RC($P(^GMRD(120.51,VTLTYP,0),U))
  1. S X=VTLVUID_HLCM_VTLNAM_HLCM_$$HL7RC("99VA120.51")
  1. ;
  1. ; Add filler ID from ORC-3 & Procedure name
  1. S $P(OUTX,HLFS,3)=VAL,$P(OUTX,HLFS,4)=X
  1. ;
  1. ; Dates/times vital taken & entered
  1. S DTP=$$HL7RC($$TS^VDEFEL($P(VTLDAT,U))),$P(OUTX,HLFS,7)=DTP
  1. S DTE=$$HL7RC($$TS^VDEFEL($P(VTLDAT,U,4))),$P(OUTX,HLFS,8)=DTE
  1. ;
  1. ; Use date/time vital entered for results reported
  1. S $P(OUTX,HLFS,22)=DTE
  1. ;
  1. ; Set result status to Final or Error if entered in error
  1. S $P(OUTX,HLFS,25)=$E("FE",VTLERR'=""+1)
  1. ;
  1. ; Technician name
  1. S XX=$$XCN200^VDEFEL($P(VTLDAT,U,6))
  1. F II=2:1:7 S $P(XX,SEPC,II)=$$HL7RC($P(XX,SEPC,II))
  1. S $P(OUTX,HLFS,34)=XX
  1. S OUTX="OBR"_HLFS_OUTX D SAVE
  1. ;
  1. ; OBX 1 - Vital name
  1. OBX1 S S=S+1,OUTX=HLFS_"ST"
  1. ;
  1. ; Observation ID - Vital name
  1. S X=VTLVUID_HLCM_VTLNAM_HLCM_$$HL7RC("99VA120.51"),$P(OUTX,HLFS,3)=X
  1. ;
  1. ; Unit of measure
  1. ; If vital not performed, set units to null
  1. S UM=$$HL7RC($P(VTLDAT,U,9)) S:$F("Pass Refused Unavailable",$P(VTLDAT,U,8))>0 UM=""
  1. S UM=UM_HLCM_UM_HLCM_"L"
  1. ;
  1. ; Set sub-id if O2 supplements to follow
  1. S:O2SUP'="" $P(OUTX,HLFS,4)=1
  1. S $P(OUTX,HLFS,5)=$$HL7RC($P(VTLDAT,U,8)),$P(OUTX,HLFS,6)=UM
  1. ;
  1. ; Set result status to Final or Wrong if errors entered
  1. S $P(OUTX,HLFS,11)=$E("FW",VTLERR'=""+1)
  1. S XX=$$XCN200^VDEFEL($P(VTLDAT,U,6))
  1. F II=2:1:7 S $P(XX,SEPC,II)=$$HL7RC($P(XX,SEPC,II))
  1. S $P(OUTX,HLFS,16)=XX
  1. S OUTX="OBX"_HLFS_OUTX D SAVE
  1. ;
  1. ; OBX2 - O2 Supplement
  1. OBX2 G QUALS:O2SUP="" S (VAL,UM)=""
  1. S S=S+1,OUTX=HLFS_"ST"_HLFS_"O2 Supplement" D
  1. . I O2SUP["%",O2SUP'["l/min" S VAL=+O2SUP,UM="%" Q
  1. . I O2SUP'["%",O2SUP["l/min" S VAL=+O2SUP,UM="l/min"
  1. . I O2SUP["%",O2SUP["l/min" S $P(VAL,U)=$P(O2SUP," "),$P(UM,U)="l/min",$P(VAL,U,2)=+$P(O2SUP," ",3),$P(UM,U,2)="%"
  1. S X=$P(UM,U),X=X_HLCM_X_HLCM_"L",$P(UM,U)=X
  1. I $P(UM,U,2)'="" S X=$P(UM,U,2),X=X_HLCM_X_HLCM_"L",$P(UM,U,2)=X
  1. S $P(OUTX,HLFS,4)=2,$P(OUTX,HLFS,5)=$P(VAL,U,1),$P(OUTX,HLFS,6)=$P(UM,U)
  1. ;
  1. ; Set result status to Final or Wrong if errors entered
  1. S $P(OUTX,HLFS,11)=$E("FW",VTLERR'=""+1)
  1. S OUTX="OBX"_HLFS_OUTX,X=OUTX D SAVE
  1. ; If more than one O2 supplement, add another OBX
  1. ; Field offset in OUT is now +1 because OBX has been added
  1. S OUTX=X I $P(VAL,U,2)'="" D
  1. . S S=S+1,$P(OUTX,HLFS,5)=3,$P(OUTX,HLFS,6)=$P(VAL,U,2),$P(OUTX,HLFS,7)=$P(UM,U,2)
  1. . D SAVE
  1. ;
  1. ; Qualifiers
  1. QUALS S QUALS="",X=$O(^GMR(120.5,KEY,5,0)) G ERRS:X=""
  1. S S=S+1,OUTX=HLFS_"CE"_HLFS_"Qualifiers"_HLFS_HLFS
  1. ;
  1. ; Get qualifiers
  1. S IEN1=0 F S IEN1=$O(^GMR(120.5,KEY,5,IEN1)) Q:'+IEN1 D
  1. . S X=^GMR(120.5,KEY,5,IEN1,0),VAL=$$HL7RC($P(^GMRD(120.52,X,0),U))
  1. . S X=$$GET^GMVUID(120.52,.01,+X_",") ;qualifier vuid
  1. . S VAL=X_HLCM_VAL_HLCM_$$HL7RC("99VA120.52"),QUALS=QUALS_VAL_HLRP
  1. ;
  1. ; Set result
  1. S $P(OUTX,HLFS,5)=$E(QUALS,1,$L(QUALS)-1)
  1. ;
  1. ; Set result status to Final or Wrong if errors entered
  1. S $P(OUTX,HLFS,11)=$E("FW",VTLERR'=""+1)
  1. S OUTX="OBX"_HLFS_OUTX D SAVE
  1. ;
  1. ; Entered in Error
  1. ERRS G ZSC:VTLERR="" S S=S+1,OUTX=HLFS_"CE"_HLFS_"Error Reasons"_HLFS_HLFS
  1. ;
  1. ; Error data reason(s)
  1. S X=$P(VTLDAT,U,13),VAL=""
  1. F I=1:1:$L(X,"~") D
  1. .S Y=$P(X,"~",I)
  1. .S EIEVUID=$$GET^GMVUID(120.506,.01,$P(Y,"-",1)) ;error vuid
  1. .S VAL=VAL_$$HL7RC(EIEVUID)_HLCM_$$HL7RC($P(Y,"-",2))_HLCM_$$HL7RC("99VA8985.1")_HLRP
  1. S VAL=$E(VAL,1,$L(VAL)-1),$P(OUTX,HLFS,5)=VAL
  1. ;
  1. ; Set result status to Final or Wrong if errors entered
  1. S $P(OUTX,HLFS,11)=$E("FW",VTLERR'=""+1)
  1. ;
  1. ; Entered in error by technician
  1. S XX=$$XCN200^VDEFEL($P(VTLDAT,U,12))
  1. F II=2:1:7 S $P(XX,SEPC,II)=$$HL7RC($P(XX,SEPC,II))
  1. S $P(OUTX,HLFS,16)=XX
  1. S OUTX="OBX"_HLFS_OUTX D SAVE
  1. ;
  1. ; Stop Code & Name
  1. ZSC G EXIT:STOPCD=""
  1. S S=S+1,OUTX=HLFS_$P(STOPCD,";")_HLFS_$P(STOPCD,";",2)
  1. S OUTX="ZSC"_HLFS_OUTX D SAVE
  1. ;
  1. ; Done building segments
  1. EXIT Q TARGET
  1. ;
  1. ;
  1. ; Place current string into message array.
  1. ; Turn string into array if length >245.
  1. ; Move local array to global if needed.
  1. SAVE N I
  1. I $P(OUTX,HLFS)'="PID",$L(OUTX)>245 D
  1. . K ADD S ADD=$E(OUTX,1,245),OUTX=$E(OUTX,246,$L(OUTX))
  1. . F I=1:1 S ADD(I)=$E(OUTX,1,245),OUTX=$E(OUTX,246,$L(OUTX)) Q:OUTX=""
  1. . K OUTX M OUTX=ADD
  1. M @ARRAY=OUTX
  1. ;
  1. ; Move local array to global if it's getting big.
  1. I $P(TARGET,U)="LM",$S<16000 D
  1. . K ^TMP("HLS",$J) M ^TMP("HLS",$J)=OUT("HLS") K OUT("HLS")
  1. . S $P(TARGET,U)="GM",ARRAY="^TMP("_"""HLS"""_",$J,S)"
  1. K OUTX,ADD
  1. Q
  1. ;
  1. ; Replace any HL7 coding chars. in strings with HL7 escape sequence
  1. ; Input: X = data string
  1. HL7RC(X) N OCHR,RCHR,RCHRI,TYPE,I F TYPE="E","F","C","R","S" D
  1. . S RCHRI=$S(TYPE="E":1,TYPE="F":2,TYPE="C":3,TYPE="R":4,TYPE="S":5)
  1. . S OCHR=$E(HL7RC,RCHRI),RCHR=$E("EFSRT",RCHRI)
  1. . Q:'$F(X,OCHR)
  1. . F I=1:1 Q:$E(X,I)="" I $E(X,I)=OCHR S X=$E(X,1,I-1)_HLES_RCHR_HLES_$E(X,I+1,999),I=I+2
  1. Q X