MAG3 CPRS TIU NOTE

To VistA Imaging Issues

MAG3 CPRS TIU NOTE

Returns a list of all images for a TIU document

NUMBER: 1015                            
 NAME: MAG3 CPRS TIU NOTE
 TAG: IMAGES                           
 ROUTINE: MAGGNTI
 RETURN VALUE TYPE: ARRAY              
 AVAILABILITY: RESTRICTED
 DESCRIPTION:
   Returns a list of all images for a TIU document
   for a TIU document
 INPUT PARAMETER: TIUDA                  
   PARAMETER TYPE: LITERAL
   MAXIMUM DATA LENGTH: 30               
   REQUIRED: YES
   SEQUENCE NUMBER: 1
 DESCRIPTION:
   Internal entry number of document i.e.  ^TIU(8925,TIUDA
 RETURN PARAMETER DESCRIPTION:
   Array of "^" delimited Image information in the format :
   $P(1^2^3) IEN^Image FullPath and name^Abstract FullPath and Name
   $P(4)   SHORT DESCRIPTION field
   $P(5)   PROCEDURE/ EXAM DATE/TIME field
   $P(6)   OBJECT TYPE
   $P(7)   PROCEDURE field
   $P(8)   Procedure Date in Display format
   $P(9)   PARENT DATA FILE image pointer
   $P(10)   the ABSTYPE :  'M' magnetic 'W' worm  'O' offline
   $P(11)   Image accessibility   'A' accessable  or  'O' offline
   $p(12^13) Dicom Series number and Dicom Image Number
   $p(14)   Count of images in the group, or 1 if a single image

Comments 9/20/05 -- K. Toppenberg

   in the Results array, it appears that the first entry is a header as follows
   Results(0) = header
   Results(1) = entry
   Results(2) = entry ...

   Header Format:
   Array of "^" delimited Image information in the format :
   $P(1)   0 = error; otherwise X (number of images)
   $P(2)   "x Images for selected TIU NOTE"  (or whatever file)
   $P(3)   IEN  (from TIU Note, or whatever file)
   $P(4)   SHORT DESCRIPTION field -- Patient Name + Note Name + DateTime
   $P(5)   Number of images (?)

   Entry Format (NOTICE: this is different than official info from Fileman, given above)
   Array of "^" delimited Image information in the format :
   $P(1)   "B2" <-- I don't know significance, but it is hard coded in.
   $P(2)   IEN
   $P(3)   Image FullPath and name
   $P(4)   Abstract FullPath and Name
   $P(5)   SHORT DESCRIPTION field
   $P(6)   PROCEDURE/ EXAM DATE/TIME field
   $P(7)   OBJECT TYPE
   $P(8)   PROCEDURE field
   $P(9)   Procedure Date in Display format
   $P(10)   PARENT DATA FILE image pointer
   $P(11)   the ABSTYPE :  'M' magnetic 'W' worm  'O' offline
   $P(12)   Image accessibility   'A' accessable  or  'O' offline
   $p(13^14) Dicom Series number and Dicom Image Number
   $p(15)   Count of images in the group, or 1 if a single image