Print Page as PDF
IAS FOR OMGCOAS1 ICR (3486)

IAS FOR OMGCOAS1    ICR (3486)

Name Value
NUMBER 3486
IA # 3486
DATE CREATED 2004/02/05
CUSTODIAL PACKAGE CORBA SERVICES
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE OMGCOAS1
NAME IAS FOR OMGCOAS1
GENERAL DESCRIPTION
This API is invoked by the server code for Remote Data
Views to request Department of Defense patient data through Station 200 to the
FHIE Framework system.  The DoD data is retrieved and placed in the common
CPRS Remote Data View format.
STATUS Active
ID OMGCOAS1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
GCPR((IEN,DATATYPE,BEGDATE,ENDDATE,ORMAX)
MAKE REQUEST FOR DATA FROM THE FRAMEWORK.

Invocation:
D GCPR^OMGCOAS1(IEN,DATATYPE,BEGDATE,ENDDATE,ORMAX)

Parameters:
IEN: Patient IEN
DATATYPE: Identifies requested report.  Datatypes currently supported:
LRO - Lab Orders
LRC - Chem & Hem
SP  - Surgical Pathology
CY  - Cytology
MI  - Microbiology
RR  - Radiology Report
RXA - Active Outpatient RX
RXOP- All Outpatient RX
ADT - Admission/Discharge/Transfer Summary
DS  - Discharge Summary
ALRG - Allergies
CONS - Consult Report
SADR - Standard Ambulatory Data
BEGDATE: Starting date for report (Fileman internal)
ENDDATE: Ending date for report (Fileman internal)
ORMAX: Maximum number of observations to retrieve Output:
Results are returned in nodes of the ^TMP global specific to the
requested report, e.g. ^TMP("ORDATA",$J) for ADT.
VARIABLES TYPE VARIABLES DESCRIPTION
IEN Input
Patient IEN
DATATYPE Input

LRO - Lab Orders
LRC - Chem & Hem
SP  - Surgical Pathology
CY  - Cytology
MI  - Microbiology
RR  - Radiology Report
RXA - Active Outpatient RX
RXOP- All Outpatient RX
ADT - Admission/Discharge/Transfer Summary
DS  - Discharge Summary
ALRG - Allergies
CONS - Consult Report
SADR - Standard Ambulatory Data
BEGDATE Input
Starting date for report (Fileman internal format)
ENDDATE Input
Ending date for report (Fileman internal format)
ORMAX Input
Maximum number of observations to retrieve
~TMP("ORDATA",$J, Output
1.1.1.1 Output

The CPRS Remote Data View server code expects the DoD data to be populated in
^TMP global nodes.  The output generated by calls to GCPR^OMGCOAS1 is
described in the following sections for each of the supported data partitions.
In each section, the global nodes in ^TMP populated by the call are
identified, and the data fields stored into these nodes are defined and mapped
to elements in one of the data model templates maintained by the NGIT
Framework.  The following templates are used:

LAB            Laboratory data                 LabWebTopTemplate0204
RAD            Radiology data                  RadWebTopTemplate0102
MED            Medications data                MedWebTopTemplate0205
ENC            Patient Encounter data          PatientEncounterTemplate0102
WL             Working List data               WorkingListTemplate0101
CONS           Consults data                   ConsultsTemplate0101

The CORBA request for DoD data may fail with an exception status.  If so, an
error message is written to the global output node in ^TMP that would
otherwise contain the Facility name.  The most common cause of an exception is
failure to connect to the Framework, in which case the error message should
appear as:

Unable to connect to DoD repository.  Please contact the
National Help Desk at 1-888-596-HELP (4357).

1.1.1.1.1       Chemistry and Hematology Data (LRC):

^TMP("LRC",$J,IDT,CNT)=CDT^SPC^TST^RSL^FLG^UNT^LO^HI
where:

IDT = Inverse collection date/time
CND = Print order sequence number from file 60
CDT = Count value for observations
SPC = Specimen for lab order in an external printable form
TST = Lab test ordered in a external printable form
RSL = Numeric result of test
FLG = Reference flag (H, *H,L,*L).
UNT = Unit of measure (external format).
LO = Reference/Therapeutic Lower bound.
HI= Reference/Therapeutic Upper bound.

^TMP("LRC ,$J,IDT, C )=Comments
^TMP("LRO",$J,IDT,CNT,"facility")=Facility


1.1.1.1.1       Standard Lab Orders Data (LRO):

^TMP("LRO",$J,IDT,cnt)=CDT^TST^SPC^URG^OS^MD^ODT^ACC^RDT^COL

where:

IDT = Inverse collection date/time of order.
cnt = Count value for observations.
CDT = Collection date/time of order.
TST = Lab test ordered.  Variable format A;B where A=internal pointer,
B=external text.
SPC = Specimen. Variable format A;B where A=internal pointer, B=external
text.
URG = Urgency of lab order.
OS = Status of lab order.
MD = Provider.  Variable format A;B where A=internal pointer, B=external
text.
ODT = Date/Time lab ordered.
ACC = Accession number of lab order.
RDT = Date/Time results for this lab order available.
COL = Lab or ward collect.

^TMP("LRO",$J,IDT,SN_FN,"facility")=Facility


1.1.1.1.1       Surgical Pathology Data:
^TMP("LRA",$J,IDT,0) = <Date/Time Specimen Taken>^<Surgical Path Acc#>
^TMP("LRA",$J,IDT,.1) = "Site/Specimen"^<Report Release Date/Time>
^TMP("LRA",$J,IDT,.1,sub1) = <Specimen ID>.<Body Site>:<Specimen Type>
^TMP("LRA",$J,IDT,1.4,sub2) = <Surgical Pathology Diagnosis text>
^TMP("LRA",$J,IDT,"facility") = <Facility>

1.1.1.1.1       Cytopathology Data:
^TMP("LRCY",$J,IDT,0) = <Date/Time Specimen taken>^<Cytopath Acc#>
^TMP("LRCY",$J,IDT,1) = "Site/Specimen"^<Report Release Date/Time>
^TMP("LRCY",$J,IDT,1,sub1) = <Specimen ID>.<Body Site>:<Specimen Type>
^TMP("LRCY",$J,IDT,"NDX",sub2) = <Cytology Diagnosis>
^TMP("LRCY",$J,IDT,"facility") = <Facility>

1.1.1.1.1       Microbiology Data:
^TMP("LRM",$J,RPT,SS)=CDT^ACC^CS^SS^TST^RSTA
^TMP("LRM",$J,RPT,SS,"RPT",n)=OC^ON^OQ  ;organism category^name^quantity
^TMP("LRM",$J,RPT,SS,"RPT",n,ant)=ANTN^SEN^INT
^TMP("LRM",$J,RPT,SS,"REPORT ,n)=text line of formatted report based on "RPT
nodes
^TMP("LRM",$J,RPT,SS,"facility")=Facility

where:

RPT = Inverse report date/time
SS = subscript value
CDT = Collection date/time
ACC = Accession
CS = Collection Sample
SS = Specimen
TST = Lab Test Ordered
RSTA = Report Status
ANTN = Antibiotic name
SEN = Sensitivity
INT = Interpretation

1.1.1.1.1       Radiology Report Data:

Global variable definitions:

GMTSIDT = reverse exam date/time

^TMP("RAE",$J,GMTSIDT,sub1,0)= <exam date> ^ <procedure> ^ <exam status> ^
<report status> ^ <prim interpreting resident> ^ <primary interpreting staff>
^ <CPT code> ^ <technologist> ^ <case number>

^TMP("RAE",$J, GMTSIDT,sub1,"facility") = <Facility>

^TMP("RAE",$J, GMTSIDT,sub1,"H",sub2) = <History text>

^TMP("RAE",$J, GMTSIDT,sub1,"R",sub2) = report text line, where report text is
formatted as follows:

<Test Name>

Exm Date: <Exam date>
Req Phys: <Primary interpreting staff>         Pat Loc:
Img Loc: <Location>
Service:

Exam: <Fill id> <Procedure>     CPT: <CPT code>

Report Status: <report status>  Date verified: <verification date>

Report:
Reason for order:
<order comments> Order Comment:
<result text>



1.1.1.1.1       All Outpatient RX Data
This call is to be used when requesting Outpatient RX data from the FHIE
Framework for display through CPRS.

^TMP("PSOO",$J,IFD,0)=ID^FD^DR^PR^ST^RX^QT^RF^EX

Where:

IFD = Inverse last fill date of Rx.
ID = Issue date of Rx.
FD = Last fill date of Rx.
DR = Drug in Rx.  Variable format A;B where A=internal pointer, B=external
text.
PR = Provider.  Variable format A;B where A=internal pointer, B=external
text.
ST = Status of Rx.  Variable format A;B where A=internal pointer, B=external
text.
RX = Rx number.
QT = Quantity of DRG in Rx.
RF = Number of refills remaining.
EX = Expire/Cancel date of Rx.

SIG = Medication instruction for this Rx. Output:

^TMP("PSOO",$J,IFD,n,0)=SIG

^TMP("PSOO",$J,IFD,"facility") = Facility [#Facility number] [,Phone number]

1.1.1.1.1       Discharge Summary report
This call is to be used when requesting Discharge Summary data from the FHIE
Framework for display through CPRS.   The DoD Discharge Summary report will be
formatted and passed in the HL7 message to the FHIE framework in formatted
form.  The report information is retrieved and displayed in the CPRS report
exactly as formatted by the DoD CHCS I site.

^TMP("ORDATA",$J,IDT, WP ,1)=1^Facility name

^TMP("ORDATA",$J, IDT, WP ,2)=2^Admitted date/time
^TMP("ORDATA",$J, IDT, WP ,3)=3^Discharge date/time
^TMP("ORDATA",$J, IDT, WP ,4)=4^Author/Dictated by
^TMP("ORDATA",$J, IDT, WP ,5)=5^Approved by
^TMP("ORDATA",$J, IDT, WP ,6)=6^Status
^TMP("ORDATA",$J, IDT,"WP",9,report line number)=9^Report text lines

1.1.1.1.1       ADT Summary report
This call is to be used when requesting ADTdata from the FHIE Framework for
display through CPRS.   The DoD ADT Summary information is passed to the FHIE
framework through the appropriate ADT HL7 messages.  The data is parsed and
formatted into the appropriate ADT summary report consistent with CPRS Remote
Data Views.

^TMP("ORDATA",$J,IDT,report line count)=report text line

Report Format:

<Patient Name>    <Social Security Number>             DOB: <Date of Birth>

<Facility Name>
<Movement Date/Time>  <Transaction Type>  <Type of Movement>
Provider/Specialty: <Provider/Specialty>  <Ward Specialty>
Attending/Ward: <Provider/Attending>  <Ward>
Admitting DX: <Admitting Diagnosis>
Bed Section: <Bed Section>     LOS: <Length of Stay>
DXLS: <DXLS>
ICD DX: <ICD DX>
Disposition Place: <Disposition Place>

Admitting Procedures:
<Adm Procedure date/time> <Admitting Procedure>

Procedure  <Procedure date/time> <Procedure>
Procedure  <Procedure date/time> <Procedure>
<< repeats with multiple observations>>

1.1.1.1.1        Allergy report
This call is to be used when requesting Allergy data from the FHIE Framework
for display through CPRS.   The DoD ADT Summary information is passed to the
FHIE framework through the appropriate HL7 messages.  The data is parsed and
formatted into the appropriate Allergy summary report consistent with CPRS
Remote Data Views.

^TMP("ORDATA",$J,IDT,"WP",1)=1^Facility Name
^TMP("ORDATA",$J,IDT,"WP",2)=2^Characteristic Observed (Allergy Reactant)
^TMP("ORDATA",$J,IDT,"WP",3)=3^Allergy Type
^TMP("ORDATA",$J,IDT,"WP",4)=4^
^TMP("ORDATA",$J,IDT,"WP",5)=5^
^TMP("ORDATA",$J,IDT,"WP",6,report line number)=6^Comments


1.1.1.1.1        Consult Report
This call is to be used when requesting Allergy data from the FHIE Framework
for display through CPRS.   The DoD ADT Summary information is passed to the
FHIE framework through the appropriate HL7 messages.  The data is parsed and
formatted into the appropriate Allergy summary report consistent with CPRS
Remote Data Views.

^TMP("ORDATA",$J,IDT,"WP",1)=1^Facility Name
^TMP("ORDATA",$J,IDT,"WP",2)=2^Request Date
^TMP("ORDATA",$J,IDT,"WP",3)=3^Completion Date
^TMP("ORDATA",$J,IDT,"WP",4)=4^Consult Service
^TMP("ORDATA",$J,IDT,"WP",5)=5^Status
^TMP("ORDATA",$J,IDT,"WP",6)=6^Procedure Type
^TMP("ORDATA",$J,IDT,"WP",7,report line number)=7^Consult
Report Text Lines

1.1.1.1.1        SADR Report

This call is to be used when requesting this SADR (Standard Ambulatory Data
Record) data from the FHIE Framework for display through CPRS.  The DoD SADR
information is passed to the FHIE framework through the appropriate SADR HL7
messages.  The data is parsed and formatted into a SADR report consistent with
CPRS Remote Data Views.

^TMP("ORDATA",$J,IDT, WP ,report line count) = report text lines

Report Format:

Date          Facility        Hospital Location

<Enc Date>     <Facility Name> <Service Code> <Service Text>

Encounter Provider ID: <Provider ID>
PCM Code: <PCM Code>
Diagnosis: <ICD9 Code> <Diagnosis Text>
...
<ICD9 Code> <Diagnosis Text>
Procedure: <MEPRS code> <Procedure Description>
...
<MEPRS code> <Procedure Description>
E and M: <E and M code> <E and M Description>

<< Diagnoses and procedures repeat for multiple occurrences in the data>>
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
ORDER ENTRY/RESULTS REPORTING
AUTOMATED MED INFO EXCHANGE
ADDED 5/26/09