Update MWL status to COMPLETED for received studies - dcm4che/dcm4chee-arc-light GitHub Wiki

Overview

This feature can be used when one needs to change the status of modality worklist entries of a study to COMPLETED when the study is received completely. One should note that if the archive receives MPPS from modalities, then this feature is not required, as the incoming MPPS updates the status of the modality worklist entries of a study to COMPLETED.

Configuration

Using Archive UI

Go to Configuration -> Devices -> dcm4chee-arc -> Device Extension -> Archive Device Extension and configure values for fields HL7 Procedure Status Update Delay, HL7 Procedure Status Update MWL to True, HL7 Procedure Status Update Task Polling Interval and HL7 Procedure Status Update Tasks Fetch Size and Save.
For testing purpose, so that one may also view COMPLETED MWLs in archive UI, uncheck COMPLETED for field Hide SPS with Status and Save.

Using LDAP

One may either

create a LDIF file (e.g.):

  version: 1
  dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: hl7PSUMWL
  hl7PSUMWL: TRUE

  dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: hl7PSUDelay
  hl7PSUDelay: PT1M

  dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: hl7PSUTaskPollingInterval
  hl7PSUTaskPollingInterval: PT1M
  
  dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  add: hl7PSUTaskFetchSize
  hl7PSUTaskFetchSize: 500

  dn: dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
  changetype: modify
  delete: dcmHideSPSWithStatusFromMWL
  dcmHideSPSWithStatusFromMWL: COMPLETED

and import it to the LDAP Server by using the ldapmodify command line utility.

or use the Add Attribute... and Add Value... function of Apache Directory Studio to add attributes on Archive Device level (e.g.: dicomDeviceName=dcm4chee-arc) or Application Entity level (e.g.: dicomAETitle=DCM4CHEE) in the Archive Configuration.

One may refer to Archive Device and Archive Network AE to understand the description of attributes.

Refer ISO-8601 Duration format for more know-how on Durations.

Note : dcmHideSPSWithStatusFromMWL:COMPLETED in above LDAP configuration is deleted only for testing purpose so that user can verify that the status is really changed to COMPLETED for the modality worklist entries. One may revert back this LDAP change after the testing is done.

Go to the Control tab on Configuration page in archive UI and reload the configuration.

Testing

One can test this feature using archive UI and dcm4che tools.

Send HL7 message to the archive. Ensure that this HL7 message has Study Instance UID that matches with the study being sent to archive (as shown in point 2)
```
  hl7snd -c localhost:2575  /path_to_msg.hl7
```

Store the study to archive.

   storescu -c DCM4CHEE@localhost:11112  /path_to_study.dcm

After waiting for the configured delay, verify the Scheduled Procedure Step Status of the modality worklist entries using the archive user interface as shown below :