Basic Worklist Management Service Examples
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The DICOM `Basic Worklist Management Service <http://dicom.nema.org/medical/dicom/current/output/html/part04.html#chapter_K>`_
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 <http://dicom.nema.org/medical/dicom/current/output/chtml/part04/sect_K.6.html#sect_K.6.1.2>`_
for the *Identifier*.

.. code-block:: python

   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 :doc:`Query/Retrieve (Find) SCP example <qr_find>`.