DICOM PS3.18 2020e - Web Services

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".

DICOM PS3.18 2020e - Web Services