| 1 | MAGJPRF1 ;WIRMFO/JHC VistaRad RPCs-User Prefs ; 05 May 2004  10:05 AM
 | 
|---|
| 2 |  ;;3.0;IMAGING;**18**;Mar 07, 2006
 | 
|---|
| 3 |  ;; +---------------------------------------------------------------+
 | 
|---|
| 4 |  ;; | Property of the US Government.                                |
 | 
|---|
| 5 |  ;; | No permission to copy or redistribute this software is given. |
 | 
|---|
| 6 |  ;; | Use of unreleased versions of this software requires the user |
 | 
|---|
| 7 |  ;; | to execute a written test agreement with the VistA Imaging    |
 | 
|---|
| 8 |  ;; | Development Office of the Department of Veterans Affairs,     |
 | 
|---|
| 9 |  ;; | telephone (301) 734-0100.                                     |
 | 
|---|
| 10 |  ;; |                                                               |
 | 
|---|
| 11 |  ;; | The Food and Drug Administration classifies this software as  |
 | 
|---|
| 12 |  ;; | a medical device.  As such, it may not be changed in any way. |
 | 
|---|
| 13 |  ;; | Modifications to this software may result in an adulterated   |
 | 
|---|
| 14 |  ;; | medical device under 21CFR820, the use of which is considered |
 | 
|---|
| 15 |  ;; | to be a violation of US Federal Statutes.                     |
 | 
|---|
| 16 |  ;; +---------------------------------------------------------------+
 | 
|---|
| 17 |  ;;
 | 
|---|
| 18 |  Q
 | 
|---|
| 19 | ERR N ERR S ERR=$$EC^%ZOSV S @MAGGRY@(0)="0^4~"_ERR
 | 
|---|
| 20 |  D @^%ZOSF("ERRTN")
 | 
|---|
| 21 |  Q:$Q 1  Q
 | 
|---|
| 22 |  ;
 | 
|---|
| 23 | RPCIN(MAGGRY,PARAMS,DATA) ; RPC: MAGJ USER DATA
 | 
|---|
| 24 |  ;PARAMS: TXID ^ SYSUPDAT ^ TXDUZ ^ TXDIV
 | 
|---|
| 25 |  ;TXID: Req'd--action to take; see below
 | 
|---|
| 26 |  ;TXDUZ: Opt; if input, get data for another user
 | 
|---|
| 27 |  ;TXDIV: Opt; if input, get data for another div
 | 
|---|
| 28 |  ;SYSUPDAT: Opt; if input, save Sys Default data; Sec Key Req'd
 | 
|---|
| 29 |  ; DATA--(opt) input array; depends on TXID; see subs by TXID
 | 
|---|
| 30 |  ;Pattern for DATA input & reply is:
 | 
|---|
| 31 |  ;*LABEL ; Start for one label
 | 
|---|
| 32 |  ;Label_Name     ; label name
 | 
|---|
| 33 |  ;(1:N lines of XML text follow)
 | 
|---|
| 34 |  ;*END           ; end for label
 | 
|---|
| 35 |  ;*LABEL ; Start for next label (etc.)
 | 
|---|
| 36 |  ;Label_Name_2
 | 
|---|
| 37 |  ;*KEY           ; index keys to follow (KEY data is opt)
 | 
|---|
| 38 |  ;KeyNam1=nnn     ; 1st key (free-text)
 | 
|---|
| 39 |  ;KeyNam2=jjj    ; 2nd key (etc.)
 | 
|---|
| 40 |  ;*END_KEY       ; end of keys
 | 
|---|
| 41 |  ; (1:N lines of XML text follow)
 | 
|---|
| 42 |  ;*END           ; end for label
 | 
|---|
| 43 |  ;
 | 
|---|
| 44 |  N $ETRAP,$ESTACK S $ETRAP="D ERR^MAGJPRF1"
 | 
|---|
| 45 |  N GPREF,MAGLST,PREFIEN,REPLY,TXTYPE,PDIV,TXDUZ,TXID,TXDIV,READONLY,SYSUPDAT
 | 
|---|
| 46 |  S TXID=+PARAMS,SYSUPDAT=+$P(PARAMS,U,2),TXDUZ=$P(PARAMS,U,3),TXDIV=+$P(PARAMS,U,4)
 | 
|---|
| 47 |  S MAGLST="MAGJRPC" K MAGGRY S MAGGRY=$NA(^TMP($J,MAGLST)) K @MAGGRY
 | 
|---|
| 48 |  S DIQUIET=1 D DT^DICRW
 | 
|---|
| 49 |  ; no updates allowed if read another user's data, or get data for another logon division
 | 
|---|
| 50 |  I 'TXDUZ,(TXDUZ="sysAdmin") S TXDUZ=$$SYSUSER()
 | 
|---|
| 51 |  I 'TXDUZ S TXDUZ=DUZ
 | 
|---|
| 52 |  I 'TXDIV S TXDIV=DUZ(2)
 | 
|---|
| 53 |  S READONLY=(TXDUZ'=DUZ)
 | 
|---|
| 54 |  ; I 'READONLY S READONLY=(TXDIV'=DUZ(2)) ; <*> ?? Put this check inside Div-sensitive operations <*>
 | 
|---|
| 55 |  I READONLY,$D(MAGJOB("KEYS","MAGJ SYSTEM USER")),SYSUPDAT,(TXDUZ=$$SYSUSER()) S READONLY=0 ; get/update SysDefault data
 | 
|---|
| 56 |  S PREFIEN=$$GETPRIEN(TXDUZ,READONLY)
 | 
|---|
| 57 |  I 'PREFIEN S REPLY="0~Unable to get/update user data ("_$$USER(TXDUZ)_") for MAGJ USER DATA rpc call." G RPCINZ
 | 
|---|
| 58 |  ; set this level based on the TXID
 | 
|---|
| 59 |  S TXID=+$G(TXID)
 | 
|---|
| 60 |  ;
 | 
|---|
| 61 |  S TXTYPE="VR-WS",GPREF=$NA(^MAG(2006.68,PREFIEN,TXTYPE)),PDIV=""
 | 
|---|
| 62 |  ; workstation settings, user preferences, etc.
 | 
|---|
| 63 |  I TXID=1 G:'READONLY SAVE S REPLY="Access for updating preferences denied." G RPCINZ  ; Store prefs by label
 | 
|---|
| 64 |  I TXID=2 G TAGS    ; Get Labels w/ assoc. Keys
 | 
|---|
| 65 |  I TXID=3 G PRFDATA ; Get pref data for labels
 | 
|---|
| 66 |  I TXID=4 G:'READONLY TAGDEL S REPLY="Access for deleting preferences denied." G RPCINZ  ; Delete labels
 | 
|---|
| 67 |  I TXID=6 G USERS  ; Get list of vrad users, including SysAdmin
 | 
|---|
| 68 |  ; 
 | 
|---|
| 69 |  S TXTYPE="VR-HP",GPREF=$NA(^MAG(2006.68,PREFIEN,TXTYPE)),PDIV=""  ; Hanging Protocols
 | 
|---|
| 70 |  I TXID=11 G:'READONLY SAVE S REPLY="Access for updating Hanging Protocols denied." G RPCINZ  ; Store HP by label
 | 
|---|
| 71 |  I TXID=12 G TAGS    ; Get HP Labels
 | 
|---|
| 72 |  I TXID=13 G PRFDATA ; Get data for HP labels
 | 
|---|
| 73 |  I TXID=14 G:'READONLY TAGDEL S REPLY="Access for deleting Hanging Protocol denied." G RPCINZ  ; Delete HP labels
 | 
|---|
| 74 |  ; 
 | 
|---|
| 75 |  E  S REPLY="0~Invalid transaction (TX="_TXID_") requested by MAGJ USER DATA rpc call."
 | 
|---|
| 76 | RPCINZ S @MAGGRY@(0)=0_U_REPLY
 | 
|---|
| 77 |  Q
 | 
|---|
| 78 |  ;
 | 
|---|
| 79 | GETPRIEN(DUZ,READONLY) ; Lookup/create User Pref entry for input DUZ
 | 
|---|
| 80 |  ; READONLY: True for lookup-only (no create)
 | 
|---|
| 81 |  N T,X,PREFIEN
 | 
|---|
| 82 |  S PREFIEN=$O(^MAG(2006.68,"AC",+DUZ,"")) I 'PREFIEN,'READONLY D
 | 
|---|
| 83 |  . L +^MAG(2006.68,0):10
 | 
|---|
| 84 |  . E  Q
 | 
|---|
| 85 |  . S X=$G(^MAG(2006.68,0))
 | 
|---|
| 86 |  . S PREFIEN=+$P(X,U,3)
 | 
|---|
| 87 |  . F  S PREFIEN=PREFIEN+1 I '$D(^MAG(2006.68,PREFIEN)) Q
 | 
|---|
| 88 |  . S T=$P(X,U,4)+1,$P(X,U,3)=PREFIEN,$P(X,U,4)=T
 | 
|---|
| 89 |  . S ^MAG(2006.68,0)=X
 | 
|---|
| 90 |  . S T=$$USER(+DUZ),^MAG(2006.68,PREFIEN,0)=$P(T,U)_U_+DUZ_U_$P(T,U,3)
 | 
|---|
| 91 |  . S ^MAG(2006.68,"B",$P(T,U),PREFIEN)=""
 | 
|---|
| 92 |  . S ^MAG(2006.68,"AC",+DUZ,PREFIEN)=""
 | 
|---|
| 93 |  . L -^MAG(2006.68,0)
 | 
|---|
| 94 |  Q PREFIEN
 | 
|---|
| 95 |  ;
 | 
|---|
| 96 | SAVE ;  Save User Pref data by Label
 | 
|---|
| 97 |  N NEWTAG,STUFF,LINCT,LBLCT,DUMMY,KEYS
 | 
|---|
| 98 |  S NEWTAG=0,STUFF=0,LINCT=0,LBLCT=0,DUMMY=0,KEYS=0
 | 
|---|
| 99 |  S IDATA=""
 | 
|---|
| 100 |  F  S IDATA=$O(DATA(IDATA)) Q:IDATA=""  S LINE=DATA(IDATA) I LINE]"" D
 | 
|---|
| 101 |  . I LINE="*LABEL" S NEWTAG=1,STUFF=0 Q
 | 
|---|
| 102 |  . I LINE="*END" S NEWTAG=0,STUFF=0 Q
 | 
|---|
| 103 |  . I NEWTAG S TAG=LINE D TAGINIT(TAG) Q  ; Init the storage for this tag
 | 
|---|
| 104 |  . I 'STUFF S TAG="*DUM" D TAGINIT(TAG) ; got text line w/out prior label; init dummy tag
 | 
|---|
| 105 |  . S TAGCT=TAGCT+1,@GPREF@(TAGIEN,1,TAGCT,0)=LINE,LINCT=LINCT+1
 | 
|---|
| 106 |  . S $P(@GPREF@(TAGIEN,1,0),U,3,4)=TAGCT_U_TAGCT
 | 
|---|
| 107 |  . I TAG="*DUM" S LINCT=LINCT-1 ; don't count dummy lines/labels
 | 
|---|
| 108 |  . I LINE="*KEY" S KEYS=1
 | 
|---|
| 109 |  . I KEYS D
 | 
|---|
| 110 |  . . S KEYCT=+$P($G(@GPREF@(TAGIEN,2,0)),U,4)+1,^(0)="^2006.6823^"_KEYCT_U_KEYCT
 | 
|---|
| 111 |  . . S @GPREF@(TAGIEN,2,KEYCT,0)=LINE
 | 
|---|
| 112 |  . I LINE="*END_KEY" S KEYS=0
 | 
|---|
| 113 | SAVEZ  I LINCT S REPLY=1_"~"_LINCT_" Text line"_$S(LINCT-1:"s",1:"")_" were stored for "_LBLCT_" label"_$S(LBLCT-1:"s.",1:".")
 | 
|---|
| 114 |  E  S REPLY="0~No data was stored."
 | 
|---|
| 115 |  S @MAGGRY@(0)=0_U_REPLY
 | 
|---|
| 116 |  I DUMMY ; n/a
 | 
|---|
| 117 |  Q
 | 
|---|
| 118 | TAGINIT(TAG) ; Init storage space for a tag; inits some vars for SAVE
 | 
|---|
| 119 |  N TAGCTRL
 | 
|---|
| 120 |  I PDIV,(TAG'="*DUM") S TAG=PDIV_"*DIV*"_TAG ; tags tracked by division
 | 
|---|
| 121 |  S TAGIEN=$O(@GPREF@("B",TAG,"")) I 'TAGIEN D  ; for new tag, create a new LABEL node,
 | 
|---|
| 122 |  . L +@GPREF@(0):10
 | 
|---|
| 123 |  . E  Q
 | 
|---|
| 124 |  . S X=$G(@GPREF@(0)) S:X="" X="^2006.682A^0^0"
 | 
|---|
| 125 |  . S TAGIEN=$P(X,U,3)
 | 
|---|
| 126 |  . F  S TAGIEN=TAGIEN+1 I '$D(@GPREF@(TAGIEN)) Q
 | 
|---|
| 127 |  . S T=$P(X,U,4)+1,$P(X,U,3)=TAGIEN,$P(X,U,4)=T
 | 
|---|
| 128 |  . S @GPREF@(0)=X,@GPREF@("B",TAG,TAGIEN)=""
 | 
|---|
| 129 |  . L -@GPREF@(0)
 | 
|---|
| 130 |  . S $P(@GPREF@(TAGIEN,0),U)=TAG
 | 
|---|
| 131 |  I TAG'="*DUM"!((TAG="*DUM")&'DUMMY) D
 | 
|---|
| 132 |  . S TAGCTRL=$G(@GPREF@(TAGIEN,1,0)) K @GPREF@(TAGIEN,1),^(2) ; init Data & Keys
 | 
|---|
| 133 |  . S $P(TAGCTRL,U,2)=2006.6821,$P(TAGCTRL,U,3,4)=0_U_0
 | 
|---|
| 134 |  . S @GPREF@(TAGIEN,1,0)=TAGCTRL
 | 
|---|
| 135 |  . S TAGCT=0,LBLCT=LBLCT+1
 | 
|---|
| 136 |  I TAG="*DUM" S TAGCT=+$P(@GPREF@(TAGIEN,1,0),U,3),LBLCT=LBLCT-'DUMMY,DUMMY=1 ; don't count dummy label
 | 
|---|
| 137 |  S NEWTAG=0,STUFF=1
 | 
|---|
| 138 |  Q
 | 
|---|
| 139 |  ;
 | 
|---|
| 140 | TAGS ; return list of tags stored
 | 
|---|
| 141 |  ; don't report *DUM tags
 | 
|---|
| 142 |  N TAG,CT,OTAG,TAGCT,TAGIEN
 | 
|---|
| 143 |  S TAG=0,CT=0,TAGCT=0
 | 
|---|
| 144 |  F  S TAG=$O(@GPREF@("B",TAG)) Q:TAG=""  S TAGIEN=$O(^(TAG,"")) I TAG'="*DUM" D
 | 
|---|
| 145 |  . I PDIV Q:PDIV'=+TAG  S OTAG=$P(TAG,"*DIV*",2,99)
 | 
|---|
| 146 |  . E  S OTAG=TAG
 | 
|---|
| 147 |  . S CT=CT+1,@MAGGRY@(CT)=OTAG,TAGCT=TAGCT+1
 | 
|---|
| 148 |  . I $D(@GPREF@(TAGIEN,2)) S KEYCT=0 D
 | 
|---|
| 149 |  . . F  S KEYCT=$O(@GPREF@(TAGIEN,2,KEYCT)) Q:'KEYCT  S X=^(KEYCT,0),CT=CT+1,@MAGGRY@(CT)=X
 | 
|---|
| 150 |  I TAGCT S REPLY=1_"~"_TAGCT_" tag"_$S(TAGCT-1:"s",1:"")_" returned."
 | 
|---|
| 151 |  E  S REPLY="0~No data found."
 | 
|---|
| 152 | TAGSZ S @MAGGRY@(0)=CT_U_REPLY
 | 
|---|
| 153 |  Q
 | 
|---|
| 154 |  ;
 | 
|---|
| 155 | SYSUSER(X) ; get System user DUZ value
 | 
|---|
| 156 |  S X=.5 ; =Postmaster
 | 
|---|
| 157 |  Q:$Q X Q
 | 
|---|
| 158 |  ;
 | 
|---|
| 159 | USER(DUZ) ; get user name, initials & vrad user type
 | 
|---|
| 160 |  N RSL,X S RSL=DUZ
 | 
|---|
| 161 |  I DUZ=$$SYSUSER() S RSL="sysAdmin^SYS^9"
 | 
|---|
| 162 |  E  I DUZ D
 | 
|---|
| 163 |  . S RSL=$$USERINF^MAGJUTL3(DUZ,".01;1")
 | 
|---|
| 164 |  . F X="S","R","T" I $D(^VA(200,"ARC",X,DUZ)) Q
 | 
|---|
| 165 |  . I  S X=$S(X="S":3,X="R":2,X="T":1,1:0)
 | 
|---|
| 166 |  . E  S X=0
 | 
|---|
| 167 |  . S RSL=RSL_U_X
 | 
|---|
| 168 |  Q:$Q RSL Q
 | 
|---|
| 169 |  ;
 | 
|---|
| 170 | USERS ; return list of users stored -- Sort: System User/Radiologists/Non-Rists
 | 
|---|
| 171 |  ; DUZ ^ FULL NAME ^ INITIALS ^ USER TYPE
 | 
|---|
| 172 |  N CT,IEN,INIT,NAME,TOUT,USERTYP
 | 
|---|
| 173 |  S IEN=0,CT=0
 | 
|---|
| 174 |  F  S IEN=$O(^MAG(2006.68,IEN)) Q:'IEN  S X=^(IEN,0) D
 | 
|---|
| 175 |  .  S USERDUZ=$P(X,U,2)
 | 
|---|
| 176 |  .  S X=$$USER(USERDUZ),NAME=$P(X,U),INIT=$P(X,U,2),USERTYP=$P(X,U,3)
 | 
|---|
| 177 |  .  I NAME="" S NAME="~"
 | 
|---|
| 178 |  .  S TOUT(-USERTYP,NAME,USERDUZ)=INIT
 | 
|---|
| 179 |  S USERTYP="" F  S USERTYP=$O(TOUT(USERTYP)) Q:USERTYP=""  S NAME="" D
 | 
|---|
| 180 |  . F  S NAME=$O(TOUT(USERTYP,NAME)) Q:NAME=""  S USERDUZ="" D
 | 
|---|
| 181 |  . . F  S USERDUZ=$O(TOUT(USERTYP,NAME,USERDUZ)) Q:'USERDUZ  D
 | 
|---|
| 182 |  . . . S CT=CT+1,@MAGGRY@(CT)=USERDUZ_U_NAME_U_TOUT(USERTYP,NAME,USERDUZ)_U_-USERTYP
 | 
|---|
| 183 |  I CT S REPLY=1_"~"_CT_" user"_$S(CT-1:"s",1:"")_" returned."
 | 
|---|
| 184 |  E  S REPLY="0~No data found."
 | 
|---|
| 185 | USERSZ ;
 | 
|---|
| 186 |  S @MAGGRY@(0)=CT_U_REPLY
 | 
|---|
| 187 |  Q
 | 
|---|
| 188 |  ; 
 | 
|---|
| 189 | PRFDATA ; RETURN data stored for input Labels
 | 
|---|
| 190 |  N TAGS,IDATA,CT,NTAGS,LINCT,OTAG,TAG,TAGCT,TAGIEN,X
 | 
|---|
| 191 |  S IDATA="",CT=0,NTAGS=0,LINCT=0
 | 
|---|
| 192 |  F  S IDATA=$O(DATA(IDATA)) Q:IDATA=""  S TAG=DATA(IDATA) I TAG]"" D
 | 
|---|
| 193 |  . I PDIV,(TAG'="*DUM") S TAG=PDIV_"*DIV*"_TAG ; tags tracked by div
 | 
|---|
| 194 |  . S TAGS(TAG)=""
 | 
|---|
| 195 |  S TAG=0
 | 
|---|
| 196 |  F  S TAG=$O(TAGS(TAG)) Q:TAG=""  S TAGIEN=$O(@GPREF@("B",TAG,"")),NTAGS=NTAGS+1 D
 | 
|---|
| 197 |  . S OTAG=TAG I PDIV S OTAG=$P(TAG,"*DIV*",2,99)
 | 
|---|
| 198 |  . S CT=CT+1,@MAGGRY@(CT)="*LABEL",CT=CT+1,@MAGGRY@(CT)=OTAG I TAGIEN S TAGCT=0 D
 | 
|---|
| 199 |  . . F  S TAGCT=$O(@GPREF@(TAGIEN,1,TAGCT)) Q:'TAGCT  S X=^(TAGCT,0),CT=CT+1,@MAGGRY@(CT)=X,LINCT=LINCT+1
 | 
|---|
| 200 |  . S CT=CT+1,@MAGGRY@(CT)="*END"
 | 
|---|
| 201 |  I CT S REPLY=1_"~"_LINCT_" Text line"_$S(LINCT-1:"s",1:"")_" returned for "_NTAGS_" tags."
 | 
|---|
| 202 |  E  S REPLY="0~No data found."
 | 
|---|
| 203 | PRFZ S @MAGGRY@(0)=CT_U_REPLY
 | 
|---|
| 204 |  Q
 | 
|---|
| 205 |  ;
 | 
|---|
| 206 | TAGDEL ; Delete tags and assoc data
 | 
|---|
| 207 |  I READONLY S REPLY="0~No tags deleted; read-only access permitted." G TAGDELZ
 | 
|---|
| 208 |  N TAG,CT,IDATA,TAG,TAGIEN,ERR
 | 
|---|
| 209 |  S TAG=0,CT=0,IDATA="",ERR=""
 | 
|---|
| 210 |  F  S IDATA=$O(DATA(IDATA)) Q:IDATA=""  S TAG=DATA(IDATA) I TAG]"" D
 | 
|---|
| 211 |  . I PDIV,(TAG'="*DUM") S TAG=PDIV_"*DIV*"_TAG ; tags tracked by div
 | 
|---|
| 212 |  . S TAGIEN=$O(@GPREF@("B",TAG,"")) I TAGIEN D
 | 
|---|
| 213 |  . . L +@GPREF@(0):10
 | 
|---|
| 214 |  . . E  S ERR="0~Unable to perform Delete operation." Q
 | 
|---|
| 215 |  . . K @GPREF@(TAGIEN),@GPREF@("B",TAG)
 | 
|---|
| 216 |  . . S X=$G(@GPREF@(0),"^2006.682A^0^0") S T=+$P(X,U,4) S:T T=T-1 S $P(X,U,4)=T,^(0)=X
 | 
|---|
| 217 |  . . L -@GPREF@(0)
 | 
|---|
| 218 |  . . S CT=CT+1
 | 
|---|
| 219 |  I CT S REPLY=1_"~"_CT_" label"_$S(CT-1:"s",1:"")_" deleted."
 | 
|---|
| 220 |  E  S REPLY=$S(ERR]"":ERR,1:"0~No label data found.")
 | 
|---|
| 221 | TAGDELZ S @MAGGRY@(0)=0_U_REPLY
 | 
|---|
| 222 |  Q
 | 
|---|
| 223 |  ;
 | 
|---|
| 224 | END ;
 | 
|---|