Received Studies - amsalama/dcm4chee-arc-light GitHub Wiki

One may choose to send Procedure Status Update HL7 Order OMG^O19 message or Observation Reporting ORU^R01 message to external systems on receive of studies. This can also be applicable when there is no possibility of archive receiving a MWL or MPPS referencing the studies.

• Configure a HL7 Receiver

• By default, the archive is pre-configured with a * HL7 Application, which implies that it can accept HL7 messages from any system, even those which are not capable of sending the correct Application and Facility name in MSH segment. When the archive acts as a sender of HL7 messages, it is recommended to clone this HL7 application in order that the Sending Application and Facility Name is reflected in the outgoing HL7 messages from the archive. Hence, go to Menu -> Configuration -> Devices -> dcm4chee-arc -> Device Extension -> Child Objects -> HL7 Application -> * -> Clone this HL7 application. Specify a suitable name eg. HL7SND|DCM4CHEE and Save.

• Next, to configure other settings to activate this feature, go back to Device Extension -> Archive Device Extension.

• Set appropriate values for HL7 Procedure Status Update Task Polling Interval and HL7 Procedure Status Update Delay.

• Select HL7 Procedure Status Message Type as OMG^O19 or ORU^R01.

• If, HL7 Procedure Status Message Type is selected as OMG^O19 and if it's required to also send Patient related information in this HL7 Procedure Status Update Eyecare message, then set HL7 Procedure Status Update PID PV1 to True.

• If, HL7 Procedure Status Message Type is selected as ORU^R01 then Patient related information is always sent. Hence, setting HL7 Procedure Status Update PID PV1 to True is not explicitly required.

• Select the above configured HL7 Receiver as HL7 Procedure Status Update Receiving Application and
  the cloned HL7 application on the device extension level as HL7 Procedure Status Update Sending Application and Save.

• Optional attributes which may be set / configured as required by one's application :

    HL7 Procedure Status Update Attribute Conditions
    HL7 Procedure Status Update Requested Procedure ID
    HL7 Procedure Status Accession Number
    HL7 Procedure Status Filler Order Number
    HL7 Procedure Status Placer Order Number
    HL7 Procedure Status Update Tasks Fetch Size
  

• Start hl7rcv tool which simulates an external system capable of receiving HL7 messages.

  hl7rcv -b 2576
  

• Send studies to archive using storescu tool which simulates modalities sending studies to archive.

  storescu -c DCM4CHEE@localhost:11112 /path-to-studies
  

• Once the configured HL7 Procedure Status Update Task Polling Interval and HL7 Procedure Status Update Delay values are reached, verify in the hl7rcv tool window, that the OMG^O19 or ORU^R01 messages are received for the studies stored to the archive. Alternatively, these messages are also stored on the filesystem path where you started the tool.

• Optionally, one may also go to Monitoring page Queues tab and select HL7 Forward Tasks and verify the HL7Send tasks as COMPLETED