Create outgoing HL7 Procedure Status Update messages by XSLT

[gunterze]

• Create outgoing HL7 Procedure Status Update messages by XSLT instead of hard coded in java code, configurable by attributes

Name	Description	LDAP Attribute
HL7 Procedure Status Update on MPPS Template URI	URL of XSL style sheet to create HL7v2 message to notify configured HL7 receivers about changes of the Status of requested Procedures triggered by MPPS.	hl7PSUMppsTemplateURI
HL7 Procedure Status Update on Study Received Template URI	URL of XSL style sheet to create HL7v2 message to notify configured HL7 receivers about changes of the Status of requested Procedures triggered by received Study.	hl7PSUStudyTemplateURI

on Archive Device or Archive Network AE level.

• Replace

Name	Description	LDAP Attribute
HL7 Procedure Status Update Accession Number	Value for Accession Number in notification message, if there are no Scheduled Procedure Steps of a Requested Procedure (MWL Items in the DB) with matching Study Instance UID. {} will be replaced by the value of attribute in the received study.	hl7PSUAccessionNumber
HL7 Procedure Status Update Filler Order Number	Value for Filler Order Number in notification message, if there are no Scheduled Procedure Steps of a Requested Procedure (MWL Items in the DB) with matching Study Instance UID. {} will be replaced by the value of attribute in the received study.	hl7PSUAccessionNumber
HL7 Procedure Status Update Placer Order Number	Value for Placer Order Number in notification message, if there are no Scheduled Procedure Steps of a Requested Procedure (MWL Items in the DB) with matching Study Instance UID. {} will be replaced by the value of attribute in the received study.	hl7PSUAccessionNumber
HL7 Procedure Status Update Requested Procedure ID	Value for Requested Procedure ID in notification message, if there are no Scheduled Procedure Steps of a Requested Procedure (MWL Items in the DB) with matching Study Instance UID. {} will be replaced by the value of attribute in the received study.	hl7PSUAccessionNumber

with

Name	Description	LDAP Attribute
HL7 Procedure Status Update Template Parameters	XSLT parameters passed to style sheet specified by HL7 Procedure Status Update MPPS Template URI or HL7 Procedure Status Update Study Template URI.	hl7PSUTemplateParam

on Archive Device or Archive Network AE level,
thereby allowing for more flexibility to add more DICOM fields to be populated in outgoing notification message, if required. By default, following DICOM fields shall be pre-configured and supported by default, conforming to configurations of existing fields and conforming to requirement of mandatory fields as per EYECARE-22 OBR segment & RAD-132 OBR segment

New Config		Old Config
Config Field	Default Values	Config Field	Default Value
HL7 Procedure Status Update Param	RequestedProcedureID={StudyInstanceUID,hash}	HL7 Procedure Status Update Requested Procedure ID	{StudyInstanceUID,hash}
	AccessionNumber={StudyInstanceUID,hash}	HL7 Procedure Status Update Accession Number	{StudyInstanceUID,hash}
	PlacerOrderNumberImagingServiceRequest={StudyInstanceUID,hash}	HL7 Procedure Status Update Placer Order Number	{StudyInstanceUID,hash}
	FillerOrderNumberImagingServiceRequest={StudyInstanceUID,hash}	HL7 Procedure Status Update Filler Order Number	{StudyInstanceUID,hash}

• Provide stylesheets in vendor data of default configuration:

  • mpps2hl7-psu.xsl (referred by Archive Device attribute HL7 Procedure Status Update on MPPS Template URI in default
  • dcm2hl7-psu.xsl (referred by Archive Device attribute HL7 Procedure Status Update on Study Template URI in default configuration)

• Fixes bugs in existing HL7 procedure status update outgoing notifications (hardcoded in code)

  • PID / PV1 segments are not placed in right order
  • Issuer of Accession Number Sequence incorrectly set in OBR.19 if outgoing notification is ORU^R01 or if outgoing notification is OMG^O19 and triggered on received study without association to MWL.
  • HL7 procedure status update outgoing notification as OMG^O19 is not sent if MWL exists and HL7 Procedure Status Update for Requested Procedure is disabled.
  • Sending Character Set to be populated in MSH-18 or not is validated against ISO IR-6 instead of ASCII - Related Consider configured HL7SendingCharacterSet for sending HL7 Messages #971
  • HL7PSUTask creation / update LOG info does not show info about store session

• Improves existing HL7 procedure status update outgoing notifications (hardcoded in code)

  • Enables ORU^R01 notifications also on MPPS trigger or for studies received associated with MWL. Previously, ORU^R01 notifications were limited to receive of studies (- without association to MWL), as per literal consideration from EBIW RAD-132

    This transaction is used to notify a system that images (typically newly acquired in the course of a patient encounter) are available to the patient record. The notification is an HL7 v2.5.1 Unsolicited Observation (ORU) message.

  • OBR segment streamlined and kept consistent for EYECARE-22 OMG^O19 and EBIW RAD-132 ORU^R01. Previously, OMG^O19 OBR contained only Required fields

    All of the fields in the OBR segment are optional, except those listed in Table 4.22.4.1.2.4-1.

  • Usage of Use HL7 Null Value is made independent of ADT^A31. Related HL7: Use HL7 v2 null values (|""|) in sent ADT^A31 messages #999
  • Sending Character Set to be populated in MSH-18 or not validated against ASCII (i.e. ISO IR-6) now applicable to all outgoing HL7 messages, as per IHE ITI TF Vol 2 - Appendices - HL7 Message Profiling Convention - Message Control - Related Consider configured HL7SendingCharacterSet for sending HL7 Messages #971

    Field MSH-18 - Character Set shall only be valued if the message utilizes character sets other than ISO IR-6, also known as ASCII applicable to all outgoing HL7 messages

• Update Notify external HL7 receivers on Procedure Status Updates

Related #500, #2372, #2407