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

DIAUTL.m

Go to the documentation of this file.
  1. DIAUTL ;GFT;13AUG2004
  1. ;;22.0;VA FileMan;**76,140**;Mar 30, 1999
  1. ;
  1. TURNON(DIFILE,FLDS,DIMODE) ;Turn on AUDITING for the FLDS named
  1. N D,DIFIELD,DIE,DR,DA,DIQUIET,DIEZS,D0,DQ,DI,DIC,X
  1. S DIMODE=$E($G(DIMODE,"y")),DIQUIET=1,DIEZS=1 Q:DIFILE<2 Q:"yen"'[DIMODE
  1. F DIFIELD=0:0 S DIFIELD=$O(^DD(DIFILE,DIFIELD)) Q:'DIFIELD D:$$FLDSINC(DIFILE,FLDS,DIFIELD) ON
  1. Q
  1. ON N DIOLD
  1. S DIOLD=$G(^DD(DIFILE,DIFIELD,"AUDIT")) I DIOLD=DIMODE Q ;It's already on
  1. S D=$P($G(^(0)),U,2) Q:D["C"
  1. I D Q:$P($G(^DD(+D,.01,0)),U,2)["W" D TURNON(+D,"**",DIMODE) Q ;Recursive!
  1. S DR="1.1////"_DIMODE,DIE="^DD("_DIFILE_",",DA(1)=DIFILE,DA=DIFIELD
  1. I DA=.001,DIMODE="y" Q ;CAN'T AUDIT NUMBER FIELD!!
  1. D ^DIE
  1. D IN^DIU0(DIFILE,DIFIELD),DDAUDIT(DIFILE,DIFIELD,1.1,DIOLD,DIMODE)
  1. Q
  1. ;
  1. CHANGED(FILE,FLDS,FLAGS,ARRAY,START,END) ;
  1. ;Returns in @ARRAY the list of entries in FILE who had any of the fields in FLDS changed from START to END
  1. ;If FLAGS is "O", the Oldest values are saved in @ARRAY@(entry,field)
  1. N GLO,E,F,T,D,%I
  1. K @ARRAY
  1. S FLAGS=$G(FLAGS)
  1. S GLO=^DIC(FILE,0,"GL")
  1. I '$G(START) S START=0
  1. I '$G(END) D NOW^%DTC S END=%
  1. S T=START D F S T=$O(^DIA(FILE,"C",T)) Q:T>END!'T D
  1. .F D=0:0 S D=$O(^DIA(FILE,"C",T,D)) Q:'D D
  1. ..S E=$G(^DIA(FILE,D,0)) Q:'E
  1. ..I $D(@ARRAY@(+E)),FLAGS="" Q
  1. ..S F=+$P(E,U,3) Q:'$$FLDSINC(FILE,FLDS,F)
  1. ..I '$D(@(GLO_"+E)")),FLAGS="" Q
  1. ..S @ARRAY@(+E)="" I FLAGS["O",'$D(@ARRAY@(+E,F)) S @ARRAY@(+E,F)=$G(^DIA(FILE,D,2))
  1. Q
  1. ;
  1. LAST(DIQGR,ENTRY,FLDS) ;returns DATE^USER who most recently touched any of the FLDS in ENTRY in File DIQGR
  1. N E,F,DILAST,DENTRY
  1. S DILAST="",DENTRY=ENTRY D E
  1. S DENTRY=ENTRY_","
  1. F S DENTRY=$O(^DIA(DIQGR,"B",DENTRY)) Q:DENTRY-ENTRY D E
  1. Q DILAST
  1. E S E="" F S E=$O(^DIA(DIQGR,"B",DENTRY,E),-1) Q:'E I $$FLDSINC(DIQGR,FLDS,+$P($G(^DIA(DIQGR,E,0)),U,3)) D Q:DENTRY=ENTRY
  1. .N L S L=$P(^DIA(DIQGR,E,0),"^",2)_"^"_$P(^(0),"^",4)
  1. .I L>DILAST S DILAST=L
  1. Q
  1. ;
  1. DATE(FILE,FIELD) ;
  1. D VALUE(FILE,FIELD,2) Q
  1. ;
  1. USER(FILE,FIELD) ;
  1. D VALUE(FILE,FIELD,4) Q
  1. ;
  1. VALUE(FILE,FIELD,TU) ;FILE' can be SubFile
  1. N DIACMP,ENTRY,I
  1. S ENTRY=+$G(D0)
  1. F I=1:1 Q:'$D(^DD(FILE,0,"UP")) S ENTRY=ENTRY_","_+$G(@("D"_I)),F=^("UP"),FIELD=$O(^DD(F,"SB",FILE,0))_","_FIELD,FILE=F
  1. D PRIOR(FILE,ENTRY,FIELD,.DIACMP)
  1. S D="" F S D=$O(DIACMP(D),-1) Q:'D S X=$S($G(TU):$P(^DIA(FILE,D,0),U,TU),1:DIACMP(D)) X DICMX Q:'$D(D)
  1. S X="" Q
  1. ;
  1. PRIOR(FILE,ENTRY,FIELD,OUT) ;
  1. N E
  1. F E=0:0 S E=$O(^DIA(FILE,"B",ENTRY,E)) Q:'E I $P($G(^DIA(FILE,E,0)),U,3)=FIELD,$D(^(2)) S OUT(E)=^(2)
  1. Q
  1. ;
  1. FLDSINC(DIQGR,DR,DIAUTLF) ;is DIAUTLF within DR? -- from 'DIQGQ' routine
  1. I DR=""!'DIAUTLF Q 0
  1. I DR="*" Q 1
  1. N DIAUGOT,DIQGCP,DIQGDD,DIQGXDC,DIQGXDF,DIQGXDI,DIQGXDN,DIQGXDD
  1. S DIQGXDC=0,DIAUGOT=0,DIQGDD=1,DIQGCP="D"
  1. I '$D(DIQGR) N X S X(1)="FILE" G 202
  1. S DIQGXDD="^DD("_DIQGR_")"
  1. S:DIQGR DIQGR=$S(DIQGDD:$$DD(DIQGR),1:$$ROOT^DIQGU(DIQGR,.DA)) I DIQGR="" N X S X(1)="FILE AND IEN COMBINATION" G 202
  1. F DIQGXDI=1:1 S DIQGXDF=$P(DR,";",DIQGXDI),DIQGXDN=$P(DIQGXDF,":") Q:DIQGXDF="" D RANGE G GOT:DIAUGOT
  1. NOGOT Q 0
  1. ;
  1. RANGE I DIQGXDC,$P(^DD(+DIQGXDC,.01,0),"^",2)'["W" S:DR="**" DIQGXDN=DIQGXDN_"*" Q:$L(DIQGXDN,"*")'=2 ;multiple
  1. I DIQGXDN'?.N,$L(DIQGXDN,"*")=2,$P(DIQGXDN,"*")]"",$D(@DIQGXDD@("B",$P(DIQGXDN,"*"))) S DIQGXDN=$O(^($P(DIQGXDN,"*"),""))_"*"
  1. I DIQGXDN?1.2"*" S DIAUGOT=1 Q
  1. Q:DIAUTLF<DIQGXDN I $P(DIQGXDF,":",2)<DIAUTLF Q:DIAUTLF-DIQGXDN
  1. S DIAUGOT=1 Q
  1. ;
  1. GOT Q 1
  1. ;
  1. DD(X) Q:'$D(^DD(X)) "" Q "^DD("_X_","
  1. 202 D BLD^DIALOG(202,.X) Q ;bad parameter
  1. ;
  1. ;
  1. GET(FIL,DA,DATE,TMP,FIELD) ;BUILD 'TMP' ARRAY AS OF DATE
  1. ;DA is in IEN format FIELD, optional, means just look at one field
  1. K @TMP
  1. N DAT,FLD,FILE,F,D,E,B,C,T
  1. S F=FIL,FILE=$$FNO^DILIBF(F),@TMP=FILE,D=+$P(DA,",",$L(DA,",")-1) I 'D S D=DA
  1. I F=FILE F E=0:0 S E=$O(^DIA(FILE,"B",D,E)) Q:'E D L G Q:$G(@TMP@(F,D_","))
  1. SUBFILES S D=D_"," F S E=D,D=$O(^DIA(FILE,"B",D)) Q:D-E D
  1. .F E=0:0 S E=$O(^DIA(FILE,"B",D,E)) Q:'E D L
  1. Q
  1. L I $P($G(^DIA(FILE,E,0)),U)'=D Q
  1. S FLD=$P(^(0),U,3),DAT=$P(^(0),U,2),I="",F=FILE
  1. F S C=$L(FLD,","),I=I_$P(D,",",C)_"," Q:C=1 S T=+FLD G Q:'$D(^DD(F,T,0)) S T=+$P(^(0),U,2) G Q:T'>F!'$D(^DD(T)) S F=T,FLD=$P(FLD,",",2,C)
  1. I FLD=.01,DAT>DATE,$P(^DIA(FILE,E,0),U,5)="A" K @TMP@(F,I) S @TMP@(F,I)=1 Q ;THAT ENTRY OR SUB-ENTRY DIDN'T EXIST AS OF DATE 2nd level will only be defined in this case
  1. I $G(FIELD),FLD-FIELD!(F-FIL) Q
  1. I '$D(@TMP@(F,I,FLD)) S @TMP@(F,I,FLD)=DAT_U_E Q
  1. I DAT>DATE Q
  1. I @TMP@(F,I,FLD)<DAT S @TMP@(F,I,FLD)=DAT_U_E
  1. Q Q
  1. ;
  1. DIA(DAT,FILE,X,DIAUTLEX) ;FROM DIQG AND DIQGQ
  1. ;X is a node value from the 'TMP' array built by the GET subroutine, above
  1. ;DAT is the date/time as of which we want the audited value
  1. ;DIAUTLEX may contain "E" if we want external value
  1. I X>DAT Q $$D(2) ;We know what it was before deletion
  1. Q $$D(3)
  1. D(ON) S X=$G(^DIA(FILE,+$P(X,U,2),ON)) I $G(DIAUTLEX)["E" Q X
  1. N S,Y S S=$G(^(ON+.1)) I X]"",S="" D I Y>0 Q Y
  1. .N %DT S %DT="T" D ^%DT
  1. S S=$P(S,U) I S]"" Q S
  1. Q X
  1. ;
  1. DDAUDIT(B0,DA,A0,A1,A2) ;B0=File or SubFile, DA=Field, A0=Attribute #, A1=Old value, A2=New value
  1. N DDA,%,%T,%D,J,B3,I
  1. Q:'$D(DUZ)!'$G(DT)
  1. D IJ^DIUTL(B0) I $G(^DD(J(0),0,"DDA"))'["Y" Q ;only if DD audit is on
  1. S A0=+$G(A0),A0=$P($G(^DD(0,A0,0)),U)_U_A0
  1. K:$G(A1)="" A1 L:$G(A2)="" A2
  1. D P^DICATTA Q