Difference between revisions of "VistA Imaging Issues"
From VistApedia
(Added a glossary link to Clinical Procedures~) |
|||
| (22 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
| + | Back to [[Programming VistA Issues]] | ||
| + | |||
| + | [[VistA Imaging Issues/RPC Calls]] | ||
| + | |||
Here are some points I have learned about VistA imaging. | Here are some points I have learned about VistA imaging. | ||
| Line 8: | Line 12: | ||
field .01 will point to a specific TIU document | field .01 will point to a specific TIU document | ||
field .02 can link to an entry in the IMAGE file | field .02 can link to an entry in the IMAGE file | ||
| − | field 1 can hold the path to a fileserver (e.g. i:\images\jr042696.bmp, etc.) | + | field 1 can hold the path to a fileserver (e.g. i:\images\jr042696.bmp, etc.) |
| + | But note: this is not where the filename is stored. It is in the IMAGE file record. | ||
IMAGE (file 2005) | IMAGE (file 2005) | ||
Holds metadata about stored images | Holds metadata about stored images | ||
| − | If there in an entry in TIU EXTERNAL DATA LINK, then the corresponding document in CPRS will show a picture icon beside it. | + | If there in an entry in TIU EXTERNAL DATA LINK (file #8925.91), then the corresponding document in CPRS will show a picture icon beside it. |
| + | |||
| + | Entry in IMAGE file will point to TIU EXTERNAL DATA LINK file, like this: | ||
| + | Here are NOTES about IMAGE file: | ||
| + | PARENT GLOBAL ROOT D0 <-- contain IEN of TIU document this links to (E.G. 14321) | ||
| + | PARENT DATA FILE# <-- 8925 (for images linked to notes) | ||
| + | PARENT DATA FILE IMAGE POINTER <-- should hold IEN of entry in TIU EXTERNAL DATA LINK | ||
| + | used to check existence of ^TIU(8925.91,IEN,0) | ||
| + | |||
| + | Here is a sample successful [[record~|Record]] in the IMAGE file | ||
| + | NUMBER: 1 | ||
| + | OBJECT NAME: test1 | ||
| + | FILEREF: triplegears.jpg | ||
| + | DISK & VOLUME, MAGNETIC: TMGImageServer <-- link to [[record~|Record]] in NETWORK LOCATION | ||
| + | DISK & VOLUME, ABSTRACT: TMGImageServer | ||
| + | OBJECT TYPE: STILL IMAGE | ||
| + | PATIENT: TEST,KILLME DON'T | ||
| + | PROCEDURE: testproc | ||
| + | DATE/TIME IMAGE SAVED: AUG 17, 2005 | ||
| + | IMAGE SAVE BY: TOPPENBERG,KEVIN S | ||
| + | SHORT DESCRIPTION: Here is a short description | ||
| + | PROCEDURE/EXAM DATE/TIME: AUG 16, 2005 | ||
| + | PARENT DATA FILE#: TIU | ||
| + | PARENT GLOBAL ROOT D0: 14321 <-- TIU IEN# for document linked to image | ||
| + | PARENT DATA FILE IMAGE POINTER: 1 <--- matches IEN of [[record~|Record]] below | ||
| + | LONG DESCRIPTION: This is an entry for the long entry field | ||
| + | TYPE INDEX: IMAGE | ||
| + | PROC/EVENT INDEX: HOLTER | ||
| + | SPEC/SUBSPEC INDEX: MEDICINE | ||
| + | ORIGIN INDEX: NON-VA | ||
| + | CLINIC: Laughlin_Office | ||
| + | ACQUISITION SITE: Medical Group of Greeneville | ||
| + | |||
| + | Here is a corresponding entry in the TIU EXTERNAL DATA LINK file | ||
| + | NUMBER: 1 | ||
| + | DOCUMENT: PRESCRIPTION CALL IN | ||
| + | IMAGE: test1 | ||
| + | LINKED DATA OBJECT: c:\somepic.jpg | ||
| + | |||
| + | Here is [[record~|Record]] in file NETWORK LOCATION | ||
| + | NUMBER: 1 | ||
| + | NETWORK LOCATION: TMGImageServer | ||
| + | PHYSICAL REFERENCE: / | ||
| + | TOTAL SPACE: 9999999 | ||
| + | SPACE USED: 0 | ||
| + | FREE SPACE: 9999999 | ||
| + | OPERATIONAL STATUS: On-Line | ||
| + | STORAGE TYPE: MAGNETIC | ||
| + | ABSTRACT: Yes | ||
| + | FULL: Yes | ||
| + | BIG: Yes | ||
| + | TEXT: Yes | ||
| + | DICOM: No | ||
| + | MAINTAINCONNECTION: NO | ||
| + | RETENTION PERIOD: 365 | ||
| + | MAX # RETRY ON CONNECT: 8 | ||
| + | MAX # RETRY ON TRANSMIT: 8 | ||
| + | LAST PURGE DATE: SEP 17, 2005@14:01:54 | ||
| + | SITE: TMG | ||
| + | USER: MANAGER,SYSTEM | ||
| + | |||
| + | With the above setup, here is the results of a call to get images for document 14321 | ||
| + | GTM>d IMAGES^MAGGNTI(.REF,14321) | ||
| + | GTM>ZWR REF(*) | ||
| + | REF(0)="1^1 Images for the selected TIU NOTE^14321^TEST,KILLME DON'T PRESCRIPTI | ||
| + | ON CALL IN 13 Jul 05@09:47:34^1" | ||
| + | REF(1)="B2^1^/triplegears.jpg^/triplegears.ABS^Here is a short description^30508 | ||
| + | 16^1^testproc^08/16/2005^1^M^A^^^1^^^^^^^^^^^" | ||
| + | |||
Kevin Toppenberg | Kevin Toppenberg | ||
| Line 23: | Line 96: | ||
It is locked with key: MAG SYSTEM | It is locked with key: MAG SYSTEM | ||
| + | |||
| + | Note: the file IMAGING SITE PARAMETERS (2006.1) should be set up. | ||
Here are some potentially relevant RPC calls | Here are some potentially relevant RPC calls | ||
| − | MAG3 CPRS TIU NOTE Returns a list of all images for a TIU document | + | [[MAGGADDIMAGE]] This is the RPC call used by VistA Imaging to add an image. |
| − | MAG3 TIU DATA FROM DA Get TIU data from the TIUDA. | + | [[MAG3 CPRS TIU NOTE]] Returns a list of all images for a TIU document |
| + | [[MAG3 TIU DATA FROM DA]] Get TIU data from the TIUDA. | ||
Returns Document Type, and Document Date/Time | Returns Document Type, and Document Date/Time | ||
| − | MAG3 TIU IMAGE Files the TIU pointer in Imaging and the Imaging Pointer in TIU. | + | [[MAG3 TIU IMAGE]] Files the TIU pointer in Imaging and the Imaging Pointer in TIU. |
| − | MAG4 ADD IMAGE Adds a new entry to the IMAGE File ^MAG(2005 | + | [[MAG4 ADD IMAGE]] Adds a new entry to the IMAGE File ^MAG(2005 |
| − | MAG4 CP CONSULT TO TIUDA Imaging Capture workstation calls this RPC to get a TIU IEN | + | [[MAG4 CP CONSULT TO TIUDA]] Imaging Capture workstation calls this RPC to get a TIU IEN |
to attach images to. | to attach images to. | ||
This call simply calls a CP API, which accepts DFN, Consult #, | This call simply calls a CP API, which accepts DFN, Consult #, | ||
Visit String (optional), Complete|Do not Complete the |transaction. | Visit String (optional), Complete|Do not Complete the |transaction. | ||
| − | MAG4 CP GET VISITS This RPC call simply call a CP Routine that lists visits for a patient. | + | [[MAG4 CP GET VISITS]] This RPC call simply call a CP Routine that lists visits for a patient. |
Imaging prompts the user with this list when a Visit String | Imaging prompts the user with this list when a Visit String | ||
is needed by CP to create a Note. | is needed by CP to create a Note. | ||
| − | MAG4 DATA FROM IMPORT QUEUE This call returns the Array of Data from the Import Queue, | + | [[MAG4 DATA FROM IMPORT QUEUE]] This call returns the Array of Data from the Import Queue, |
given a QUEUE Number Called from Delphi and 'M' | given a QUEUE Number Called from Delphi and 'M' | ||
| − | MAG4 REMOTE IMPORT Called from MS Windows Application. | + | [[MAG4 REMOTE IMPORT]] Called from MS Windows [[Application~|Application]]. |
| − | MAG4 STATUS CALLBACK This RPC is called from the Imaging Delphi component when | + | [[MAG4 STATUS CALLBACK]] This RPC is called from the Imaging Delphi component when |
an image/images have been imported via the Imaging Import API | an image/images have been imported via the Imaging Import API | ||
| − | being developed for use by Clinical Procedures. | + | being developed for use by [[Clinical Procedures~|Clinical Procedures]]. |
This call is used in the test version of Import API, it will be | This call is used in the test version of Import API, it will be | ||
replaced in the released version. In the released version the | replaced in the released version. In the released version the | ||
| Line 50: | Line 126: | ||
routine of CP. | routine of CP. | ||
| − | + | From the VistA Imaging technical manual (edited)... | |
| − | From the VistA Imaging technical manual... | ||
7.2.4 Further Information | 7.2.4 Further Information | ||
| Line 57: | Line 132: | ||
is an entry in the Image file (2005), where the object's attributes are managed. In | is an entry in the Image file (2005), where the object's attributes are managed. In | ||
addition, three auxiliary files are used: | addition, three auxiliary files are used: | ||
| − | • Object Type | + | • Object Type (2005.02) |
| − | • Network Location | + | • Network Location (2005.2) |
| − | • Parent Data | + | • Parent Data (? 2005.03--PARENT DATA FILE ?) |
The objects are then related to the patient's VISTA text data (medicine, surgery, | The objects are then related to the patient's VISTA text data (medicine, surgery, | ||
Latest revision as of 01:59, 5 September 2012
Back to Programming VistA Issues
VistA Imaging Issues/RPC Calls
Here are some points I have learned about VistA imaging.
TIU EXTERNAL DATA LINK (file 8925.91)
1 0;1 .01 DOCUMENT <-Pntr [RP8925']
2 0;2 .02 IMAGE <-Pntr [P2005']
3 1;1 1 LINKED DATA OBJECT [F]
field .01 will point to a specific TIU document
field .02 can link to an entry in the IMAGE file
field 1 can hold the path to a fileserver (e.g. i:\images\jr042696.bmp, etc.)
But note: this is not where the filename is stored. It is in the IMAGE file record.
IMAGE (file 2005) Holds metadata about stored images
If there in an entry in TIU EXTERNAL DATA LINK (file #8925.91), then the corresponding document in CPRS will show a picture icon beside it.
Entry in IMAGE file will point to TIU EXTERNAL DATA LINK file, like this:
Here are NOTES about IMAGE file: PARENT GLOBAL ROOT D0 <-- contain IEN of TIU document this links to (E.G. 14321) PARENT DATA FILE# <-- 8925 (for images linked to notes) PARENT DATA FILE IMAGE POINTER <-- should hold IEN of entry in TIU EXTERNAL DATA LINK used to check existence of ^TIU(8925.91,IEN,0)
Here is a sample successful Record in the IMAGE file NUMBER: 1 OBJECT NAME: test1 FILEREF: triplegears.jpg DISK & VOLUME, MAGNETIC: TMGImageServer <-- link to Record in NETWORK LOCATION DISK & VOLUME, ABSTRACT: TMGImageServer OBJECT TYPE: STILL IMAGE PATIENT: TEST,KILLME DON'T PROCEDURE: testproc DATE/TIME IMAGE SAVED: AUG 17, 2005 IMAGE SAVE BY: TOPPENBERG,KEVIN S SHORT DESCRIPTION: Here is a short description PROCEDURE/EXAM DATE/TIME: AUG 16, 2005 PARENT DATA FILE#: TIU PARENT GLOBAL ROOT D0: 14321 <-- TIU IEN# for document linked to image PARENT DATA FILE IMAGE POINTER: 1 <--- matches IEN of Record below LONG DESCRIPTION: This is an entry for the long entry field TYPE INDEX: IMAGE PROC/EVENT INDEX: HOLTER SPEC/SUBSPEC INDEX: MEDICINE ORIGIN INDEX: NON-VA CLINIC: Laughlin_Office ACQUISITION SITE: Medical Group of Greeneville
Here is a corresponding entry in the TIU EXTERNAL DATA LINK file NUMBER: 1 DOCUMENT: PRESCRIPTION CALL IN IMAGE: test1 LINKED DATA OBJECT: c:\somepic.jpg
Here is Record in file NETWORK LOCATION NUMBER: 1 NETWORK LOCATION: TMGImageServer PHYSICAL REFERENCE: / TOTAL SPACE: 9999999 SPACE USED: 0 FREE SPACE: 9999999 OPERATIONAL STATUS: On-Line STORAGE TYPE: MAGNETIC ABSTRACT: Yes FULL: Yes BIG: Yes TEXT: Yes DICOM: No MAINTAINCONNECTION: NO RETENTION PERIOD: 365 MAX # RETRY ON CONNECT: 8 MAX # RETRY ON TRANSMIT: 8 LAST PURGE DATE: SEP 17, 2005@14:01:54 SITE: TMG USER: MANAGER,SYSTEM
With the above setup, here is the results of a call to get images for document 14321
GTM>d IMAGES^MAGGNTI(.REF,14321)
GTM>ZWR REF(*)
REF(0)="1^1 Images for the selected TIU NOTE^14321^TEST,KILLME DON'T PRESCRIPTI
ON CALL IN 13 Jul 05@09:47:34^1"
REF(1)="B2^1^/triplegears.jpg^/triplegears.ABS^Here is a short description^30508
16^1^testproc^08/16/2005^1^M^A^^^1^^^^^^^^^^^"
Kevin Toppenberg
9-12-05
The main, top-level imaging menu option is: MAG SYS MENU It is locked with key: MAG SYSTEM
Note: the file IMAGING SITE PARAMETERS (2006.1) should be set up.
Here are some potentially relevant RPC calls
MAGGADDIMAGE This is the RPC call used by VistA Imaging to add an image. MAG3 CPRS TIU NOTE Returns a list of all images for a TIU document MAG3 TIU DATA FROM DA Get TIU data from the TIUDA. Returns Document Type, and Document Date/Time MAG3 TIU IMAGE Files the TIU pointer in Imaging and the Imaging Pointer in TIU. MAG4 ADD IMAGE Adds a new entry to the IMAGE File ^MAG(2005 MAG4 CP CONSULT TO TIUDA Imaging Capture workstation calls this RPC to get a TIU IEN to attach images to. This call simply calls a CP API, which accepts DFN, Consult #, Visit String (optional), Complete|Do not Complete the |transaction. MAG4 CP GET VISITS This RPC call simply call a CP Routine that lists visits for a patient. Imaging prompts the user with this list when a Visit String is needed by CP to create a Note. MAG4 DATA FROM IMPORT QUEUE This call returns the Array of Data from the Import Queue, given a QUEUE Number Called from Delphi and 'M' MAG4 REMOTE IMPORT Called from MS Windows Application. MAG4 STATUS CALLBACK This RPC is called from the Imaging Delphi component when an image/images have been imported via the Imaging Import API being developed for use by Clinical Procedures. This call is used in the test version of Import API, it will be replaced in the released version. In the released version the Imaging BackGround Processor will be calling the Status Callback routine of CP.
From the VistA Imaging technical manual (edited)...
7.2.4 Further Information Every individual object (i.e., an image, audio clip, waveform, or scanned document) is an entry in the Image file (2005), where the object's attributes are managed. In addition, three auxiliary files are used: • Object Type (2005.02) • Network Location (2005.2) • Parent Data (? 2005.03--PARENT DATA FILE ?)
The objects are then related to the patient's VISTA text data (medicine, surgery, laboratory, radiology reports or progress notes) through the use of pointers, both forward from the VISTA package file to the Image file, and backwards from the Image file to the VISTA package file.
Software allows new objects to be added and displayed. Several additional files are used by the system. These include: • Imaging Workstations file that contains information about every workstation on the network. • Image Histologic Stain file, and a Microscopic Objective file used by anatomic pathology. • Imaging Site Parameters file.
