Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Patch Subject: PCE IMMUNIZATION ENHANCEMENTS - INCREMENT 3
Description:
============
Note: Patch PSN*4*448 must be installed before installing patch PX*1*215.
The Veterans Health Information Systems and Technology Architecture
(VistA) Immunizations Enhancements (VIMM) 2.0 project, Increment 3, builds
upon the file structures and standardized data introduced in Increments 1
and 2 by adding functional enhancements to the existing VistA Patient Care
Encounter (PCE) package.
This patch provides the following new features:
1) Creates Remote Procedure Calls (RPCs) for use by the Enterprise Health
Management Platform (eHMP) project, the Computerized Patient Record
System (CPRS) software, Data Access Service (DAS) and others. These
RPCs retrieve immunization information from the following files:
- VACCINE INFORMATION STATEMENT (#920)
- IMMUNIZATION INFO SOURCE (#920.1)
- IMM ADMINISTRATION ROUTE (#920.2)
- IMM ADMINISTRATION SITE (BODY) (#920.3)
- IMM CONTRAINDICATION REASONS (#920.4)
- IMM REFUSAL REASONS (#920.5)
- V IMM CONTRA/REFUSAL EVENTS (#9000010.707)
- IMM MANUFACTURER (#9999999.04)
- IMMUNIZATION (#9999999.14)
- IMMUNIZATION LOT (#9999999.41)
- IMM DEFAULT RESPONSES (#920.05)
2) Introduces functionality for capturing the reason(s) an immunization
was not given by documenting immunization contraindications and/or
refusal events. This functionality includes the following:
- Creation of the V IMM CONTRA/REFUSAL EVENTS file (#9000010.707)
- A WARNING UNTIL DATE may be stored for temporary
contraindications/refusals. This is the date until which the
contraindication/refusal is valid.
- When an immunization for a patient is associated with valid
contraindications/refusals (WARNING UNTIL DATE is not a past date),
the software will display a warning and the user will be required to
acknowledge the warning and enter a justification reason before
continuing with administration.
3) Inactivates the functionality of the PCE CODE MAPPING file (#811.1).
The file will still exist, but the mappings in the file will no longer
be used to determine which related entries in the V IMMUNIZATION
(#9000010.11), V SKIN TEST (#9000010.12), and V CPT (#9000010.18) files
need to automatically be recorded. From now on, the mappings in the
CODING SYSTEM multiple of the IMMUNIZATION (#9999999.14) and SKIN TEST
(#9999999.28) files will be used for this purpose. There are a few
differences with this new approach:
a) The PCE CODE MAPPING file was managed locally, while the CODING
SYSTEM multiple of the IMMUNIZATION and SKIN TEST files are
standardized and managed nationally.
b) Mappings to ICD-10 codes will now be supported. If an immunization
or skin test is mapped to an ICD-10 code, when that immunization
or skin test is documented, it will automatically file the mapped
ICD-10 code to the V POV file (#9000010.07).
c) Stop the practice of automatically recording an immunization or
skin test when a corresponding CPT code is filed. The mappings
will only be used to automatically file the corresponding codes
(CPT and ICD-10) when an immunization or skin test is documented.
However, in the reverse scenario, when a CPT code is documented,
it will not automatically record the corresponding immunization or
skin test.
d) Codes will only automatically be filed when a VA-administered
(non-historical) immunization or skin test is documented.
4) Functionality to enable a documenting provider to view some
immunization prompts with default values to accept and edit the
responses if needed. This functionality includes:
- Creation of the IMM DEFAULT RESPONSES file (#920.05) to store
facility specific default values by immunization type for ROUTE OF
ADMINISTRATION, SITE OF ADMINISTRATION, DOSE, DOSE UNITS, and COMMENTS.
- Creation of the Immunization Default Responses Enter/Edit menu option
[PXV EDIT DEFAULT RESPONSES] gives authorized users the ability to
enter or update information in the IMM DEFAULT RESPONSES file
(#920.05).
5) Updates the NDC CODE (VA) field (#.18) in the IMMUNIZATION LOT file
(#9999999.41) so access to information in the NDC/UPN file (#50.67) is
controlled by application programmer interfaces (APIs).
Patch Components:
-----------------
APIs Associated:
API New/Modified/Deleted
----------- --------------------
DATA2PCE^PXAPI (ICR #1889) Modified
GETENC^PXAPI (ICR #1894) Modified
ENCEVENT^PXKENC (ICR #1894) Modified
VICR^PXPXRM (ICR #4250) New
VICR^PXPXRMI1 (ICR #4519) New
DQSAVE^PXRPC (ICR #6386) New
IMMSTAT^PXAPIIM (ICR #6387) New
Files & Fields Associated:
File Name (Number) Field Name (Number) New/Modified/Deleted
------------------ ------------------- --------------------
IMM DEFAULT RESPONSES
(#920.05) FACILITY (#.01) New
IMMUNIZATION (multiple
field #1, sub-file
#920.051) New
IMMUNIZATION (#.01) of
the IMMUNIZATION
sub-file (#920.051) New
ROUTE OF ADMINISTRATION
(#1302) of the
IMMUNIZATION sub-file
(#920.051) New
SITE OF ADMINISTRATION
(#1303) of the
IMMUNIZATION sub-file
(#920.051) New
DOSE (#1312) of the
IMMUNIZATION sub-file
(#920.051) New
DOSE UNITS (#1313) of the
IMMUNIZATION sub-file
(#920.051) New
COMMENTS (#81101) of the
IMMUNIZATION sub-file
(#920.051) New
IMM CONTRAINDICATION
REASONS (#920.4) CONCEPT CODING SYSTEM (#.05) Modified
IMM ROUTES TO SITES
(#920.6) ROUTE (#.01) New
SITES (multiple field #1,
sub-file #920.61) New
SITES (#.01) of the SITES
sub-file (#920.61) New
V IMMUNIZATION
(#9000010.11) WARNING ACKNOWLEDGED (#1220) New
WARNING OVERRIDE REASON
(#1601) New
V SKIN TEST
(#9000010.12) CODING SYSTEM (multiple field
#3, sub-file #9000010.123) Deleted
CODING SYSTEM (#.01) of the
CODING SYSTEM sub-file
(#9000010.123) Deleted
CODE (multiple field #.02,
sub-file #9000010.1231
of the CODING SYSTEM
sub-file (#9000010.123) Deleted
CODE (#.01) of the CODE
sub-file (#9000010.1231) Deleted
V IMM CONTRA/REFUSAL
EVENTS (#9000010.707) CONTRAINDICATION/REFUSAL
(#.01) New
PATIENT NAME (#.02) New
VISIT (#.03) New
IMMUNIZATION (#.04) New
WARN UNTIL DATE (#.05) New
DATE/TIME RECORDED (#.06) New
EVENT DATE AND TIME (#1201) New
ENCOUNTER PROVIDER (#1204) New
EDITED FLAG (#80101) New
AUDIT TRAIL (#80102) New
COMMENTS (#81101) New
VERIFIED (#81201) New
PACKAGE (#81202) New
DATA SOURCE (#81203) New
IMMUNIZATION LOT
(#9999999.41) NDC CODE (VA) (#.18) Modified
PCE CODE MAPPING N/A Modified
(#811.1)
Forms Associated:
Form Name File # New/Modified/Deleted
--------- ------ --------------------
N/A
Mail Groups Associated:
Mail Group Name New/Modified/Deleted
--------------- --------------------
N/A
Options Associated:
Option Name Type New/Modified/Deleted
----------- ---- --------------------
PXV EDIT DEFAULT RESPONSES Run Routine New
PX PCE CODE MAPPING LIST Print Modified
Protocols Associated:
Protocol Name New/Modified/Deleted
------------- --------------------
PXCE ADD/EDIT MENU Modified
PXCE ICR ADD New
RPCs Associated:
RPC New/Modified/Deleted
------------- --------------------
PX SAVE DATA Modified
PXVIMM ADMIN CODES New
PXVIMM ADMIN ROUTE New
PXVIMM ADMIN SITE New
PXVIMM ICR LIST New
PXVIMM IMM DETAILED New
PXVIMM IMM FORMAT New
PXVIMM IMM LOT New
PXVIMM IMM MAN New
PXVIMM IMM SHORT LIST New
PXVIMM IMMDATA New
PXVIMM INFO SOURCE New
PXVIMM VICR EVENTS New
PXVIMM VIS New
Security Keys Associated:
Security Key Name
-----------------
N/A
Templates Associated:
Template Name Type File Name (Number) New/Modified/Deleted
------------- ---- ------------------ --------------------
N/A
Additional Information:
-----------------------
N/A
New Service Requests (NSRs):
----------------------------
N/A
Patient Safety Issues (PSIs):
-----------------------------
PSPO #2995
PSPO #3069
Defect Tracking System Ticket(s) & Overview:
--------------------------------------------
1. INC000001294271
R4956462FY15
R6300645FY16
Related Patient Safety Issues:
------------------------------
PSPO #2995
PSPO #3069
Problem:
--------
PCE CODE MAPPING issues are causing duplicate or incorrect entries to
be documented to the V IMMUNIZATION file.
Resolution:
-----------
The PCE CODE MAPPING file will be deprecated. Instead we will use the
CODING SYSTEM multiple of the IMMUNIZATION and SKIN TEST files.
Test Sites:
----------
Cleveland, OH
Heartland-East HCS, MO
San Antonio, TX
Software and Documentation Retrieval Instructions:
----------------------------------------------------
Software being released as a host file and/or documentation describing
the new functionality introduced by this patch are available.
The preferred method is to retrieve files from download.vista.domain.ext.
This transmits the files from the first available server. Sites may
also elect to retrieve files directly from a specific server.
Sites may retrieve the software and/or documentation directly using Secure
File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory at the
following OI Field Offices:
Albany: domain.ext
Hines: domain.ext
Salt Lake City: domain.ext
Documentation can also be found on the VA Software Documentation Library
at:
http://www4.domain.ext/vdl/
Title File Name FTP Mode
------------------------------------------------------------------
Patient Care Encounter (PCE) PX_1_UM_R1016.PDF (binary)
V. 1.0 User Manual
Patient Care Encounter (PCE) PX_1_TM_R1016.PDF (binary)
V.1.0 Technical Manual
Clinical Reminders (PXRM) PXRM_INDEX_TM.PDF (binary)
Index Technical Manual
VIMM Patch PX*1*215 PX_1_P215_IG.PDF (binary)
Installation Guide
Patch Installation:
Pre/Post Installation Overview:
-------------------------------
The post-installation process will generate a report from the PCE CODE
MAPPING file (#811.1) for review. The report will contain all active
mappings where either a) an inactive immunization was mapped to a CPT
code; or b) a CPT code was mapped to an immunization or skin test. The
report will be emailed to the user who installed the patch and to the mail
group specified in the REMINDER MANAGEMENT MAILGROUP field (#3) of the
CLINICAL REMINDER PARAMETERS file (#800). The report will also be sent to
the VHA National Center for Health Promotion and Disease Prevention (NCP)
for review. If it is determined that patient charts may have been affected
with erroneous data prior to the inactivating of the PCE CODE MAPPING file
with this patch, the site will be contacted and instructed to submit a
help desk ticket for resolution.
Use default answers for KIDS load/install questions.
Patch-Files: http://code.osehra.org/VistA.git/tree/master/Packages/PCE+Patient+Care+Encounter/Patches/PX_1.0_215- Loading branch information
1 parent
4eca9f8
commit 1671aaa