STC | iQ 1.16.8.1 User Guide

HL7 Transaction Log

The HL7 Transaction Log viewer displays the transaction details of an HL7 message as it moves through PHC-Hub to the IIS. This can be helpful when investigating or troubleshooting issues.

To search for and review transaction events that occur during HL7 message processing, click the HL7 Transactions Log menu link in STC | iQ. The HL7 Transaction Log viewer opens in a new browser tab or window.

Enter the filter criteria and click Search. The fields available on this search page are as follows:

Field	Description
Patient Name	Enter the patient name to search for (first or last). Names are not case-sensitive.
MRN	Enter the patient ID (medical record number) to search for.
Organization	Select the organization to search for.
Lot#	To search for patients with a specific vaccine lot number, enter it here.
Date	To search for patients within a specific date range, enter the from and to dates here.

On the search results that appear, click a column heading to sort the list and use the Previous and Next buttons to navigate through multiple pages of records. You can also click the row or the expand/collapse arrow to show/hide transaction events and details about the events. The columns available in the search results section include:

Column	Description
ID	The transaction ID.
MRN	The patient medical record number.
Patient	The patient's name.
Lot#	The lot number.
Organization	The organization/facility.
Status	The transaction event, such as Issue Resolution Validation.
Date/Time	The date and time of the message import.
HL7 (button)	Click the HL7 button to view the entire raw HL7 message.

Transaction Events

The HL7 Transaction Log displays a snapshot of data as it moves through specific processing stages. As the system processes a message, a transaction event is recorded.

NOTE: Prior to the Issue Resolution Validation event, the system validates and verifies that the facility has permission to query and send data to the IIS. If the message fails to authenticate, the record does not appear in the HL7 Transaction Log.

System Processing Event	Transaction Event that Displays in the HL7 Transaction Log Viewer
Logical decisions are made to accept or reject the message based on its content. Formatting, grammar, content, logical consistency, and data quality are all evaluated during this process.	Issue Resolution Validation
Values from multiple EHR formats are interpreted and standardized into a single, consistent IIS format.	Validation/Transformation
HL7 parsing, validation, and transformation processing are finished and the data is handed off to the registry for automated processing.	Validation/Transformation
The IIS attempts to match patient and vaccine data within the IIS (deduplication process).	Processed in IIS
Data is inserted or merged into the IIS. Patient and vaccine information can be searched and viewed in the IIS.	Saved in IIS

Transaction Details

Transaction details provide more specific information on what happened to the HL7 message of a patient record. Details are only available for two transaction events:

Processed in IIS
Saved in IIS

The following sections list all possible transaction details for an HL7 message. Not all of the messages display in the transaction event details. Details depend on what specifically occurred to the HL7 message. For example, if a patient record was placed in Ambiguous ID in the IIS, the A patient's record with the name [Name] and a DOB of [Date of Birth] has been placed in Ambiguous ID and is in line for processing message displays under the transaction event Processed in IIS.

IWeb Messages

The following may display in the HL7 Transaction Log viewer as transaction details for IWeb records.

Processed in IIS Messages

A contraindication is in line for processing for a patient placed in Ambiguous ID with the name [Name] and a DOB of [Date of Birth].
A contraindication is in line for processing.
A patient's record with the name [Name] and a DOB of [Date of Birth] has been placed in Ambiguous ID and is in line for processing.
A patient's record with the name [Name] and a DOB of [Date of Birth] has been placed in manual deduplication and is in line for processing.
A [Vaccination Type] vaccination with an administered date of [Date] is in line for processing for a patient placed in Ambiguous ID with the name [Name] and a DOB of [Date of Birth].
A [Vaccination Type] vaccination with an administered date of [Date] is in line for processing.

Saved in IIS Messages

A new contraindication has been created.
An existing contraindication has been updated.
A new patient's record with the name [Name], a DOB of [Date of Birth] and a SIIS ID of [SIIS ID] has been created.
A patient's record with the name [Name], a DOB of [Date of Birth], and a SIIS ID of [SIIS ID] has been updated.
A new [Vaccination Type] vaccination with an administered date of [Date] has been created.
An existing [Vaccination Type] vaccination with an administered date of [Date] has been updated.

imMTrax Messages

The following may display in the HL7 Transaction Log as transaction details for imMTrax records.

Processed in IIS Messages

A contraindication for [Contraindication Name] with an applies-to-date of [Date] is in line for processing.
A contraindication for [Contraindication Name] with an applies-to-date of [Date] is in line for processing for a client sent to manual merge.
A client record with the name [Name] and a DOB of [Date of Birth] is in line for processing.
A client record with the name [Name] and a DOB of [Date of Birth] has been sent to manual merge.
A client record with the name [Name], a DOB of [Date of Birth], and an imMTrax ID of [New Client ID] was eligible for auto-merge but the matching client is in a manual merge set. The client has been added to the manual merge set.
An immunization of [Vaccination Name] with a vaccination date of [Date] is in line for processing.
An immunization of [Vaccination Name] with a vaccination date of [Date] is in line for processing for a client sent to manual merge.
A responsible person with the name [Name] and a relationship of [Relationship] is in line for processing.
A responsible person with the name [Name] and relationship of [Relationship] is in line for processing for a client sent to manual merge.

Saved in IIS Messages

A contraindication for [Contraindication Name] with an applies-to-date of [Date] has been created.
A contraindication for [Contraindication Name] with an applies-to-date of [Date] has been updated during auto-merge.
A client record with the name [Name], a DOB of [Date of Birth], and a staging ID of [Staging ID] has been marked as a problem record and will not be further processed.
A client record with the name [Name], a DOB of [Date of Birth], and an imMTrax ID of [New Client ID] has been created.
A client record with the name [Name], a DOB of [Date of Birth], and an imMTrax ID of [New Client ID] has been updated.
A client record with the name [Name], a DOB of [Date of Birth], and an imMTrax ID of [New Client ID] has been created during auto-merge.
An immunization of [Vaccination Name] with a vaccination date of [Date] has been created.
An immunization of [Vaccination Name] with a vaccination date of [Date] has been updated during auto-merge.
A responsible person with the name [Name] and relationship of [Relationship] has been created.
A responsible person with the name [Name] and relationship of [Relationship] has been updated.
A responsible person with the name [Name] and relationship of [Relationship] has been updated during auto-merge.