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 4
Description:
============
The Veterans Health Information Systems and Technology Architecture
(VistA) Immunizations Enhancements (VIMM) 2.0 project, Increment 4, builds
upon the file structures and standardized data introduced in Increments 1,
2 and 3 by adding functional enhancements to the existing VistA Patient
Care Encounter (PCE) package.
This patch provides the following new features:
1) Introduces a new file, V IMMUNIZATION DELETED (#9000080.11), that will
contain entries that were deleted out of the V IMMUNIZATION file
(#9000010.11). Immediately prior to deleting an entry from the V
IMMUNIZATION file, a copy of the record will be made and filed to the V
IMMUNIZATION DELETED file. The date/time of deletion and the user that
deleted the record will be recorded.
2) Creates Remote Procedure Calls (RPCs) for use by the Enterprise Health
Management Platform (eHMP) project, the Computerized Patient Record
System (CPRS) software and others. These RPCs retrieve skin test
information from the following files:
- V SKIN TEST (#9000010.12)
- SKIN TEST (#9999999.28)
- IMM ADMINISTRATION SITE (BODY) (#920.3)
3) Creates a RPC to retrieve immunization data from the V IMMUNIZATION
(#9000010.11) file. This data will be used in the future to retrieve
patient immunization data and transmit it, using the Health Level 7
(HL7) standard protocol, to external agencies (e.g., State Immunization
Information Registries). As part of this effort, a new option will be
introduced with this patch, Accounting Of Immunization Disclosures
Report [PXV IMM DISCLOSURE REPORT], that can be run from the PCE
Coordinator Menu [PX PCE COORDINATOR MENU]. This option can be used to
generate a list of immunization records transmitted to external
agencies. This option allows for a date range selection as well as one,
multiple or all agencies and one, multiple or all patients.
4) Previously, auditing has been turned on for all fields of the V
IMMUNIZATION (#9000010.11) file. Additional safe guards are added to
ensure auditing is not turned off and the data audits cannot be purged
for the V IMMUNIZATION file.
5) The existing immunization inventory functionality is updated to
include multi-divisional features:
- Inventory items may be linked to an associated facility.
- Inventory reports are facility specific.
6) The immunization entry process is updated to require the entry of
Dose, Dose Units, Route of Administration and Site of Administration
(Note: If route is ORAL, site is not required.).
7) The PX SAVE DATA remote procedure call (RPC) has been modified to
provide support for the following fields in the V SKIN TEST file
(#9000010.12):
- READER (#.07)
- ORDERING PROVIDER (#1202)
- ANATOMIC LOCATION OF PLACEMENT (#1212)
- READING COMMENTS (#1301)
8) The functionality for the Health Summary component PCE IMMUNIZATIONS
(IM) is modified to ignore time and occurrence limits, basically
restoring pre-patch PX*1*210 behavior.
9) Provides an alert whenever specific allergy-type contraindications are
recorded, as a reason for not giving an immunization, in the V IMM
CONTRA/REFUSAL EVENTS file (#9000010.707). The alert text reads: "You
have recorded an allergy/adverse reaction contraindication reason. This
information should also be recorded in the Adverse Reaction Tracking
package if it is not already present there."
Patch Components:
-----------------
APIs Associated:
API New/Modified/Deleted
----------- --------------------
VSKIN^PXPXRM (ICR #4250) Modified
Files & Fields Associated:
File Name (Number) Field Name (Number) New/Modified/Deleted
------------------ ------------------- --------------------
IMM EXTERNAL AGENCY AGENCY NAME (#.01) New
(#920.71)
V IMMUNIZATION IMMUNIZATION (#.01) Modified
(#9000010.11) EVENT DATE AND TIME Modified
(#1201)
DATE/TIME RECORDED Modified
(#1205)
TIMESTAMP (#1221) New
EVENT INFORMATION Modified
SOURCE (#1301)
DISCLOSED TO (multiple New
(field #820, sub-file
#9000010.1182)
AGENCY (#.01) of the New
DISCLOSED TO sub-file
(#9000010.1182)
DISCLOSURE DATE/TIME New
(#.02) of the
DISCLOSED TO sub-file
(#9000010.1182)
IMMUNIZATION LOT LOT NUMBER (#.01) Modified
(#9999999.41) MANUFACTURER (#.02) Modified
VACCINE (#.04) Modified
ASSOCIATED VA FACILITY New
(#.1)
V IMMUNIZATION
DELETED (#9000080.11) IMMUNIZATION (#.01) New
PATIENT NAME (#.02) New
VISIT (#.03) New
SERIES (#.04) New
LOT (#.05) ) New
REACTION (#.06) New
CONTRAINDICATED (#.07) New
DOSE OVERRIDE (#.08) New
INJECTION SITE (#.09) New
VOLUME (#.11) New
DATE OF VAC INFO STATEMENT (#.12) New
CREATED BY V CPT ENTRY (#.13) New
VAC ELIGIBILITY (#.14) New
IMPORT FROM OUTSIDE REGISTRY New
(#.15)
NDC (#.16) New
ADMINISTRATIVE NOTES (#1) New
VIS OFFERED/GIVEN TO PATIENT
(multiple field #2, sub-file
#9000080.112) New
VIS OFFERED/GIVEN TO PATIENT
(#.01) of the VIS OFFERED/GIVEN
TO PATIENT sub-file
(#9000080.112) New
DATE VIS OFFERED/GIVEN (#.02) of
the VIS OFFERED/GIVEN TO PATIENT
sub-file (#9000080.112) New
OTHER DIAGNOSIS (multiple field #3,
sub-file #9000080.113) New
OTHER DIAGNOSIS (#.01) of the
OTHER DIAGNOSIS sub-file
(#9000080.113) New
REMARKS (#1101) New
EVENT DATE AND TIME (#1201) New
ORDERING PROVIDER (#1202) New
CLINIC (#1203) New
ENCOUNTER PROVIDER (#1204) New
DATE/TIME RECORDED (#1205) New
IMMUNIZATION DOCUMENTER (#1206) New
LOT NUMBER (#1207) New
PARENT (#1208) New
EXTERNAL KEY (#1209) New
OUTSIDE PROVIDER NAME (#1210) New
ANCILLARY POV (#1213) New
USER LAST UPDATE (#1214) New
ORDERING LOCATION (#1215) New
DATE/TIME ENTERED (#1216) New
ENTERED BY (#1217) New
DATE/TIME LAST MODIFIED (#1218) New
LAST MODIFIED BY (#1219) New
WARNING ACKNOWLEDGED (#1220) New
EVENT INFORMATION SOURCE (#1301) New
ROUTE OF ADMINISTRATION (#1302) New
SITE OF ADMINISTRATION (BODY)
(#1303) New
PRIMARY DIAGNOSIS (#1304) New
DOSE (#1312) New
DOSAGE (#1312.5) New
DOSE UNITS (#1313) New
SNOMED CT (multiple field #2601,
sub-file #9000080.1126) New
SNOMED CT (#.01) of the SNOMED CT
sub-file (#9000080.1126) New
SNOMED PREFERRED TERM (#.019) of
the SNOMED CT sub-file
(#9000080.1126) New
LOINC CODES (multiple field #2701,
sub-file #9000080.1127) New
LOINC CODES (#.01) of the LOINC
CODES sub-file (#9000080.1127) New
LOINC TEXT (#.019) of the LOINC
CODES sub-file (#9000080.1127) New
RESULTS (#1401) New
READING (#1402) New
DATE/TIME READ (#1403) New
READER (#1404) New
READING RECORDED (#1405) New
HOURS READ POST-INOCULATION
(#1406) New
READING COMMENT (#1501) New
WARNING OVERRIDE REASON
(#1601) New
EDITED FLAG (#80101) New
AUDIT TRAIL (#80102) New
COMMENTS (#81101) New
VERIFIED (#81201) New
PACKAGE (#81202) New
DATA SOURCE (#81203) New
DISCLOSED TO (multiple New
(field #820, sub-file
#9000080.1182)
AGENCY (#.01) of the New
DISCLOSED TO sub-file
(#9000080.1182)
DISCLOSURE DATE/TIME New
(#.02) of the
DISCLOSED TO sub-file
(#9000080.1182)
DELETED BY (#88001) New
DATE/TIME DELETED (#88002) New
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 IMM DISCLOSURE REPORT Run Routine New
Parameters Associated:
Parameter Definition Name New/Modified/Deleted
------------------------- --------------------
PXV SK DAYS BACK New
Protocols Associated:
Protocol Name New/Modified/Deleted
------------- --------------------
RPCs Associated:
RPC New/Modified/Deleted
------------- --------------------
PXVIMM ICR LIST Modified
PXVIMM IMM DETAILED Modified
PXVIMM IMM DISCLOSURE New
PXVIMM IMM LOT Modified
PXVIMM VIMM DATA New
PXVSK DEF SITES New
PXVSK SKIN SHORT LIST New
PXVSK V SKIN TEST LIST New
PX SAVE DATA Modified
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):
-----------------------------
N/A
Defect Tracking System Ticket(s) & Overview:
--------------------------------------------
N/A
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
VIMM Patch PX*1*216 PX_1_P216_IG.PDF (binary)
Installation Guide
Patch Installation:
Pre/Post Installation Overview:
-------------------------------
The pre-installation process deletes the trigger cross-reference from the
EVENT DATE AND TIME (#1201) field of the V IMMUNIZATION (#9000010.11)
file. The trigger will be moved to the IMMUNIZATION (#.01) field. The
trigger sets the DATE/TIME RECORDED (#1205) field.
The post-installation process sets a node in the V IMMUNIZATION data
dictionary (DD) that prevents a user from being able to purge data audits
for the V IMMUNIZATION file.
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_216- Loading branch information
1 parent
1671aaa
commit 0900ffc