- LA7VPID ;DALOI/JMC - HL7 PID/PV1 segment builder utility ;08/03/09 15:59
- ;;5.2;AUTOMATED LAB INSTRUMENTS;**46,64,74**;Sep 27, 1994;Build 229
- ;
- ; Reference to routine $$EN^VAFHLPID supported by DBIA# 263
- ;
- PID(LRDFN,LA7EXTID,LA7ARRAY,LA7PIDSN,HL,LA7ALTID) ; Build PID segment
- ; Call with LRDFN = Lab DFN, passed by value
- ; LA7EXTID = to return as external patient id, id used by non-VA systems (optional)
- ; LA7ARRAY = array to return PID array, pass by reference
- ; LA7PIDSN = PID id counter, passed by value
- ; HL = HL7 variable array, pass by reference
- ; LA7ALTID = return alternate patient id, id used by non-va systems (optional)
- ;
- ; Returns LA7ARRAY
- ;
- N DFN,HLQ,LA763,LA7Y,LRDPF,VAFPID
- ;
- ; Change HLQ - VAFHLPID puts delete indicator when Vista has no value for field - not according to standard.
- S HLQ=""
- ;
- I $G(LRDFN)=""!($G(HL("FS"))="") Q
- I '$D(^LR(LRDFN,0)) Q
- ;
- S LA7EXTID=$G(LA7EXTID),LA7ALTID=$G(LA7ALTID),LA7PIDSN=$G(LA7PIDSN)+1
- S LA763(0)=$G(^LR(LRDFN,0))
- S LRDPF=$P(LA763(0),"^",2),DFN=$P(LA763(0),"^",3)
- ;
- ; Patient file - use VAF call
- I LRDPF=2 D F2PID
- ;
- ; Non-patient file
- I LRDPF'=2 D NF2PID
- K AGE,PNM,SEX,DOB,SSN,VA200,LRWRD,LRRB,LRTREA,VA
- Q
- ;
- ;
- PV1(LRDFN,LA7ARRAY,LA7FS,LA7ECH) ; Build PV1 segment
- ; Call with LRDFN = ien of entry in File #63
- ; LA7ARRAY = array to return PV1 array, pass by reference
- ; LA7FS = HL field separator
- ; LA7ECH = HL encoding characters
- ;
- ;
- N DFN,LA763,LA7LOC,LRDPF,LA7Y
- S LA763(0)=$G(^LR(LRDFN,0))
- S LRDPF=$P(LA763(0),"^",2),DFN=$P(LA763(0),"^",3),LA7LOC=""
- ;
- S LA7Y(0)="PV1"
- S LA7Y(1)=1
- ;
- ; Referral file with Patient file link.
- I LRDPF=67,$P($G(^LRT(67,DFN,"DPT")),"^") D
- . S LRDPF=2
- . S DFN=$P($G(^LRT(67,DFN,"DPT")),"^")
- ;
- ; Determine patient class
- ; Current inpatient location
- I LRDPF=2 S LA7LOC=$G(^DPT(DFN,.1))
- I $L(LA7LOC) S LA7Y(2)="I" ; Inpatient
- ;
- ; Otherwise from lab files
- I $G(LA7LOC)="" D
- . S LA7LOC=$G(^LR(LRDFN,.1))
- . S LA7Y(2)="O" ; Default to outpatient
- ;
- ; Patient location
- S LA7LOC=$$CHKDATA^LA7VHLU3(LA7LOC,LA7FS_LA7ECH)
- S LA7Y(3)=LA7LOC
- ;
- D BUILDSEG^LA7VHLU(.LA7Y,.LA7ARRAY,LA7FS)
- Q
- ;
- ;
- F2PID ; Build patient identifier field on file #2 patient
- ;
- ; Non VA users of VistA need to send patient's address
- N I,ICN,LA7X,LRSTR,X
- S LA7STR="1,5,6,7,8,10NTB,"_$S(DUZ("AG")="V":"",1:"11,")_"16,19"
- S LA7ARRAY(0)=$$EN^VAFHLPID(DFN,LA7STR,LA7PIDSN,3)
- ;
- ; Check for overflow (>245)
- I $O(VAFPID(0)) D
- . S I=0
- . F S I=$O(VAFPID(I)) Q:'I S LA7ARRAY(I)=VAFPID(I)
- ;
- ; Return external identifier in PID-2 sequence, backward compatibility to V2.2
- I LA7EXTID'="" D
- . I '(LA7EXTID?1N.N) S $P(LA7ARRAY(0),HL("FS"),3)=LA7EXTID
- . E S $P(LA7ARRAY(0),HLFS,3)=$$M11^HLFNC(LA7EXTID,HL("ECH"))
- ;
- ; Send SSN as patient identifier
- S X=$P(LA7ARRAY(0),HLFS,4)
- I $P(X,$E(HL("ECH")),5)="SS" S $P(X,$E(HL("ECH")),1)=$TR($P(X,$E(HL("ECH")),1),"-",""),$P(LA7ARRAY(0),HLFS,4)=X
- ;
- ; Send DFN as patient identifier
- S X=$$M11^HLFNC(DFN,HL("ECH"))
- S $P(X,$E(HL("ECH")),5)="PI"
- S $P(X,$E(HL("ECH")),6)=$$RETFACID^LA7VHLU2(+$$KSP^XUPARAM("INST"),2,1)_$E(HL("ECH"),4)_$$KSP^XUPARAM("WHERE")_$E(HL("ECH"),4)_"DNS"
- S $P(LA7ARRAY(0),HLFS,4)=$P(LA7ARRAY(0),HL("FS"),4)_$E(HL("ECH"),2)_X
- ;
- ; Send ICN from MPI as patient identifier
- S ICN=$$ICN(DFN,HL("ECH"))
- I ICN>0 S $P(LA7ARRAY(0),HLFS,4)=$P(LA7ARRAY(0),HL("FS"),4)_$E(HL("ECH"),2)_ICN
- ;
- ; Send alternate patient id if passed
- I LA7ALTID'="" S $P(LA7ARRAY(0),HL("FS"),5)=LA7ALTID
- I $P(LA7ARRAY(0),HLFS,5)?1N.N S $P(LA7ARRAY(0),HL("FS"),5)=$$M11^HLFNC($P(LA7ARRAY(0),HL("FS"),5),HL("ECH"))
- ;
- Q
- ;
- ;
- NF2PID ; Build patient identifier field on non-file #2 patient
- ;
- N X
- D PT^LRX
- S LA7Y(0)="PID"
- S LA7Y(1)=LA7PIDSN
- ;
- ; Return external identifier in PID-2 sequence, backward compatibility to V2.2
- ; Also include external identifier in PID-3 for current versions (>v2.2)
- S LA7Y(3)=""
- I LA7EXTID'="" D
- . I '(LA7EXTID?1N.N) S LA7Y(2)=LA7EXTID
- . E S LA7Y(2)=$$M11^HLFNC(LA7EXTID,HL("ECH"))
- . S LA7Y(3)=LA7EXTID
- ;
- S X=$$M11^HLFNC(SSN(2),HL("ECH"))
- I LRDPF=67.1 S $P(X,$E(HL("ECH"),1),5)="L2"
- I LA7Y(3)'="",LA7Y(3)'[SSN(2) S LA7Y(3)=LA7Y(3)_$E(HL("ECH"),2)_X
- I LA7Y(3)="" S LA7Y(3)=X
- ;
- ; Send LRDFN as alternate patient ID, unless alternate id passed
- I LA7ALTID'="" S LA7Y(4)=LA7ALTID
- E S LA7Y(4)=LRDFN
- I LA7Y(4)?1N.N S LA7Y(4)=$$M11^HLFNC(LA7Y(4),HL("ECH"))
- I $P(LA7Y(4),$E(HL("ECH"),1),5)="" S $P(LA7Y(4),$E(HL("ECH"),1),5)="U"
- ;
- S LA7Y(5)=$$HLNAME^XLFNAME(PNM,"S",$E(HL("ECH")))
- ;
- I $G(DOB)'="" D
- . S DOB=$$CHKDT^LA7VHLU1(DOB)
- . S LA7Y(7)=$$FMTHL7^XLFDT(DOB)
- ;
- S LA7Y(8)=$S($G(SEX)'="":SEX,1:"U")
- ;
- ; Race - if from REFERRAL PATIENT file (#67) then check RACE field.
- S LA7Y(10)=""
- I LRDPF=67 D
- . S LA7X=$$GET1^DIQ(67,DFN_",",.06,"I")
- . I LA7X<1 Q
- . S LA7Y(10)=$$PTR2CODE^DGUTL4(LA7X,1,2)
- . S $P(LA7Y(10),$E(HL("ECH"),1),2)=$$PTR2TEXT^DGUTL4(LA7X,1)
- . S $P(LA7Y(10),$E(HL("ECH"),1),3)="HL70005"
- ;
- ; SSN from referral file if 9N - DoD uses PID-19 to validate
- S LA7Y(19)=""
- I LRDPF=67 D
- . S LA7X=$$GET1^DIQ(67,DFN_",",.09,"I")
- . I LA7X?9N S LA7Y(19)=LA7X
- ;
- D BUILDSEG^LA7VHLU(.LA7Y,.LA7ARRAY,HL("FS"))
- Q
- ;
- ;
- ICN(DFN,LA7ECH) ; Send ICN from MPI
- ; Call with DFN = internal entry number of patient in PATIENT #2 file.
- ; LA7ECH = HL7 encoding characters.
- ;
- ; If ICN is local then assigning facility is local site
- ; otherwise indicate 200M.
- ;
- N ICN,LA7ICN,LOCAL,SITE
- ;
- S ICN=""
- ;
- S LA7ICN=$$GETICN^MPIF001(DFN)
- I LA7ICN>0 D
- . S ICN=LA7ICN
- . S LOCAL=$$IFLOCAL^MPIF001(DFN)
- . I LOCAL'=1 S SITE="200M"
- . E S SITE=$P($$SITE^VASITE,"^",3)
- . S $P(ICN,$E(LA7ECH,1),4)="USVHA"_$E(LA7ECH,4)_$E(LA7ECH,4)_"HL70363"
- . S $P(ICN,$E(LA7ECH,1),5)="NI"
- . S $P(ICN,$E(LA7ECH,1),6)="VA FACILITY ID"_$E(LA7ECH,4)_SITE_$E(LA7ECH,4)_"L"
- ;
- Q ICN
- --- Routine Detail --- with STRUCTURED ROUTINE LISTING ---[H[J[2J[HLA7VPID 6062 printed Mar 13, 2025@20:45:47 Page 2
- LA7VPID ;DALOI/JMC - HL7 PID/PV1 segment builder utility ;08/03/09 15:59
- +1 ;;5.2;AUTOMATED LAB INSTRUMENTS;**46,64,74**;Sep 27, 1994;Build 229
- +2 ;
- +3 ; Reference to routine $$EN^VAFHLPID supported by DBIA# 263
- +4 ;
- PID(LRDFN,LA7EXTID,LA7ARRAY,LA7PIDSN,HL,LA7ALTID) ; Build PID segment
- +1 ; Call with LRDFN = Lab DFN, passed by value
- +2 ; LA7EXTID = to return as external patient id, id used by non-VA systems (optional)
- +3 ; LA7ARRAY = array to return PID array, pass by reference
- +4 ; LA7PIDSN = PID id counter, passed by value
- +5 ; HL = HL7 variable array, pass by reference
- +6 ; LA7ALTID = return alternate patient id, id used by non-va systems (optional)
- +7 ;
- +8 ; Returns LA7ARRAY
- +9 ;
- +10 NEW DFN,HLQ,LA763,LA7Y,LRDPF,VAFPID
- +11 ;
- +12 ; Change HLQ - VAFHLPID puts delete indicator when Vista has no value for field - not according to standard.
- +13 SET HLQ=""
- +14 ;
- +15 IF $GET(LRDFN)=""!($GET(HL("FS"))="")
- QUIT
- +16 IF '$DATA(^LR(LRDFN,0))
- QUIT
- +17 ;
- +18 SET LA7EXTID=$GET(LA7EXTID)
- SET LA7ALTID=$GET(LA7ALTID)
- SET LA7PIDSN=$GET(LA7PIDSN)+1
- +19 SET LA763(0)=$GET(^LR(LRDFN,0))
- +20 SET LRDPF=$PIECE(LA763(0),"^",2)
- SET DFN=$PIECE(LA763(0),"^",3)
- +21 ;
- +22 ; Patient file - use VAF call
- +23 IF LRDPF=2
- DO F2PID
- +24 ;
- +25 ; Non-patient file
- +26 IF LRDPF'=2
- DO NF2PID
- +27 KILL AGE,PNM,SEX,DOB,SSN,VA200,LRWRD,LRRB,LRTREA,VA
- +28 QUIT
- +29 ;
- +30 ;
- PV1(LRDFN,LA7ARRAY,LA7FS,LA7ECH) ; Build PV1 segment
- +1 ; Call with LRDFN = ien of entry in File #63
- +2 ; LA7ARRAY = array to return PV1 array, pass by reference
- +3 ; LA7FS = HL field separator
- +4 ; LA7ECH = HL encoding characters
- +5 ;
- +6 ;
- +7 NEW DFN,LA763,LA7LOC,LRDPF,LA7Y
- +8 SET LA763(0)=$GET(^LR(LRDFN,0))
- +9 SET LRDPF=$PIECE(LA763(0),"^",2)
- SET DFN=$PIECE(LA763(0),"^",3)
- SET LA7LOC=""
- +10 ;
- +11 SET LA7Y(0)="PV1"
- +12 SET LA7Y(1)=1
- +13 ;
- +14 ; Referral file with Patient file link.
- +15 IF LRDPF=67
- IF $PIECE($GET(^LRT(67,DFN,"DPT")),"^")
- Begin DoDot:1
- +16 SET LRDPF=2
- +17 SET DFN=$PIECE($GET(^LRT(67,DFN,"DPT")),"^")
- End DoDot:1
- +18 ;
- +19 ; Determine patient class
- +20 ; Current inpatient location
- +21 IF LRDPF=2
- SET LA7LOC=$GET(^DPT(DFN,.1))
- +22 ; Inpatient
- IF $LENGTH(LA7LOC)
- SET LA7Y(2)="I"
- +23 ;
- +24 ; Otherwise from lab files
- +25 IF $GET(LA7LOC)=""
- Begin DoDot:1
- +26 SET LA7LOC=$GET(^LR(LRDFN,.1))
- +27 ; Default to outpatient
- SET LA7Y(2)="O"
- End DoDot:1
- +28 ;
- +29 ; Patient location
- +30 SET LA7LOC=$$CHKDATA^LA7VHLU3(LA7LOC,LA7FS_LA7ECH)
- +31 SET LA7Y(3)=LA7LOC
- +32 ;
- +33 DO BUILDSEG^LA7VHLU(.LA7Y,.LA7ARRAY,LA7FS)
- +34 QUIT
- +35 ;
- +36 ;
- F2PID ; Build patient identifier field on file #2 patient
- +1 ;
- +2 ; Non VA users of VistA need to send patient's address
- +3 NEW I,ICN,LA7X,LRSTR,X
- +4 SET LA7STR="1,5,6,7,8,10NTB,"_$SELECT(DUZ("AG")="V":"",1:"11,")_"16,19"
- +5 SET LA7ARRAY(0)=$$EN^VAFHLPID(DFN,LA7STR,LA7PIDSN,3)
- +6 ;
- +7 ; Check for overflow (>245)
- +8 IF $ORDER(VAFPID(0))
- Begin DoDot:1
- +9 SET I=0
- +10 FOR
- SET I=$ORDER(VAFPID(I))
- if 'I
- QUIT
- SET LA7ARRAY(I)=VAFPID(I)
- End DoDot:1
- +11 ;
- +12 ; Return external identifier in PID-2 sequence, backward compatibility to V2.2
- +13 IF LA7EXTID'=""
- Begin DoDot:1
- +14 IF '(LA7EXTID?1N.N)
- SET $PIECE(LA7ARRAY(0),HL("FS"),3)=LA7EXTID
- +15 IF '$TEST
- SET $PIECE(LA7ARRAY(0),HLFS,3)=$$M11^HLFNC(LA7EXTID,HL("ECH"))
- End DoDot:1
- +16 ;
- +17 ; Send SSN as patient identifier
- +18 SET X=$PIECE(LA7ARRAY(0),HLFS,4)
- +19 IF $PIECE(X,$EXTRACT(HL("ECH")),5)="SS"
- SET $PIECE(X,$EXTRACT(HL("ECH")),1)=$TRANSLATE($PIECE(X,$EXTRACT(HL("ECH")),1),"-","")
- SET $PIECE(LA7ARRAY(0),HLFS,4)=X
- +20 ;
- +21 ; Send DFN as patient identifier
- +22 SET X=$$M11^HLFNC(DFN,HL("ECH"))
- +23 SET $PIECE(X,$EXTRACT(HL("ECH")),5)="PI"
- +24 SET $PIECE(X,$EXTRACT(HL("ECH")),6)=$$RETFACID^LA7VHLU2(+$$KSP^XUPARAM("INST"),2,1)_$EXTRACT(HL("ECH"),4)_$$KSP^XUPARAM("WHERE")_$EXTRACT(HL("ECH"),4)_"DNS"
- +25 SET $PIECE(LA7ARRAY(0),HLFS,4)=$PIECE(LA7ARRAY(0),HL("FS"),4)_$EXTRACT(HL("ECH"),2)_X
- +26 ;
- +27 ; Send ICN from MPI as patient identifier
- +28 SET ICN=$$ICN(DFN,HL("ECH"))
- +29 IF ICN>0
- SET $PIECE(LA7ARRAY(0),HLFS,4)=$PIECE(LA7ARRAY(0),HL("FS"),4)_$EXTRACT(HL("ECH"),2)_ICN
- +30 ;
- +31 ; Send alternate patient id if passed
- +32 IF LA7ALTID'=""
- SET $PIECE(LA7ARRAY(0),HL("FS"),5)=LA7ALTID
- +33 IF $PIECE(LA7ARRAY(0),HLFS,5)?1N.N
- SET $PIECE(LA7ARRAY(0),HL("FS"),5)=$$M11^HLFNC($PIECE(LA7ARRAY(0),HL("FS"),5),HL("ECH"))
- +34 ;
- +35 QUIT
- +36 ;
- +37 ;
- NF2PID ; Build patient identifier field on non-file #2 patient
- +1 ;
- +2 NEW X
- +3 DO PT^LRX
- +4 SET LA7Y(0)="PID"
- +5 SET LA7Y(1)=LA7PIDSN
- +6 ;
- +7 ; Return external identifier in PID-2 sequence, backward compatibility to V2.2
- +8 ; Also include external identifier in PID-3 for current versions (>v2.2)
- +9 SET LA7Y(3)=""
- +10 IF LA7EXTID'=""
- Begin DoDot:1
- +11 IF '(LA7EXTID?1N.N)
- SET LA7Y(2)=LA7EXTID
- +12 IF '$TEST
- SET LA7Y(2)=$$M11^HLFNC(LA7EXTID,HL("ECH"))
- +13 SET LA7Y(3)=LA7EXTID
- End DoDot:1
- +14 ;
- +15 SET X=$$M11^HLFNC(SSN(2),HL("ECH"))
- +16 IF LRDPF=67.1
- SET $PIECE(X,$EXTRACT(HL("ECH"),1),5)="L2"
- +17 IF LA7Y(3)'=""
- IF LA7Y(3)'[SSN(2)
- SET LA7Y(3)=LA7Y(3)_$EXTRACT(HL("ECH"),2)_X
- +18 IF LA7Y(3)=""
- SET LA7Y(3)=X
- +19 ;
- +20 ; Send LRDFN as alternate patient ID, unless alternate id passed
- +21 IF LA7ALTID'=""
- SET LA7Y(4)=LA7ALTID
- +22 IF '$TEST
- SET LA7Y(4)=LRDFN
- +23 IF LA7Y(4)?1N.N
- SET LA7Y(4)=$$M11^HLFNC(LA7Y(4),HL("ECH"))
- +24 IF $PIECE(LA7Y(4),$EXTRACT(HL("ECH"),1),5)=""
- SET $PIECE(LA7Y(4),$EXTRACT(HL("ECH"),1),5)="U"
- +25 ;
- +26 SET LA7Y(5)=$$HLNAME^XLFNAME(PNM,"S",$EXTRACT(HL("ECH")))
- +27 ;
- +28 IF $GET(DOB)'=""
- Begin DoDot:1
- +29 SET DOB=$$CHKDT^LA7VHLU1(DOB)
- +30 SET LA7Y(7)=$$FMTHL7^XLFDT(DOB)
- End DoDot:1
- +31 ;
- +32 SET LA7Y(8)=$SELECT($GET(SEX)'="":SEX,1:"U")
- +33 ;
- +34 ; Race - if from REFERRAL PATIENT file (#67) then check RACE field.
- +35 SET LA7Y(10)=""
- +36 IF LRDPF=67
- Begin DoDot:1
- +37 SET LA7X=$$GET1^DIQ(67,DFN_",",.06,"I")
- +38 IF LA7X<1
- QUIT
- +39 SET LA7Y(10)=$$PTR2CODE^DGUTL4(LA7X,1,2)
- +40 SET $PIECE(LA7Y(10),$EXTRACT(HL("ECH"),1),2)=$$PTR2TEXT^DGUTL4(LA7X,1)
- +41 SET $PIECE(LA7Y(10),$EXTRACT(HL("ECH"),1),3)="HL70005"
- End DoDot:1
- +42 ;
- +43 ; SSN from referral file if 9N - DoD uses PID-19 to validate
- +44 SET LA7Y(19)=""
- +45 IF LRDPF=67
- Begin DoDot:1
- +46 SET LA7X=$$GET1^DIQ(67,DFN_",",.09,"I")
- +47 IF LA7X?9N
- SET LA7Y(19)=LA7X
- End DoDot:1
- +48 ;
- +49 DO BUILDSEG^LA7VHLU(.LA7Y,.LA7ARRAY,HL("FS"))
- +50 QUIT
- +51 ;
- +52 ;
- ICN(DFN,LA7ECH) ; Send ICN from MPI
- +1 ; Call with DFN = internal entry number of patient in PATIENT #2 file.
- +2 ; LA7ECH = HL7 encoding characters.
- +3 ;
- +4 ; If ICN is local then assigning facility is local site
- +5 ; otherwise indicate 200M.
- +6 ;
- +7 NEW ICN,LA7ICN,LOCAL,SITE
- +8 ;
- +9 SET ICN=""
- +10 ;
- +11 SET LA7ICN=$$GETICN^MPIF001(DFN)
- +12 IF LA7ICN>0
- Begin DoDot:1
- +13 SET ICN=LA7ICN
- +14 SET LOCAL=$$IFLOCAL^MPIF001(DFN)
- +15 IF LOCAL'=1
- SET SITE="200M"
- +16 IF '$TEST
- SET SITE=$PIECE($$SITE^VASITE,"^",3)
- +17 SET $PIECE(ICN,$EXTRACT(LA7ECH,1),4)="USVHA"_$EXTRACT(LA7ECH,4)_$EXTRACT(LA7ECH,4)_"HL70363"
- +18 SET $PIECE(ICN,$EXTRACT(LA7ECH,1),5)="NI"
- +19 SET $PIECE(ICN,$EXTRACT(LA7ECH,1),6)="VA FACILITY ID"_$EXTRACT(LA7ECH,4)_SITE_$EXTRACT(LA7ECH,4)_"L"
- End DoDot:1
- +20 ;
- +21 QUIT ICN