11.7 Change Workitem State Transaction

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

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 / Transfer-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
Name	Values	User Agent	Origin Server	Description
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 transfer encoding has not been applied to the payload
Transfer-Encoding	encoding	C	M	Shall be present if a transfer encoding has been applied to the payload

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

Prev	Up	Next
11.6.3.3 Response Payload	Home	11.7.2 Behavior