VistA-FOIAVistA/r/TEXT_INTEGRATION_UTILITIES-.../TIUPRF2.m

131 lines
5.4 KiB
Mathematica

TIUPRF2 ; SLC/JMH - RPCs for Patient Record Flags ; 11/3/05
;;1.0;TEXT INTEGRATION UTILITIES;**184**;Jun 20, 1997
;
; $$GETACT^DGPFAPI: IA# 3860
; $$GETHTIU^DGPFAPI1: IA# 4383
; $$STOTIU^DGPFAPI2: IA# 4384
;
GETTITLE(TIUY,PTDFN,FLAGID) ; RPC Gets Note Title associated with FLAGID for PTDFN
;Receives TIUY by ref; passes back
; TIUY = TitleIEN^Title
; 0 if no title is associated or flg assignmt is not active
;Requires PTDFN
;Requires FLAGID - identifier for particular flag assignment
; for patient PTDFN. Set as subscript in GETACT^DGPFAPI.
; See GETFLG^ORPRF.
N PRFARR K TIUY S TIUY=0
Q:'$G(PTDFN) Q:'$G(FLAGID)
S TIUY=$$GETACT^DGPFAPI(PTDFN,"PRFARR") ;Get ACTive flag info
Q:'TIUY
S TIUY=$G(PRFARR(FLAGID,"TIUTITLE"))
I TIUY'>0 S TIUY=0
Q
;
GETNOTES(TIUY,PTDFN,TIUTTL,REVERSE) ; RPC gets SIGNED, LINKED PRF
;notes titled TIUTTL for patient PTDFN
; Excludes Notes linked to Entered in Error (EIE) actions and
;notes linked to Erroneous actions (actions taken prior to
;EIE actions).
; Receives TIUY by ref; passes back
; TIUY = # of notes
; TIUY([Reverse][Incremented]InternalNoteDate) =
; NoteIEN^ActionName^ExternalNoteDate^AuthorName
; Requires PTDFN,TIUTTL
; Includes status Uncosigned, Completed, & Amended only.
; Optional REVERSE - Boolean Flag:
; 1 - Sort notes by reverse chronological order
; 0 (default) - Sort notes by chronological order
N TIUDG,ACTID,TIUIDATE,TIUEDATE,TIUIEN,TIUACT,STATUS
N TIUAUTH,DTARRAY,HASERR,ARRAYNM
K TIUY ; Initialize array in case caller hasn't done so.
S (TIUY,ACTID)=0
; -- Get Assgn Hist info (GETHTIU initializes array
; so we don't need to):
S ARRAYNM="^TMP(""TIUPRFH"",$J)"
S TIUDG=$$GETHTIU^DGPFAPI1(PTDFN,TIUTTL,ARRAYNM)
G:'TIUDG GETNOTEX
S HASERR=$$HASERR^TIUPRFL(ARRAYNM)
F S ACTID=$O(@ARRAYNM@("HISTORY",ACTID)) Q:'ACTID D
. I ACTID=+HASERR Q ;Entered in Error
. I HASERR>0,$$ISERR^TIUPRFL(ARRAYNM,ACTID,$P(HASERR,U,2)) Q ;erroneous
. S TIUIEN=+@ARRAYNM@("HISTORY",ACTID,"TIUIEN")
. Q:TIUIEN'>0 ;TMP node may be just ^
. ; -- Include only complete or amended or uncosigned notes:
. S STATUS=$P($G(^TIU(8925,TIUIEN,0)),U,5) I '((STATUS=6)!(STATUS=7)!(STATUS=8)) Q
. S TIUACT=$P(@ARRAYNM@("HISTORY",ACTID,"ACTION"),U,2)
. N TIUFLDS,TIUERR D GETS^DIQ(8925,TIUIEN_",","1202;1301","IE","TIUFLDS","TIUERR")
. S TIUIDATE=TIUFLDS(8925,TIUIEN_",",1301,"I")
. ; -- Increment date if there are multiple notes w/ same exact date:
. F S:$D(DTARRAY(TIUIDATE)) TIUIDATE=TIUIDATE+.0000001 I '$D(DTARRAY(TIUIDATE)) S DTARRAY(TIUIDATE)="" Q
. I $G(REVERSE) S TIUIDATE=9999999-TIUIDATE
. S TIUEDATE=$E(TIUFLDS(8925,TIUIEN_",",1301,"E"),1,18)
. I TIUEDATE="" S TIUEDATE="No Ref Date"
. S TIUAUTH=TIUFLDS(8925,TIUIEN_",",1202,"E")
. I TIUAUTH="" S TIUAUTH="No Author"
. S TIUY=TIUY+1
. S TIUY(TIUIDATE)=TIUIEN_U_TIUACT_U_TIUEDATE_U_TIUAUTH
GETNOTEX ;
K ^TMP("TIUPRFH",$J)
Q
;
GETACTS(TIUY,TIUTTL,DFN) ;RPC Gets PRF Action info
;"Action" is shorthand for Assignment History entry
;Returns data in the following format for each Action:
;TIUY(ACTID) =
; FLAGNAME^ASSGNIEN^ACTIONNAME^ACTIONIEN^ACTIONDATEI^ACTIONDATEE^TIUIEN
; where Integer ACTID = subscript after "HISTORY" in array returned
; by GETHTIU^DGPFAPI1
;Returns linkable actions (whether linked or not) for Patient DFN
; and flag assoc w/ TIUTTL.
;Excludes UNLINKABLE actions = Entered in Error actions (EIE) or
; actions taken prior to an EIE action.
;Erroneous and EIE actions may be for the wrong patient, etc.
N TIUDG,ACTID,TIUFLAG,UNLINKBL,ARRAYNM
S TIUY=1,ARRAYNM="^TMP(""TIUPRFH"",$J)"
S TIUDG=$$GETHTIU^DGPFAPI1(DFN,TIUTTL,ARRAYNM)
I 'TIUDG S TIUY="0^"_$P(TIUDG,U,2) G GETACTX
; -- If no unlinked, linkable actions exist, say so but go on:
I '$$AVAILACT^TIUPRFL("^TMP(""TIUPRFH"",$J)",,.UNLINKBL) S TIUY="0^All linkable Flag actions are already linked"
; -- Return ALL linkable actions (linked or not):
S TIUFLAG=$P(^TMP("TIUPRFH",$J,"FLAG"),U,2)_U_$P(^TMP("TIUPRFH",$J,"ASSIGNIEN"),U)
S ACTID=0
F S ACTID=$O(^TMP("TIUPRFH",$J,"HISTORY",ACTID)) Q:'+ACTID D
. Q:$G(UNLINKBL(ACTID))
. S TIUY(ACTID)=TIUFLAG
. S TIUY(ACTID)=TIUY(ACTID)_U_$P(^TMP("TIUPRFH",$J,"HISTORY",ACTID,"ACTION"),U,2)
. S TIUY(ACTID)=TIUY(ACTID)_U_$P(^TMP("TIUPRFH",$J,"HISTORY",ACTID,"HISTIEN"),U,1)
. S TIUY(ACTID)=TIUY(ACTID)_U_$P(^TMP("TIUPRFH",$J,"HISTORY",ACTID,"DATETIME"),U,1)
. S TIUY(ACTID)=TIUY(ACTID)_U_$P(^TMP("TIUPRFH",$J,"HISTORY",ACTID,"DATETIME"),U,2)
. S TIUY(ACTID)=TIUY(ACTID)_U_$P(^TMP("TIUPRFH",$J,"HISTORY",ACTID,"TIUIEN"),U,1)
GETACTX ;
K ^TMP("TIUPRFH",$J)
Q
;
LINK(TIUY,TIUIEN,ASSGNDA,ACTIEN,DFN) ;RPC Link TIU Doc TIUIEN to
; the PRF action
N TIUTTL
S TIUTTL=+$G(^TIU(8925,TIUIEN,0))
I 'TIUTTL S TIUY="0^Document does not exist" Q
; Remove any links before making new link
D UNLINK^TIUPRF1(TIUIEN)
S TIUY=$$STOTIU^DGPFAPI2(DFN,ASSGNDA,ACTIEN,TIUIEN)
Q
GETSTAT(TIUY,TIUIEN) ;RPC Gets the status of TIU Doc TIUIEN
;Returns STATIEN^STATNAME
N TIUTTL
S TIUTTL=+$G(^TIU(8925,TIUIEN,0))
I 'TIUTTL S TIUY="0^Document does not exist" Q
S TIUY=$P(^TIU(8925,TIUIEN,0),U,5)
S TIUY=TIUY_U_$P($G(^TIU(8925.6,TIUY,0)),U,1)
Q
ISPRFTTL(TIUY,TIUDA) ;RPC Takes as input 8925.1 IEN
; and checks if it is a PRF title
; Cf ISPFTTL^TIUPRFL. which is a FUNCTION
N TIUCAT1,TIUCAT2,TIUD1
S TIUY=0,TIUD1=""
S TIUCAT1=+$$DDEFIEN^TIUFLF7("PATIENT RECORD FLAG CAT I","DC")
S TIUCAT2=+$$DDEFIEN^TIUFLF7("PATIENT RECORD FLAG CAT II","DC")
S TIUD1=$O(^TIU(8925.1,"AD",TIUDA,TIUD1))
I TIUD1=TIUCAT1!(TIUD1=TIUCAT2) S TIUY=1
Q