VBECS LAB TEST RESULTS LOOKUP (2484)    REMOTE PROCEDURE (8994)

Name Value
NAME VBECS LAB TEST RESULTS LOOKUP
TAG TSTRSLT
ROUTINE VBECRPCA
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
DESCRIPTION
This RPC returns XML containing a list of Laboratory test results for a 
 
XML Mapping:
VistaPatientId element =  DFN
LabTestId element =       Test
TestPrintName element =   Print Name
TestResult element =      result
TestDate element =        inverse d/t (Converted to HL7 format)
 
 
XML Example:
patient within a given date range.
<LabTests>
    <LabTest>
        <VistaPatientId>378793</VistaPatientId>
        <LabTestId>3</LabTestId>
        <TestPrintName>HGB</TestPrintName>
        <TestResult>14.1</TestResult>
        <TestDate>20010910122446-0600</TestDate>
    </LabTest>
    <LabTest>
         <VistaPatientId>378793</VistaPatientId>
 
         <LabTestId>3</LabTestId>
         <TestPrintName>HGB</TestPrintName>
         <TestResult>14.4</TestResult>
         <TestDate>20010430115535-0600</TestDate>
    </LabTest>
</LabTests>
The data returned is provided by the Lab API RR^LR7OR1 in the 
^TMP("LRRR" global array in the following format.
 
^TMP("LRRR",$J,DFN,SUB,inverse d/t,sequence #)  = Test^result^L/N flag^
units^reference range^result status^^^Nat'l Code^Name^System^Verified b 
y^^Therapeutic flag^Print Name^Accession^Order#
INPUT PARAMETER
  • SDATE
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The SDATE input parameter represents the start date used to search for 
    Laboratory test results in the Lab API RR^LR7OR1.
    
  • EDATE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    The EDATE input parameter represents the end date to search for 
    Laboratory test results in the Lab API RR^LR7OR1.
    
  • DIV
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   12
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    The DIV input parameter representd the Division (Station Number) where 
    the results were obtained.
    NOTE:  This parameter is for future use.
    
  • TESTS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   999
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    An array of Laboratory Test IENs used to search for results.
      TESTS(1)="3536"
      TESTS(2)="4090"
    
  • PATS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   999
    REQUIRED:   YES
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    An array of Patient IENs used to search for Lab test results.
      PATS(1)="495943"
      PATS(2)="39282"
    
RETURN PARAMETER DESCRIPTION
XML document with a list of patient related laboratory test results 
returned from the Lab API RR^LR7OR1.