Print Page as PDF
GET LAB RESULTS ICR (3556)

GET LAB RESULTS    ICR (3556)

Name Value
NUMBER 3556
IA # 3556
DATE CREATED 2002/04/11
CUSTODIAL PACKAGE AUTOMATED LAB INSTRUMENTS
CUSTODIAL ISC Dallas
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE LA7QRY
NAME GET LAB RESULTS
GENERAL DESCRIPTION
Clinical Registries system requires access to the API
GCPR^LA7QRY to analyze lab tests and results.  This API is required during the
registry update process and the data extract process.
STATUS Active
KEYWORDS
  • Clinical Registries
  • Hepatitis C
  • Lab HDR
  • Lab Results
DURATION Till Otherwise Agreed
ID LA7QRY
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
GCPR
This component is passed a patient identifier, start
and end dates (for when specimens were taken) and NLT and/or LOINC codes and
specimen types.  The component passes back an array with details of any lab
tests with results that occurred within the start and end dates that were for
the LOINC or NLT codes and specimen types that were passed in.

The structure of the returned values is as described in the VistA Laboratory
VA HDR HL7 Interface Specification. This document is available from the VA
VistA Documentation Library http://www.va.gov/vdl/

Example call:
S LA7PTID="0000000000v000000^PI"
S LA7SDT="3000101"
S LA7EDT=$$NOW^XLFDT
S LA7SC="*"
S LA7SPEC="*"
S LA7DEST=$NA(^TMP("ZZTMP",$J))
S X=$$GCPR^LA7QRY(LA7PTID,LA7SDT,LA7EDT,.LA7SC,. LA7SPEC,.LA7ERR,LA7DEST,"
|^~\&")
VARIABLES TYPE VARIABLES DESCRIPTION
LA7PTID Input
Patient identifier, either SSN or MPI/ICN or medical
record number.  If MPI/ICN then should be full ICN (10 digit number followed
by "V" and six digit checksum)

Pass in the 2nd piece of this variable the type of identifier: SS = Social
Security number PI = VA MPI Integration Control Number MR = medical record
number of patient in file PATIENT/IHS (#9000001)

Example: 1000720100V271387^PI
123456789^SS
123456789^MR

LA7SDT Input
Start date of query (FileMan D/T, time optional).
LA7EDT Input
End date of query (FileMan D/T, time optional)
(FileMan D/T^type of date ("CD" or "RAD") Both start and end date values can
pass a parameter in the second piece to indicate that the date values are for
specimen collection date/time (CD) or results available date (RAD).

Example: LA7SDT="2991001.1239^CD"
LA7EDT="2991002.0331^CD"
LA7SDT="3010201^RAD"
LA7EDT="3010201^RAD"
LA7SC Input
Array of search codes, either NLT or LOINC
(code^coding system ("NLT" or "LN");
Example: LA7SC(1)="89628.0000^NLT"
LA7SC(2)="84330.0000^NLT"
LA7SC(3)="84295.0000^NLT"
LA7SC(4)="14749-6^LN"
or

The "*" (wildcard) for any code;
Example: LA7SC="*"

or

A list of subscripts (separated by commas) from
where the results will be extracted ("CH", "MI" or "SP").
Example: LA7SC="CH,MI" (CH and MI results only).

Pass in the 2nd piece of LA7SC the indicator (1) to return VUID when
available.  Example: LA7SC="*^1" or LA7SC="CH,MI^1"


LA7SPEC Input
Array of specimen types using HL7 source table 0070
or "*" (wildcard) for any code. Currently specimen type only supported for CH
and MI subscripted tests.

Example: LA7SPEC="*"
or
LA7SPEC(1)="UR"
LA7SPEC(2)="SER"
LA7SPEC(3)="PLAS"
LA7DEST Both
Closed root global reference to return search results
(optional).  If this parameter is omitted or equals an empty string, then node
^TMP("HLS",$J) is used.

Example:
LA7DEST=$NA(^TMP("ZZTMP",$J)).

The information returned in this global reference uses the structure of an HL7
message to format the results of the query.
LA7HL7 Input
HL7 field separator and encoding characters (4) to
use to encode results (optional). If undefined or incomplete (length<5) then
field separator "|" and encoding characters "^\~&" are used. See HL7 standard
for further information of use and purpose of field separator and encoding
characters.
LA7ERR Output
Array (by reference) containing any errors.

LA7ERR(error number) = text of error message The following error codes and
text are returned:

1 Invalid patient identifier passed

2 No patient found with requested identifier

3 No laboratory record for requested patient

4 Database error - missing laboratory record for requested patient

5 If ICN passed and MPI returns error then the error message for a given ICN

6 Unknown search code "_<code>_" passed, where <code> is a LOINC or NLT code
passed in input parameter LA7SC.

7 Invalid list of subscripts: '_<subscript>, where <subscript> is the value
passed in input parameter LA7SC.

99 No results found for requested parameters
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC SUBSCRIBING DETAILS
CLINICAL CASE REGISTRIES Hines
Clinical Registries system requires access to the API
GCPR^LA7QRY to analyze lab tests and results.  This API is required during the
registry update process and the data extract process.
HEALTH DATA REPOSITORY
CLINICAL PROCEDURES
SURGERY
DATE ACTIVATED 2010/07/14