DICOM PS3.18 2021e - Web Services

11.8 Request Cancellation

This transaction allows a user agent that does not own a Workitem to request that it be canceled. It corresponds to the UPS DIMSE N-ACTION operation "Request UPS Cancel". See Section CC.2.2 in PS3.4 .

To cancel a Workitem that the user agent owns, i.e., that is in the IN PROGRESS state, the user agent uses the Change Workitem State transaction as described in Section 11.7.

11.8.1 Request

The request shall have the following syntax:

POST SP /workitems/{workitem}/cancelrequest 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.2.2 “Service Class User Behavior” in PS3.4.

11.8.1.1 Target Resources

The Target Resource for this transaction is a Workitem.

11.8.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.8.1.3 Request Header Fields

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

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

Table 11.8.1-1. Request Header Fields

Name

Values

Usage

Description

User Agent

Origin Server

Content-Type

dicom-media-type

M

M

The media-type of the 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.8.1.4 Request Payload

The request payload, if present, may describe the reason for requesting the cancellation of the Workitem, a Contact Display Name, and/or a Contact URI for the person with whom the cancel request may be discussed.

The Request UPS Cancel Action Information is specified in Table CC.2.2-1 “Request UPS Cancel - Action Information” in PS3.4.

DICOM PS3.18 2021e - Web Services