Print Page as PDF
DBIA4801 ICR (4801)

DBIA4801    ICR (4801)

Name Value
NUMBER 4801
IA # 4801
DATE CREATED 2005/10/05
CUSTODIAL PACKAGE HEALTH DATA & INFORMATICS
USAGE Private
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE HDISVAP
NAME DBIA4801
GENERAL DESCRIPTION
Within the Lab Data file (#63), is the Microbiology
multiple (field #5, subfile #63.05), and within that is the Organism multiple
(field #12, subfile #63.3) for microbiology organisms.  This in turn contains
site specific fields (created by the option LRWU7 - Add a new internal name
for an antibiotic) for antibiotics associated with the organism.  There are
values associated with the antibiotic that meet the criteria for being
described as a set of codes:

Value             Description
----------------  -------------------------------------------------------
ALWAYS DISPLAY    Always display the result.

NEVER DISPLAY     Never display the result unless the user has the LRLAB
key that indicates user is laboratory personnel.

RESTRICT DISPLAY  Result is only displayed if the interpretation of
all antibiotics that are always displayed is resistant.

Although the set of codes has been assigned VHA Unique Identifier (VUID), new
antibiotics can be entered into VistA by a facility.  The new antibiotics are
dynamically assigned field numbers and would not automatically find
translation to a VUID.

Since this is a rare exception and one not felt to jeopardize the integrity of
the VUID model, DS proposes to handle the translation of these site specific
fields and provide APIs for the Lab application to use when converting to/from
a VUID.  This will allow for more expediency if changes are needed and ensure
that new entries are assigned VUIDs that are interpretable by the HDR.  This
DBIA contains the APIs.
STATUS Active
KEYWORDS DATA STANDARDIZATION
ID HDISVAP
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
$$LOSVUID(CODE)
Convert Lab's Organism Screen set of codes to VUID

Example:

>W $$LOSVUID^HDISVAP("A")

4500665
VARIABLES TYPE VARIABLES DESCRIPTION
CODE Input
Code representing organism screen
$$LOSVUID Output
VUID for input code

NULL returned on bad input
$$LOSCODE(VUID)
Convert Lab's Organism Screen VUID to set of codes

Example:

>W $$LOSCODE^HDISVAP(4500665)

A
VARIABLES TYPE VARIABLES DESCRIPTION
VUID Input
VUID representing organism screen
$$LOSCODE Output
Code for input VUID

NULL returned on bad input
SUBSCRIBING PACKAGE LAB SERVICE