DICOM PS3.18 2023d - Web Services

11.3 Transactions Overview

The Worklist Service consists of the transactions in Table 11.3-1.

Table 11.3-1. Worklist Service Methods and Resource Templates

Transaction

Method

Payload

Description

Request

Success Response

Create

POST

dataset

none

Creates a new Workitem

Retrieve

GET

none

dataset

Retrieves the Target Workitem

Update

POST

dataset

none

Updates the Target Workitem

Change State

PUT

none

none

Changes the state of the Target Workitem

Request Cancellation

POST

dataset

none

Requests that the origin server cancel a Workitem

Search

GET

none

results

Searches for Workitems

Subscribe

POST

none

none

Creates a Subscription to the Target Worklist or Target Workitem

Unsubscribe

DELETE

none

none

Cancels a Subscription from the Target Worklist or Target Workitem


The details of all state transition requirements can be found in Section CC.1.1 “Unified Procedure Step States” in PS3.4.

The Request Cancellation transaction does not perform an actual state transition, but it might cause a state transition.

When creating a new Workitem, to convey the Workitem UID that is to be assigned, DIMSE uses the Affected SOP instance UID in the DIMSE header. In the Web Services, the Workitem UID is included as a Query Parameter to the Create request. All Attributes in the HTTP transaction payloads are the same as those in the DIMSE payload.

DICOM PS3.18 2023d - Web Services