| 1 | HDISVF04 ;ALB/RMO - 7118.11 File Utilities/API Cont.; 1/10/05@11:37:00 | 
|---|
| 2 | ;;1.0;HEALTH DATA & INFORMATICS;;Feb 22, 2005 | 
|---|
| 3 | ; | 
|---|
| 4 | ;---- Begin HDIS Term/Concept VUID Association file (#7118.11) API(s) ---- | 
|---|
| 5 | ; | 
|---|
| 6 | GETTERM(HDISTERM,HDISFARY,HDISTIEN) ;Get a Term/Concept Entry by Term/Concept and File/Field | 
|---|
| 7 | ; Input  -- HDISTERM Term/Concept Text | 
|---|
| 8 | ;           HDISFARY File/Field Array - Pass by HDISFARY(HDIS File/Field file #7115.6 IEN)="" | 
|---|
| 9 | ; Output -- 1=Successful and 0=Failure | 
|---|
| 10 | ;           If Successful: | 
|---|
| 11 | ;           HDISTIEN HDIS Term/Concept VUID Association file IEN | 
|---|
| 12 | N HDISFIEN,HDISI | 
|---|
| 13 | ;Initialize output | 
|---|
| 14 | S HDISTIEN="" | 
|---|
| 15 | ;Check for missing variables, exit if not defined | 
|---|
| 16 | I '$D(HDISTERM)!('$D(HDISFARY)) G GETTERMQ | 
|---|
| 17 | ;Check for existing Term/Concept and File/Field | 
|---|
| 18 | S HDISFIEN=0 | 
|---|
| 19 | F  S HDISFIEN=$O(HDISFARY(HDISFIEN)) Q:'HDISFIEN  D | 
|---|
| 20 | . I $D(^HDISV(7118.11,"AC",HDISFIEN)) D | 
|---|
| 21 | . S HDISI=0 | 
|---|
| 22 | . F  S HDISI=$O(^HDISV(7118.11,"AC",HDISFIEN,HDISI)) Q:'HDISI!($G(HDISTIEN))  D | 
|---|
| 23 | . . I $D(^HDISV(7118.11,HDISI,0)),$P(^(0),"^",1)=HDISTERM D | 
|---|
| 24 | . . . S HDISTIEN=HDISI | 
|---|
| 25 | GETTERMQ Q +$S($G(HDISTIEN)>0:1,1:0) | 
|---|
| 26 | ; | 
|---|
| 27 | ADDTERM(HDISTERM,HDISVUID,HDISFARY,HDISNTLF,HDISCKTF,HDISEDTM,HDISSTAT,HDISTIEN,HDISERRM) ;Add a New Term/Concept Entry | 
|---|
| 28 | ; Input  -- HDISTERM Term/Concept Text | 
|---|
| 29 | ;           HDISVUID VUID | 
|---|
| 30 | ;           HDISFARY File/Field Array - Pass by HDISFARY(HDIS File/Field file #7115.6 IEN)="" | 
|---|
| 31 | ;           HDISNTLF National Standard Flag  (Optional- Default 0) | 
|---|
| 32 | ;                    1=Yes and 0=No | 
|---|
| 33 | ;           HDISCKTF Check for Existing Term/Concept Flag  (Optional- Default 1) | 
|---|
| 34 | ;                    1=Yes and 0=No | 
|---|
| 35 | ;           HDISEDTM Effective Date/Time  (Optional- Default NOW) | 
|---|
| 36 | ;           HDISSTAT Status  (Optional- Default 0) | 
|---|
| 37 | ;                    1=Active and 0=Inactive | 
|---|
| 38 | ; Output -- 1=Successful and 0=Failure | 
|---|
| 39 | ;           If Successful: | 
|---|
| 40 | ;           HDISTIEN HDIS Term/Concept VUID Association file IEN | 
|---|
| 41 | ;           If Failure: | 
|---|
| 42 | ;           HDISERRM Error Message  (Optional) | 
|---|
| 43 | N HDISCNT,HDISERRF,HDISFDA,HDISFFNM,HDISFIEN,HDISI,HDISIEN,HDISIENS,HDISMSG,HDISNDTF,HDISOKF | 
|---|
| 44 | ;Initialize output | 
|---|
| 45 | S (HDISTIEN,HDISERRM)="" | 
|---|
| 46 | ;Check for missing variables, exit if not defined | 
|---|
| 47 | I '$D(HDISTERM)!($G(HDISVUID)'>0)!('$D(HDISFARY)) D  G ADDTERMQ | 
|---|
| 48 | . S HDISERRM="Required Variable Missing." | 
|---|
| 49 | ;Set National Standard Flag to default of 0, if needed | 
|---|
| 50 | S HDISNTLF=$S('$D(HDISNTLF):0,1:HDISNTLF) | 
|---|
| 51 | ;Set No Effective Date/Time Flag to 1 if there is no Effective Date/Time and no Status | 
|---|
| 52 | I '$G(HDISEDTM),'$G(HDISSTAT) D | 
|---|
| 53 | . S HDISNDTF=1 | 
|---|
| 54 | ;If No Effective Date/Time Flag is set to 1, Effective Date/Time Multiple should not be created | 
|---|
| 55 | I '$G(HDISNDTF) D | 
|---|
| 56 | . ;Set Effective Date/Time to default of NOW, if needed | 
|---|
| 57 | . S HDISEDTM=$S('$D(HDISEDTM):$$NOW^XLFDT,1:HDISEDTM) | 
|---|
| 58 | . ;Set Status to default of 0, if needed | 
|---|
| 59 | . S HDISSTAT=$S('$D(HDISSTAT):0,1:HDISSTAT) | 
|---|
| 60 | ;Set Check for Existing Term/Concept Flag to default of 1, if needed | 
|---|
| 61 | S HDISCKTF=$S('$D(HDISCKTF):1,1:HDISCKTF) | 
|---|
| 62 | ;Check for existing Term/Concept and File/Field, return error and exit if it exists | 
|---|
| 63 | I $G(HDISCKTF),$$GETTERM(HDISTERM,.HDISFARY) D  G ADDTERMQ | 
|---|
| 64 | . S HDISERRM="Term/Concept and File/Field already exists." | 
|---|
| 65 | ;Check for existing Term/Concept and VUID, return error and exit if it exists | 
|---|
| 66 | I $$GETIENS(HDISVUID,.HDISIENS) D  G ADDTERMQ:$G(HDISERRF) | 
|---|
| 67 | . S HDISI=0 | 
|---|
| 68 | . F  S HDISI=$O(HDISIENS(HDISI)) Q:'HDISI!($G(HDISERRF))  I $G(HDISIENS(HDISI))=HDISTERM D | 
|---|
| 69 | . . S HDISERRF=1 | 
|---|
| 70 | . . S HDISERRM="Term/Concept and VUID already exists." | 
|---|
| 71 | ;Set array for Term/Concept and VUID | 
|---|
| 72 | S HDISFDA(7118.11,"+1,",.01)=$G(HDISTERM) | 
|---|
| 73 | S HDISFDA(7118.11,"+1,",99.99)=$G(HDISVUID) | 
|---|
| 74 | ;Set array for National Standard Flag to Yes | 
|---|
| 75 | I $G(HDISNTLF) D | 
|---|
| 76 | . S HDISFDA(7118.11,"+1,",1.02)=1 | 
|---|
| 77 | ELSE  D | 
|---|
| 78 | . ;Set array for Date/Time Created and National Standard Flag to No | 
|---|
| 79 | . S HDISFDA(7118.11,"+1,",1.01)=$$NOW^XLFDT | 
|---|
| 80 | . S HDISFDA(7118.11,"+1,",1.02)=0 | 
|---|
| 81 | ;If No Effective Date/Time Flag is set to 1, Effective Date/Time Multiple should not be created | 
|---|
| 82 | I '$G(HDISNDTF) D | 
|---|
| 83 | . ;Set array for Effective Date/Time and Status | 
|---|
| 84 | . S HDISFDA(7118.12,"+2,+1,",.01)=$G(HDISEDTM) | 
|---|
| 85 | . S HDISFDA(7118.12,"+2,+1,",.02)=$G(HDISSTAT) | 
|---|
| 86 | ;Set array for File/Field | 
|---|
| 87 | S HDISFIEN=0 | 
|---|
| 88 | S HDISCNT=2 | 
|---|
| 89 | F  S HDISFIEN=$O(HDISFARY(HDISFIEN)) Q:'HDISFIEN  I $D(^HDIS(7115.6,HDISFIEN,0)) S HDISFFNM=$P(^(0),"^",1) D | 
|---|
| 90 | . S HDISCNT=HDISCNT+1 | 
|---|
| 91 | . S HDISFDA(7118.13,"+"_HDISCNT_",+1,",.01)=HDISFFNM | 
|---|
| 92 | D UPDATE^DIE("E","HDISFDA","HDISIEN","HDISMSG") | 
|---|
| 93 | ;Check for error | 
|---|
| 94 | I $D(HDISMSG("DIERR")) D | 
|---|
| 95 | . S HDISERRM=$G(HDISMSG("DIERR",1,"TEXT",1)) | 
|---|
| 96 | ELSE  D | 
|---|
| 97 | . S HDISTIEN=+$G(HDISIEN(1)) | 
|---|
| 98 | . S HDISOKF=1 | 
|---|
| 99 | D CLEAN^DILF | 
|---|
| 100 | ADDTERMQ Q +$G(HDISOKF) | 
|---|
| 101 | ; | 
|---|
| 102 | GETIENS(HDISVUID,HDISIENS) ;Get IENS for a Term/Concept by VUID | 
|---|
| 103 | ; Input  -- HDISVUID VUID | 
|---|
| 104 | ; Output -- 1=Successful and 0=Failure | 
|---|
| 105 | ;           If Successful: | 
|---|
| 106 | ;           HDISIENS Array where HDISIENS(IEN)=Term/Concept field (#.01) | 
|---|
| 107 | N HDISI | 
|---|
| 108 | ;Initialize output | 
|---|
| 109 | K HDISIENS | 
|---|
| 110 | ;Check for missing variable, exit if not defined | 
|---|
| 111 | I $G(HDISVUID)'>0 G GETIENSQ | 
|---|
| 112 | ;Check for entries by VUID | 
|---|
| 113 | S HDISI=0 | 
|---|
| 114 | F  S HDISI=$O(^HDISV(7118.11,"AVUID",HDISVUID,HDISI)) Q:'HDISI  D | 
|---|
| 115 | . I $D(^HDISV(7118.11,HDISI,0)) S HDISIENS(HDISI)=$P($G(^(0)),"^",1) | 
|---|
| 116 | GETIENSQ Q +$S($D(HDISIENS):1,1:0) | 
|---|
| 117 | ; | 
|---|
| 118 | GETVUID(HDISTIEN,HDISVUID) ;Get VUID for a Term/Concept by IEN | 
|---|
| 119 | ; Input  -- HDISTIEN HDIS Term/Concept VUID Association file IEN | 
|---|
| 120 | ; Output -- 1=Successful and 0=Failure | 
|---|
| 121 | ;           If Successful: | 
|---|
| 122 | ;           HDISVUID VUID | 
|---|
| 123 | ;Initialize output | 
|---|
| 124 | S HDISVUID="" | 
|---|
| 125 | ;Check for missing variable, exit if not defined | 
|---|
| 126 | I $G(HDISTIEN)'>0 G GETVUIDQ | 
|---|
| 127 | ;Check for VUID by IEN | 
|---|
| 128 | I $D(^HDISV(7118.11,HDISTIEN,"VUID")) S HDISVUID=$P($G(^("VUID")),"^",1) | 
|---|
| 129 | GETVUIDQ Q +$S($G(HDISVUID)>0:1,1:0) | 
|---|
| 130 | ; | 
|---|
| 131 | GETNTLF(HDISTIEN,HDISNTLF) ;Get National Standard Flag for a Term/Concept by IEN | 
|---|
| 132 | ; Input  -- HDISTIEN HDIS Term/Concept VUID Association file IEN | 
|---|
| 133 | ; Output -- 1=Successful and 0=Failure | 
|---|
| 134 | ;           If Successful: | 
|---|
| 135 | ;           HDISNTLF National Standard Flag | 
|---|
| 136 | ;Initialize output | 
|---|
| 137 | S HDISNTLF="" | 
|---|
| 138 | ;Check for missing variable, exit if not defined | 
|---|
| 139 | I $G(HDISTIEN)'>0 G GETNTLFQ | 
|---|
| 140 | ;Check for National Standard Flag by IEN | 
|---|
| 141 | I $D(^HDISV(7118.11,HDISTIEN,1)) S HDISNTLF=$P($G(^(1)),"^",2) | 
|---|
| 142 | GETNTLFQ Q +$S($G(HDISNTLF)]"":1,1:0) | 
|---|
| 143 | ; | 
|---|
| 144 | GETSTAT(HDISTIEN,HDISDTM,HDISEDTM,HDISSTAT) ;Get Effective Date and Status for a Term/Concept by IEN and Date/Time | 
|---|
| 145 | ; Input  -- HDISTIEN HDIS Term/Concept VUID Association file IEN | 
|---|
| 146 | ;           HDISDTM  Date/Time  (Optional- Default NOW for Current) | 
|---|
| 147 | ; Output -- 1=Successful and 0=Failure | 
|---|
| 148 | ;           If Successful: | 
|---|
| 149 | ;           HDISEDTM Effective Date/Time | 
|---|
| 150 | ;           HDISSTAT Status | 
|---|
| 151 | N HDIS0,HDISII | 
|---|
| 152 | ;Initialize output | 
|---|
| 153 | S (HDISEDTM,HDISSTAT)="" | 
|---|
| 154 | ;Check for missing variable, exit if not defined | 
|---|
| 155 | I $G(HDISTIEN)'>0 G GETSTATQ | 
|---|
| 156 | ;Set Date/Time to default of NOW for Current, if needed | 
|---|
| 157 | S HDISDTM=$S('$D(HDISDTM):$$NOW^XLFDT,1:HDISDTM) | 
|---|
| 158 | S:'$P(HDISDTM,".",2) HDISDTM=HDISDTM_.235959 | 
|---|
| 159 | ;Get Effective Date/Time Multiple IEN by IEN and Date/Time | 
|---|
| 160 | S HDISII=+$O(^(+$O(^HDISV(7118.11,HDISTIEN,"TERMSTATUS","B",HDISDTM),-1),0)) | 
|---|
| 161 | ;Check for Effective Date/Time and Status | 
|---|
| 162 | I $D(^HDISV(7118.11,HDISTIEN,"TERMSTATUS",HDISII,0)) S HDIS0=$G(^(0)) D | 
|---|
| 163 | . S HDISEDTM=$P(HDIS0,"^",1) | 
|---|
| 164 | . S HDISSTAT=$P(HDIS0,"^",2) | 
|---|
| 165 | GETSTATQ Q +$S($G(HDISEDTM)'=""&($G(HDISSTAT)'=""):1,1:0) | 
|---|
| 166 | ; | 
|---|
| 167 | ;---- End HDIS Term/Concept VUID Association file (#7118.11) API(s) ---- | 
|---|