source: WorldVistAEHR/trunk/r/TEXT_INTEGRATION_UTILITIES-GMRP-TIU/TIUPRF2.m@ 789

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