- RAAPI ;HISC/GJC,RTK - API & function utilities ;04/16/07 15:02
- ;;5.0;Radiology/Nuclear Medicine;**47**;Mar 16, 1998;Build 21
- ;
- ;Integration Agreements
- ;----------------------
- ;$$NS^XUAF4(2171); $$KSP^XUPARAM(2541)
- ;
- ACCNUM(RADFN,RADTI,RACNI) ; return the site specific accession number
- ;internal use for the VistA Radiology application
- ;
- ;input : RADFN=the DFN of the patient record in the PATIENT (#2) file
- ; RADTI=inverse date/time of the exam
- ; RACNI=the IEN of the case level record
- ;return: sss-mmddyy-case# (site specific accession number)
- ;
- I RADFN=""!(RADTI="")!(RACNI="") Q "" ;all MUST be defined
- N RAC,RAD,RAE S RAE=$G(^RADPT(RADFN,"DT",RADTI,"P",RACNI,0)) ;exam node
- S RAC=9999999.9999-RADTI ;RAC=FM internal date/time
- S RAD=$E(RAC,4,7)_$E(RAC,2,3)_"-"_+RAE ;mmddyy-case#
- Q $E($P($$NS^XUAF4($$KSP^XUPARAM("INST")),U,2),1,3)_"-"_RAD
- ;
- ACCFIND(Y,RAA) ;
- ;
- ;input : Y=the accession number in either a 'sss-mmddyy-xxxxx' or
- ; 'mmddyy-xxxxx' format
- ; : RAA(n)=the array used to return the data in the following
- ; format RADFN_^_RADTI_^_RACNI
- ;
- ;return: n>0 successful, else n<0... 'n' is the number of array
- ; elements when successful. When unsuccessful (n<0) 'n' is
- ; a specific error dialog which is returned along with the
- ; invalid accession number.
- ;
- ; Examples:
- ; -1^"invalid site accession number format"^accession #
- ; -2^"invalid accession number format"^accession #
- ; -3^"no data associated with this accession number"^accession #
- ;
- I $L(Y,"-")=3 Q:Y'?3N1"-"6N1"-"1.5N "-1^invalid site accession number format^"_Y
- I $L(Y,"-")=2 Q:Y'?6N1"-"1.5N "-2^invalid accession number format^"_Y
- N X S X=$S($L(Y,"-")=3:$NA(^RADPT("ADC1")),1:$NA(^RADPT("ADC")))
- Q:$O(@X@(Y,0))'>0 "-3^no data associated with this accession number^"_Y
- N RADFN,RADTI,RACNI,Z S:$D(U)#2=0 U="^"
- S (RADFN,Z)=0 F S RADFN=$O(@X@(Y,RADFN)) Q:'RADFN D
- .S RADTI=0 F S RADTI=$O(@X@(Y,RADFN,RADTI)) Q:'RADTI D
- ..S RACNI=0 F S RACNI=$O(@X@(Y,RADFN,RADTI,RACNI)) Q:'RACNI D
- ...S Z=Z+1,RAA(Z)=RADFN_U_RADTI_U_RACNI
- ...Q
- ..Q
- .Q
- Q Z ;success
- ;
- ACCRPT(Y,RAA) ;return accession number(s) given file #74 pointer value - RTK
- ;
- ;input : Y=pointer to a record in file #74
- ; : RAA(n)=the array used to return the data.
- ;
- ;return: n>0 successful, n<0 unsuccessful
- ;
- ; When successful, 'n' is the number of array elements.
- ; If n=1 the single accession number is returned in RAA(1)
- ; If n>1, the "lead" accession number (for printsets) is
- ; returned in RAA(1) and subsequent ones are returned in
- ; RAA(2) thru RAA(n)
- ; Accession numbers are returned in either "mmddyy-case#" or
- ; "sss-mmddyy-case#" format
- ; When unsuccessful, n<0, an error message is
- ; returned along with the invalid file #74 pointer value.
- ;
- K RAA N RADCN,RAOTHCS,RARPTIEN,Z S RARPTIEN=Y
- I '$D(^RARPT(Y,0)) Q "-1^invalid file #74 pointer value^"_Y
- S RADCN=$P($G(^RARPT(RARPTIEN,0)),U,1) ;day-case #
- S Z=1,RAA(Z)=RADCN
- F RAOTHCS=0:0 S RAOTHCS=$O(^RARPT(RARPTIEN,1,RAOTHCS)) Q:RAOTHCS'>0 D
- .S Z=Z+1,RAA(Z)=$P($G(^RARPT(RARPTIEN,1,RAOTHCS,0)),U,1)
- Q Z
- ;
- SIUID() ; called from [RA REGISTER] template, creates the STUDY INSTANCE UID
- ; also called directly from RAMAG03C for exams created thru the importer
- ; RADFN, RADTI and RACNI are set in RA REGISTER template/RAMAG03C
- N RASSAN,RASIUID S RASIUID=""
- ; if SSAN exists use it to build RASIUID
- S RASSAN=$$SSANVAL^RAHLRU1(RADFN,RADTI,RACNI)
- I RASSAN'="" S RASIUID=$$STUDYUID^MAGDRAHL(RADTI,RACNI,RASSAN) Q RASIUID
- ; else if RASSAN="" do the lines below to use the legacy acc #
- N RAC,RAD,RAE S RAE=$G(^RADPT(RADFN,"DT",RADTI,"P",RACNI,0)) ;exam node
- S RAC=9999999.9999-RADTI ;RAC=FM internal date/time
- S RAD=$E(RAC,4,7)_$E(RAC,2,3)_"-"_+RAE ;mmddyy-case#
- S RASIUID=$$STUDYUID^MAGDRAHL(RADTI,RACNI,RAD)
- Q RASIUID
- ;
- GETSIUID(RADFN,RADTI,RACNI) ; return the value of the exam's SIUID
- Q $G(^RADPT(RADFN,"DT",RADTI,"P",RACNI,"SIUID"))
- ;
- SIUIDFND(Y,RAA) ; return exam data for a given study instance UID
- ;input : Y=the study instance UID
- ; : RAA(1)=variable to hold the data in the following format:
- ; RADFN_^_RADTI_^_RACNI
- ;
- ;return: n=1 if successful, else n<-1 with error message
- ; When successful, n=1 and RAA(1) is returned in above format
- ; When unsuccessful 'n' is a specific error dialog
- ; which is returned along with the invalid study instance UID:
- ; -1^"no data associated with this study instance UID"^siuid
- ;
- K RAA N RADFN,RADTI,RACNI S RASIUID=Y,Z=0
- S RADFN=0 F S RADFN=$O(^RADPT("ASIUID",RASIUID,RADFN)) Q:'RADFN D
- .S RADTI=0 F S RADTI=$O(^RADPT("ASIUID",RASIUID,RADFN,RADTI)) Q:'RADTI D
- ..S RACNI=0 F S RACNI=$O(^RADPT("ASIUID",RASIUID,RADFN,RADTI,RACNI)) Q:'RACNI D
- ...S Z=Z+1,RAA(Z)=RADFN_"^"_RADTI_"^"_RACNI
- I Z=0 Q "-1^no data associated with this study instance UID^"_RASIUID
- Q Z
- --- Routine Detail --- with STRUCTURED ROUTINE LISTING ---[H[J[2J[HRAAPI 5124 printed Jan 18, 2025@03:34:43 Page 2
- RAAPI ;HISC/GJC,RTK - API & function utilities ;04/16/07 15:02
- +1 ;;5.0;Radiology/Nuclear Medicine;**47**;Mar 16, 1998;Build 21
- +2 ;
- +3 ;Integration Agreements
- +4 ;----------------------
- +5 ;$$NS^XUAF4(2171); $$KSP^XUPARAM(2541)
- +6 ;
- ACCNUM(RADFN,RADTI,RACNI) ; return the site specific accession number
- +1 ;internal use for the VistA Radiology application
- +2 ;
- +3 ;input : RADFN=the DFN of the patient record in the PATIENT (#2) file
- +4 ; RADTI=inverse date/time of the exam
- +5 ; RACNI=the IEN of the case level record
- +6 ;return: sss-mmddyy-case# (site specific accession number)
- +7 ;
- +8 ;all MUST be defined
- IF RADFN=""!(RADTI="")!(RACNI="")
- QUIT ""
- +9 ;exam node
- NEW RAC,RAD,RAE
- SET RAE=$GET(^RADPT(RADFN,"DT",RADTI,"P",RACNI,0))
- +10 ;RAC=FM internal date/time
- SET RAC=9999999.9999-RADTI
- +11 ;mmddyy-case#
- SET RAD=$EXTRACT(RAC,4,7)_$EXTRACT(RAC,2,3)_"-"_+RAE
- +12 QUIT $EXTRACT($PIECE($$NS^XUAF4($$KSP^XUPARAM("INST")),U,2),1,3)_"-"_RAD
- +13 ;
- ACCFIND(Y,RAA) ;
- +1 ;
- +2 ;input : Y=the accession number in either a 'sss-mmddyy-xxxxx' or
- +3 ; 'mmddyy-xxxxx' format
- +4 ; : RAA(n)=the array used to return the data in the following
- +5 ; format RADFN_^_RADTI_^_RACNI
- +6 ;
- +7 ;return: n>0 successful, else n<0... 'n' is the number of array
- +8 ; elements when successful. When unsuccessful (n<0) 'n' is
- +9 ; a specific error dialog which is returned along with the
- +10 ; invalid accession number.
- +11 ;
- +12 ; Examples:
- +13 ; -1^"invalid site accession number format"^accession #
- +14 ; -2^"invalid accession number format"^accession #
- +15 ; -3^"no data associated with this accession number"^accession #
- +16 ;
- +17 IF $LENGTH(Y,"-")=3
- if Y'?3N1"-"6N1"-"1.5N
- QUIT "-1^invalid site accession number format^"_Y
- +18 IF $LENGTH(Y,"-")=2
- if Y'?6N1"-"1.5N
- QUIT "-2^invalid accession number format^"_Y
- +19 NEW X
- SET X=$SELECT($LENGTH(Y,"-")=3:$NAME(^RADPT("ADC1")),1:$NAME(^RADPT("ADC")))
- +20 if $ORDER(@X@(Y,0))'>0
- QUIT "-3^no data associated with this accession number^"_Y
- +21 NEW RADFN,RADTI,RACNI,Z
- if $DATA(U)#2=0
- SET U="^"
- +22 SET (RADFN,Z)=0
- FOR
- SET RADFN=$ORDER(@X@(Y,RADFN))
- if 'RADFN
- QUIT
- Begin DoDot:1
- +23 SET RADTI=0
- FOR
- SET RADTI=$ORDER(@X@(Y,RADFN,RADTI))
- if 'RADTI
- QUIT
- Begin DoDot:2
- +24 SET RACNI=0
- FOR
- SET RACNI=$ORDER(@X@(Y,RADFN,RADTI,RACNI))
- if 'RACNI
- QUIT
- Begin DoDot:3
- +25 SET Z=Z+1
- SET RAA(Z)=RADFN_U_RADTI_U_RACNI
- +26 QUIT
- End DoDot:3
- +27 QUIT
- End DoDot:2
- +28 QUIT
- End DoDot:1
- +29 ;success
- QUIT Z
- +30 ;
- ACCRPT(Y,RAA) ;return accession number(s) given file #74 pointer value - RTK
- +1 ;
- +2 ;input : Y=pointer to a record in file #74
- +3 ; : RAA(n)=the array used to return the data.
- +4 ;
- +5 ;return: n>0 successful, n<0 unsuccessful
- +6 ;
- +7 ; When successful, 'n' is the number of array elements.
- +8 ; If n=1 the single accession number is returned in RAA(1)
- +9 ; If n>1, the "lead" accession number (for printsets) is
- +10 ; returned in RAA(1) and subsequent ones are returned in
- +11 ; RAA(2) thru RAA(n)
- +12 ; Accession numbers are returned in either "mmddyy-case#" or
- +13 ; "sss-mmddyy-case#" format
- +14 ; When unsuccessful, n<0, an error message is
- +15 ; returned along with the invalid file #74 pointer value.
- +16 ;
- +17 KILL RAA
- NEW RADCN,RAOTHCS,RARPTIEN,Z
- SET RARPTIEN=Y
- +18 IF '$DATA(^RARPT(Y,0))
- QUIT "-1^invalid file #74 pointer value^"_Y
- +19 ;day-case #
- SET RADCN=$PIECE($GET(^RARPT(RARPTIEN,0)),U,1)
- +20 SET Z=1
- SET RAA(Z)=RADCN
- +21 FOR RAOTHCS=0:0
- SET RAOTHCS=$ORDER(^RARPT(RARPTIEN,1,RAOTHCS))
- if RAOTHCS'>0
- QUIT
- Begin DoDot:1
- +22 SET Z=Z+1
- SET RAA(Z)=$PIECE($GET(^RARPT(RARPTIEN,1,RAOTHCS,0)),U,1)
- End DoDot:1
- +23 QUIT Z
- +24 ;
- SIUID() ; called from [RA REGISTER] template, creates the STUDY INSTANCE UID
- +1 ; also called directly from RAMAG03C for exams created thru the importer
- +2 ; RADFN, RADTI and RACNI are set in RA REGISTER template/RAMAG03C
- +3 NEW RASSAN,RASIUID
- SET RASIUID=""
- +4 ; if SSAN exists use it to build RASIUID
- +5 SET RASSAN=$$SSANVAL^RAHLRU1(RADFN,RADTI,RACNI)
- +6 IF RASSAN'=""
- SET RASIUID=$$STUDYUID^MAGDRAHL(RADTI,RACNI,RASSAN)
- QUIT RASIUID
- +7 ; else if RASSAN="" do the lines below to use the legacy acc #
- +8 ;exam node
- NEW RAC,RAD,RAE
- SET RAE=$GET(^RADPT(RADFN,"DT",RADTI,"P",RACNI,0))
- +9 ;RAC=FM internal date/time
- SET RAC=9999999.9999-RADTI
- +10 ;mmddyy-case#
- SET RAD=$EXTRACT(RAC,4,7)_$EXTRACT(RAC,2,3)_"-"_+RAE
- +11 SET RASIUID=$$STUDYUID^MAGDRAHL(RADTI,RACNI,RAD)
- +12 QUIT RASIUID
- +13 ;
- GETSIUID(RADFN,RADTI,RACNI) ; return the value of the exam's SIUID
- +1 QUIT $GET(^RADPT(RADFN,"DT",RADTI,"P",RACNI,"SIUID"))
- +2 ;
- SIUIDFND(Y,RAA) ; return exam data for a given study instance UID
- +1 ;input : Y=the study instance UID
- +2 ; : RAA(1)=variable to hold the data in the following format:
- +3 ; RADFN_^_RADTI_^_RACNI
- +4 ;
- +5 ;return: n=1 if successful, else n<-1 with error message
- +6 ; When successful, n=1 and RAA(1) is returned in above format
- +7 ; When unsuccessful 'n' is a specific error dialog
- +8 ; which is returned along with the invalid study instance UID:
- +9 ; -1^"no data associated with this study instance UID"^siuid
- +10 ;
- +11 KILL RAA
- NEW RADFN,RADTI,RACNI
- SET RASIUID=Y
- SET Z=0
- +12 SET RADFN=0
- FOR
- SET RADFN=$ORDER(^RADPT("ASIUID",RASIUID,RADFN))
- if 'RADFN
- QUIT
- Begin DoDot:1
- +13 SET RADTI=0
- FOR
- SET RADTI=$ORDER(^RADPT("ASIUID",RASIUID,RADFN,RADTI))
- if 'RADTI
- QUIT
- Begin DoDot:2
- +14 SET RACNI=0
- FOR
- SET RACNI=$ORDER(^RADPT("ASIUID",RASIUID,RADFN,RADTI,RACNI))
- if 'RACNI
- QUIT
- Begin DoDot:3
- +15 SET Z=Z+1
- SET RAA(Z)=RADFN_"^"_RADTI_"^"_RACNI
- End DoDot:3
- End DoDot:2
- End DoDot:1
- +16 IF Z=0
- QUIT "-1^no data associated with this study instance UID^"_RASIUID
- +17 QUIT Z