| 1 | ROREXPR ;HCIOFO/SG - PREPARATION FOR DATA EXTRACTION  ; 11/2/05 8:56am
 | 
|---|
| 2 |  ;;1.5;CLINICAL CASE REGISTRIES;;Feb 17, 2006
 | 
|---|
| 3 |  ;
 | 
|---|
| 4 |  Q
 | 
|---|
| 5 |  ;
 | 
|---|
| 6 |  ;***** PREPARES VARIABLES FOR DATA EXTRACTION
 | 
|---|
| 7 |  ;
 | 
|---|
| 8 |  ; .REGLST       Reference to a local array containing registry
 | 
|---|
| 9 |  ;               names as subscripts and registry IENs as values
 | 
|---|
| 10 |  ;
 | 
|---|
| 11 |  ; [DXBEG]       Data extraction start date (individual start
 | 
|---|
| 12 |  ;               date for each patient by default).
 | 
|---|
| 13 |  ;               Time part of the parameter value is ignored.
 | 
|---|
| 14 |  ;
 | 
|---|
| 15 |  ; [DXEND]       Data extraction end date (TODAY by default)
 | 
|---|
| 16 |  ;               Time part of the parameter value is ignored.
 | 
|---|
| 17 |  ;
 | 
|---|
| 18 |  ; DXBEG and DXEND parameters may be used only for historical data
 | 
|---|
| 19 |  ; extraction. Use of these parameters for regular data extraction
 | 
|---|
| 20 |  ; process will negatively affect the package!
 | 
|---|
| 21 |  ;
 | 
|---|
| 22 |  ; This function does not kill the ROREXT("DTAR") node! It just adds
 | 
|---|
| 23 |  ; missing data areas to those that are already present in the list.
 | 
|---|
| 24 |  ;
 | 
|---|
| 25 |  ; Data extraction parameters are aggregated from individual
 | 
|---|
| 26 |  ; registry parameters as follow:
 | 
|---|
| 27 |  ;
 | 
|---|
| 28 |  ;   EXTRACT PERIOD FOR NEW PATIENT  Maximum
 | 
|---|
| 29 |  ;   LAG DAYS                        Maximum
 | 
|---|
| 30 |  ;   EXTRACTED RESULT                Union
 | 
|---|
| 31 |  ;   MAXIMUM MESSAGE SIZE            Minimum
 | 
|---|
| 32 |  ;
 | 
|---|
| 33 |  ; Return Values:
 | 
|---|
| 34 |  ;        0  Ok
 | 
|---|
| 35 |  ;       <0  Error code
 | 
|---|
| 36 |  ;
 | 
|---|
| 37 | PREPARE(REGLST,DXBEG,DXEND) ;
 | 
|---|
| 38 |  N I,IL,IR,LOINC,NODE,RC,REGIEN,REGNAME,RORBUF,RORMSG,TMP,VAL
 | 
|---|
| 39 |  K RORLRC
 | 
|---|
| 40 |  F TMP="DXBEG","HDTIEN","LD","MAXHL7SIZE","PATCH"  K ROREXT(TMP)
 | 
|---|
| 41 |  S DXBEG=$G(DXBEG)\1,DXEND=$G(DXEND)\1
 | 
|---|
| 42 |  ;
 | 
|---|
| 43 |  ;=== Data areas
 | 
|---|
| 44 |  S NODE=$$ROOT^DILFD(799.33,,1)
 | 
|---|
| 45 |  ;--- Validate the existing list
 | 
|---|
| 46 |  S IR=0
 | 
|---|
| 47 |  F  S IR=$O(ROREXT("DTAR",IR))  Q:IR'>0  D
 | 
|---|
| 48 |  . I '$D(@NODE@(IR))  K ROREXT("DTAR",IR)  Q
 | 
|---|
| 49 |  . S TMP=$G(ROREXT("DTAR",IR))
 | 
|---|
| 50 |  . S:TMP>0 ROREXT("DTAR",IR)=($P(TMP,U)\1)_U_($P(TMP,U,2)\1)
 | 
|---|
| 51 |  ;--- Add remaining data areas
 | 
|---|
| 52 |  S IR=0
 | 
|---|
| 53 |  F  S IR=$O(@NODE@(IR))  Q:IR'>0  D:'$D(ROREXT("DTAR",IR))
 | 
|---|
| 54 |  . S ROREXT("DTAR",IR)=""
 | 
|---|
| 55 |  ;
 | 
|---|
| 56 |  ;=== Main data extraction time frame
 | 
|---|
| 57 |  S ROREXT("DXEND")=$S(DXEND>0:DXEND,1:$$DT^XLFDT)
 | 
|---|
| 58 |  I DXBEG>0  S RC=0  D  Q:RC<0 RC
 | 
|---|
| 59 |  . S ROREXT("DXBEG")=DXBEG  Q:DXBEG'>ROREXT("DXEND")
 | 
|---|
| 60 |  . S RC=$$ERROR^RORERR(-32,,,,DXBEG,ROREXT("DXEND"))
 | 
|---|
| 61 |  ;
 | 
|---|
| 62 |  ;=== Check if the critical patches are installed
 | 
|---|
| 63 |  F TMP="MD*1.0*1","MC*2.3*34","GMPL*2*30"  D
 | 
|---|
| 64 |  . S:$$PATCH^XPDUTL(TMP) ROREXT("PATCH",TMP)=""
 | 
|---|
| 65 |  ;
 | 
|---|
| 66 |  ;=== Get the package version and the latest patch info
 | 
|---|
| 67 |  S TMP="CLINICAL CASE REGISTRIES"
 | 
|---|
| 68 |  S ROREXT("VERSION")=$$VERSION^XPDUTL(TMP)
 | 
|---|
| 69 |  S TMP=$$LAST^XPDUTL(TMP)  D:TMP>0
 | 
|---|
| 70 |  . S $P(ROREXT("VERSION"),U,2)=+TMP
 | 
|---|
| 71 |  . S $P(ROREXT("VERSION"),U,3)=$P(TMP,U,2)
 | 
|---|
| 72 |  ;
 | 
|---|
| 73 |  ;=== Aggregate registry parameters
 | 
|---|
| 74 |  S REGNAME="",RC=0
 | 
|---|
| 75 |  F  S REGNAME=$O(REGLST(REGNAME))  Q:REGNAME=""  D  Q:RC<0
 | 
|---|
| 76 |  . ;--- Get the registry IEN and parameters
 | 
|---|
| 77 |  . S REGIEN=$$REGIEN^RORUTL02(REGNAME,"7;10;13;13.1;15.1",.RORBUF)
 | 
|---|
| 78 |  . I REGIEN<0  S RC=REGIEN  Q
 | 
|---|
| 79 |  . ;--- Extract Period for New Patient
 | 
|---|
| 80 |  . S VAL=+$G(RORBUF("DILIST","ID",1,7))
 | 
|---|
| 81 |  . S:VAL>$G(ROREXT("EXTRDAYS")) ROREXT("EXTRDAYS")=VAL
 | 
|---|
| 82 |  . ;--- Setup the message builder call-back entry point
 | 
|---|
| 83 |  . S VAL=$$TRIM^XLFSTR($G(RORBUF("DILIST","ID",1,10)))
 | 
|---|
| 84 |  . I VAL'=""  D  Q:RC<0
 | 
|---|
| 85 |  . . S RC=$$VERIFYEP^RORUTL01(VAL)
 | 
|---|
| 86 |  . . I RC<0  D ERROR^RORERR(-44,,REGNAME,,VAL)  Q
 | 
|---|
| 87 |  . . S ROREXT("MSGBLD",REGIEN)=VAL
 | 
|---|
| 88 |  . ;--- Use the first available HL7 event protocol if it has not
 | 
|---|
| 89 |  . ;--- been defined before calling the $$PREPARE^ROREXPR
 | 
|---|
| 90 |  . D:$G(ROREXT("HL7PROT"))=""
 | 
|---|
| 91 |  . . S ROREXT("HL7PROT")=$G(RORBUF("DILIST","ID",1,13))
 | 
|---|
| 92 |  . ;--- Load maximum message size and convert it into bytes
 | 
|---|
| 93 |  . ;--- (1 Megabyte = 1024 Kb = 1024 * 1024 = 1048576 bytes)
 | 
|---|
| 94 |  . S VAL=($G(RORBUF("DILIST","ID",1,13.1))*1048576)\1
 | 
|---|
| 95 |  . I VAL>0  D  S:(TMP'>0)!(VAL<TMP) ROREXT("MAXHL7SIZE")=VAL
 | 
|---|
| 96 |  . . S TMP=+$G(ROREXT("MAXHL7SIZE"))
 | 
|---|
| 97 |  . ;--- Setup the lag interval (for regular data extraction only)
 | 
|---|
| 98 |  . D:'$G(ROREXT("DXBEG"))
 | 
|---|
| 99 |  . . S VAL=+$G(RORBUF("DILIST","ID",1,15.1))
 | 
|---|
| 100 |  . . S:VAL>$G(ROREXT("LD",1)) ROREXT("LD",1)=VAL
 | 
|---|
| 101 |  . ;--- Load list of codes of extracted Lab results
 | 
|---|
| 102 |  . I $G(RORLRC)'="*"  D  Q:RC<0
 | 
|---|
| 103 |  . . S TMP=","_REGIEN_","
 | 
|---|
| 104 |  . . D LIST^DIC(798.112,TMP,"@;.01;.02;.03","U",,,,"B",,,,"RORMSG")
 | 
|---|
| 105 |  . . I $G(DIERR)  S RC=$$DBS^RORERR("RORMSG",-9,,,798.112,TMP)  Q
 | 
|---|
| 106 |  . . Q:$G(^TMP("DILIST",$J,0))'>0
 | 
|---|
| 107 |  . . S (IL,IR,RC)=0
 | 
|---|
| 108 |  . . F  S IR=$O(^TMP("DILIST",$J,"ID",IR))  Q:IR=""  D  Q:RC
 | 
|---|
| 109 |  . . . S LOINC=$G(^TMP("DILIST",$J,"ID",IR,.01))
 | 
|---|
| 110 |  . . . ;--- All results or list of subscripts
 | 
|---|
| 111 |  . . . I LOINC="*"  D  S RC=1  Q
 | 
|---|
| 112 |  . . . . S VAL=$G(^TMP("DILIST",$J,"ID",IR,.03))
 | 
|---|
| 113 |  . . . . I VAL=""         K RORLRC  S RORLRC="*"  Q
 | 
|---|
| 114 |  . . . . I $G(RORLRC)=""  K RORLRC  S RORLRC=VAL  Q
 | 
|---|
| 115 |  . . . . F I=1:1  S TMP=$P(RORLRC,",",I)  Q:(TMP="")!(TMP=VAL)
 | 
|---|
| 116 |  . . . . S:TMP="" RORLRC=RORLRC_","_VAL
 | 
|---|
| 117 |  . . . ;--- Ignore individual codes if any subscripts
 | 
|---|
| 118 |  . . . ;--- (CH, MI, etc.) have been requested already
 | 
|---|
| 119 |  . . . Q:$G(RORLRC)'=""
 | 
|---|
| 120 |  . . . ;--- LOINC
 | 
|---|
| 121 |  . . . I LOINC>0  D  Q:RC<0  S IL=IL+1,RORLRC(IL)=TMP_"^LN"
 | 
|---|
| 122 |  . . . . S TMP=$$LNCODE^RORUTL02(LOINC)  S:TMP<0 RC=TMP
 | 
|---|
| 123 |  . . . ;--- NLT
 | 
|---|
| 124 |  . . . S TMP=$G(^TMP("DILIST",$J,"ID",IR,.02))
 | 
|---|
| 125 |  . . . S:TMP>0 IL=IL+1,RORLRC(IL)=TMP_"^NLT"
 | 
|---|
| 126 |  D CLEAN^DILF
 | 
|---|
| 127 |  K ^TMP("DILIST",$J)
 | 
|---|
| 128 |  Q:RC<0 RC
 | 
|---|
| 129 |  ;
 | 
|---|
| 130 |  ;=== Validate parameters
 | 
|---|
| 131 |  I '$G(ROREXT("DXBEG"))  S:$G(ROREXT("LD",1))'>0 ROREXT("LD",1)=1
 | 
|---|
| 132 |  ;
 | 
|---|
| 133 |  ;=== Check the HL7 parameters
 | 
|---|
| 134 |  I $G(ROREXT("HL7PROT"))'=""  D  Q:RC<0 RC
 | 
|---|
| 135 |  . S RC=$$INIT^RORHL7()
 | 
|---|
| 136 |  ;
 | 
|---|
| 137 |  ;=== Success
 | 
|---|
| 138 |  Q 0
 | 
|---|