DICOM PS3.18 2021c - Web Services

11.7 Change Workitem State (Current)
Prev | 11 Worklist Service and Resources | Next

## 11.7 Change Workitem State

This transaction is used to change the state of a Workitem. It corresponds to the UPS DIMSE N-ACTION operation "Change UPS State". State changes are used to claim ownership, complete, or cancel a Workitem.

### 11.7.1 Request

The request shall have the following syntax:

    PUT SP /workitems/{workitem}/state SP version CRLF

    Content-Type: dicom-media-type

    (Content-Length: uint / Content-Encoding: encoding) CRLF

    *(header-field CRLF)

    CRLF

    Payload

The user agent shall conform to the SCU behavior specified in Section CC.2.1.2 “Service Class User Behavior” in PS3.4.

#### 11.7.1.1 Target Resources

The Target Resource for this transaction is a Workitem.

#### 11.7.1.2 Query Parameters

The user agent shall supply, and the origin server shall support, the Common Query Parameters in Section 11.1.2.

#### 11.7.1.3 Request Header Fields

The origin server shall support header fields as required in Table 11.7.1-1.

The user agent shall supply in the request header fields as defined in Table 11.7.1-1.

Table 11.7.1-1. Request Header Fields

Name | Values | Usage | Description
--- | --- | --- | ---
User Agent | Origin Server
Content-Type | dicom-media-type | M | M | The Acceptable Media Types of the response payload
Content-Length | uint | C | M | Shall be present if a content encoding has not been applied to the payload
Content-Encoding | encoding | C | M | Shall be present if a content encoding has been applied to the payload

See also Section 8.4.

#### 11.7.1.4 Request Payload

The request payload shall contain the Change UPS State Data Elements as specified in Table CC.2.1-1 “Change UPS State - Action Information” in PS3.4. These data elements are:

Transaction UID (0008,1195)

  The request payload shall include a Transaction UID. The user agent creates the Transaction UID when requesting a transition to the IN PROGRESS state for a given Workitem. The user agent provides that Transaction UID in subsequent transactions with that Workitem.

Procedure Step State (0074,1000)

  The legal values correspond to the requested state transition. They are: "IN PROGRESS", "COMPLETED", or "CANCELLED".

Prev | Up | Next
11.6.3.3 Response Payload | Home | 11.7.2 Behavior

DICOM PS3.18 2021c - Web Services