Update MWL status to COMPLETED for received studies

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.

1. 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
   

2. Store the study to archive.

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

3. 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 :