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.

  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 :

update-mwl-status.png

⚠️ **GitHub.com Fallback** ⚠️