Basic Worklist Management Service Examples

The DICOM Basic Worklist Management Service provides a mechanism for a service user to access worklists on another AE. Querying of the SCP for worklists is accomplished by utilising the DIMSE C-FIND service.

Basic Worklist Management SCU

Associate with a peer DICOM Application Entity and request the worklist for the application with AE title ‘CTSCANNER’ for the 5th October 2018. The approach is very similar to that of a Query/Retrieve (Find) SCU, however BWM uses a different set of attributes for the Identifier.

from pydicom.dataset import Dataset

from pynetdicom import AE, BasicWorklistManagementPresentationContexts

# Initialise the Application Entity
ae = AE()

# Add a requested presentation context
ae.requested_contexts = BasicWorklistManagementPresentationContexts

# Create our Identifier (query) dataset
ds = Dataset()
ds.PatientName = '*'

proc_seq = Dataset()
proc_seq.ScheduledStationAETitle = 'CTSCANNER'
proc_seq.ScheduledProcedureStepStartDate = '20181005'
proc_seq.Modality = 'CT'

ds.ScheduledProcedureStepSequence = [proc_seq]

# Associate with peer AE at IP 127.0.0.1 and port 11112
assoc = ae.associate('127.0.0.1', 11112)

if assoc.is_established:
    # Use the C-FIND service to send the identifier
    # A query_model value of 'W' means use the 'Modality Worklist
    #     Information Model - Find' presentation context
    responses = assoc.send_c_find(ds, query_model='W')

    for (status, identifier) in responses:
        print('C-FIND query status: 0x{0:04x}'.format(status.Status))

        # If the status is 'Pending' then identifier is the C-FIND response
        if status.Status in (0xFF00, 0xFF01):
            print(identifier)

    # Release the association
    assoc.release()
else:
    print('Association rejected or aborted')

Basic Worklist Management SCP

The approach will be similar to the Query/Retrieve (Find) SCP example.