============================================================================= Run Date: APR 29, 2025 Designation: MAG*3*369 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #264 Status: Released Compliance Date: MAY 30, 2025 ============================================================================= Subject: CERNER CVIX INTEGRATION ADAPTER (CCIA) INGEST EDIPI, CCIA TOKENS, PERSONID CACHE Category: - Informational Description: ============ NOTE: This patch is to be applied to Cerner CVIX Integration Adapter (CCIA) hosted servers only and does not have an accompanying Kernel Installation and Distribution System (KIDS) to be installed in VistA/RPMS. There are no executables or client installations that require installation at VA medical centers. This patch addresses the following issues and new capabilities: Unless noted otherwise, each change applies to CCIA. 1. Enhancement (IMAG-4470) Ensure all requests include a source-system name. 2. Enhancement (IMAG-4765) Bring in further changes from the V/CVIX code base. 3. Enhancement (IMAG-4774) Rename the Viewers online help. 4. Enhancement (IMAG-4800) Commercial off-the-shelf (COTS) package updates for VA Technical Reference Manual (TRM) compliance. 5. Enhancement (IMAG-4581) Update CCIA ingest services to allow patient ID to be the Electronic Data Interchange Personal Identifier (EDIPI). 6. Defect (IMAG-4794) CCIA ingest services only accept tokens from CCIA and do not accept tokens from CVIX. 7. Enhancement (IMAG-4832) Implement caching of PersonID lookups. 8. Enhancement (IMAG-4844) CCIA Viewer file support and enhancements. 9. Defect (IMAG-4874) Support proprietary DICOM files on CCIA for image retrieval using the Application Programming Interface (API) (via ImageWebApp). 10. Enhancement (IMAG-4884) Add support for CCIA DICOM image SOP Class UIDs (Service-Object Pair Class Unique Identifiers). 11. Defect (IMAG-4881) Update CCIA to generate imageURNs (Universal Resource Name) that do not conflict with other imageURNs on the filesystem. 12. Enhancement (IMAG-4961) Add custom note title parameter for Text Integration Utility (TIU) note creation. 13. Defect (IMAG-5026) Update CAMM attachment field from PERSON PHOTO to ATTACHMENT. Patch Components: ----------------- N/A Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: (IMAG numbers are from VA Jira) 1. Enhancement (IMAG-4470) Ensure all requests include a source-system name. Problem: -------- Users can have difficulty tracing requests to their origin. Resolution: ----------- A Tomcat filter ensures a source-system name (xxx-appName) is available as an HTTP header and is supplied a default value when absent: ccia_vixviewer for ViewerStudyWebApp and ccia_study for StudyWebApp. If the changes to CCIA are not approved, then CCIA will not allow the source-system name to persist across CCIA and C/VIX operations. 2. Enhancement (IMAG-4765) Bring in further changes from the V/CVIX code base. Problem: -------- CCIA did not include some recent changes from the C/VIX code base: A. It was possible to have multiple Installer Wizards installed on the same server potentially causing problems with the install. B. Users experience inefficiency having to navigate long paths to access the CCIA scripts folder, restart script, and CCIA Service Installation Wizard. C. The CCIA and CVIX code bases diverged and did not receive the same changes to improve error handling, logging, and static code analysis security findings. Resolution: ----------- CCIA has been updated to overlay and merge in further C/VIX code and enhancements: A. Now the command-line interface version of the CCIA Installer does not proceed if another Installer Wizard is installed and if this occurs, an error message appears informing the user to uninstall the other Installer Wizard(s). B. The CCIA Installer now adds a CCIA shortcuts folder on the desktop that includes shortcuts to the scripts folder, restart script, and installer. C. The CCIA and CVIX code bases have been brought further into line incorporating changes from C/VIX for error handling, logging, static code analysis remediation, and others. If the changes to CCIA are not approved, then CCIA will not have the most recent C/VIX code and enhancements. 3. Enhancement (IMAG-4774) Rename the Viewers online help. Problem: -------- The online CCIA VIEWER USER GUIDE named "help" was indistinguishable from other help documentation. Resolution: ----------- CCIA_VIEWER_USER_GUIDE is now the browser tabs title and downloaded file name. 4. Enhancement (IMAG-4800) Commercial off-the-shelf (COTS) package updates for VA Technical Reference Manual (TRM) compliance. Problem: -------- COTS packages required an upgrade in accordance with the TRM. Resolution: ----------- The Java version in MAG*3.0*363 was 8u391 and upgraded to 8u431 in accordance with the TRM. The Apache Tomcat version in MAG*3.0*363 was 9.0.83 and upgraded to 9.0.89 in accordance with the TRM. The LibreOffice version in MAG*3.0*363 was 7.6.2 and upgraded to 24.2.5 in accordance with the TRM. If the changes to CCIA are not approved, then CCIA will not have necessary security releases. 5. Enhancement (IMAG-4581) Update CCIA ingest services to allow patient ID to be the Electronic Data Interchange Personal Identifier (EDIPI). Problem: -------- Patient IDs are currently supplied to CCIA for Ingest APIs using only an Integration Control Number (ICN). Some ingest API consumers do not have access to an ICN and need the patient identifier in an EDIPI format. Resolution: ----------- For ingesting media and creating notes APIs, CCIA can now accept values for the patientId field in the format edipi:12345. CCIA parses out the EDIPI value from the patientId input and passes it to Oracle FHIR to translate to both an ICN and Oracle personId format. 6. Defect (IMAG-4794) CCIA ingest services only accept tokens from CCIA and do not accept tokens from CVIX. Problem: -------- The encryption key to generate tokens was the same between CCIA and CVIX, and thus there was no way to provide tokens to users that were valid for ingest services on CCIA but not valid for ingest services on CVIX. Resolution: ----------- Now tokens generated by CCIA are slightly different than tokens generated by CVIX for the use of ingest services, and neither will accept tokens produced from the other for the ingest service endpoints. CCIA ingest services continue to accept tokens from CVIX MAG*3.0*358 and earlier but do not accept tokens from CVIX starting with MAG*3.0*365. 7. Enhancement (IMAG-4832) Implement caching of PersonID lookups. Problem: -------- PersonID FHIR service lookups use a large number of resources and take up to one second for each request. Resolution: ----------- A cluster cache for the PersonID FHIR service lookups now reduces the usage of the FHIR service and the total transaction time for each request. A new properties file (PersonCache.properties) controls the cache size and clustering replication. 8. Enhancement (IMAG-4844) CCIA Viewer file support and enhancements. A. Support DOCX, RTF, and TXT files. Problem: -------- When a user views a DOCX, RTF, or TXT file in the CCIA Viewer, the file never displays. Resolution: ----------- The CCIA Viewer now uses LibreOffice to convert DOCX, RTF, and TXT files to Portable Document Format (PDF) files for display, which allows print and export. B. Support YBR_FULL files. Problem: -------- The CCIA Viewer displayed all color DICOM images incorrectly when their Photometric Interpretation, DICOM Tag (0028,0004) was YBR_FULL. The Viewer rendered the image incorrectly and, in some cases, multiple times per color channel. Resolution: ----------- The CCIA Viewer now converts DICOM images with a Photometric Interpretation of YBR_FULL (24 bits per pixel) to RGB (red, green and blue) colors. With this change, the CCIA Viewer now correctly display both single and multi-sliced color DICOM YBR_FULL images. 9. Defect (IMAG-4874) Support proprietary DICOM files on CCIA for image retrieval using the Application Programming Interface (API) (via ImageWebApp). Problem: -------- When processing proprietary DICOM files with an SOPClassUID of 1.2.840.10008.5.1.4.1.1.66 an exception was thrown. CCIA processed and modified every ECG DICOM file which resulted in proprietary DICOM files failing. Resolution: ----------- Now CCIA checks if a DICOM file is an ECG, and only if so, modifies it. Now on CCIA proprietary DICOM files no longer throw an exception when processing. 10. Enhancement (IMAG-4884) Add support for CCIA DICOM image SOP Class UIDs (Service-Object Pair Class Unique Identifiers). Problem: -------- CCIA did not return SOP Class UIDs as part of the metadata for DICOM images stored in CareAware MultiMedia (CAMM). Resolution: ----------- CCIA now returns SOP Class UIDs as part of the metadata for DICOM images stored in CAMM. 11. Defect (IMAG-4881) Update CCIA to generate imageURNs (Universal Resource Name) that do not conflict with other imageURNs on the filesystem. Problem: -------- CCIA generates imageURNs that have the potential to conflict in the cache (VixCache) due to a lack of case sensitivity for cached files. This may cause files to be incorrectly overwritten in the cache. Resolution: ----------- Now CCIA uses the instanceUIDs without any encoding in the file naming for imageURNs on the filesystem in the cache. Now files are no longer overwritten in the cache. 12. Enhancement (IMAG-4961) Add custom note title parameter for Text Integration Utility (TIU) note creation. Problem: -------- Cerner displays the subject as "default title" for all notes created through CCIA. PaceArt requested a custom value be stored in the subject. Resolution: ----------- CCIA now includes a new field called noteSubject for the REST service TIU/Note request. This field is transmitted to the CAMM publish API and displays as the value in the subject column of Cerner Millennium when viewing the note. 13. Defect (IMAG-5026) Update CAMM attachment field from PERSON PHOTO to ATTACHMENT. Problem: -------- CCIA sent an attachment to CAMM for publishing with the field PERSON PHOTO which was not desired. Resolution: ----------- CCIA now sends an attachment to CAMM for publishing with the field ATTACHMENT. Software and Documentation Retrieval Instructions: -------------------------------------------------------------------------- No software is provided to VA Medical centers as part of this informational patch release. File Title File Name -------------------------------------------------------------------------- N/A Documentation Title File Name -------------------------------------------------------------------------- Cerner CVIX Integration Adapter (CCIA) Patch Description MAG3_0369_CCIA_PATCH_DESCRIPTION.PDF Patch Installation: ------------------- Pre/Post Installation Overview: N/A Pre-Installation Instructions: N/A Installation Instructions: This is an informational patch. Refer to Change Order #: CHG0570888 for CCIA installation instructions. Pre-Installation Instructions: N/A Rollback, Back Out, or Uninstalling MAG*3.0*369 MSI -------------------------------------------------- Refer to Change Order #: CHG0570888 for CCIA installation instructions. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : MAY 07, 2024 Completed By: Date Completed: MAR 05, 2025 Released By : Date Released : APR 29, 2025 ============================================================================= Packman Mail Message: ===================== No routines included