DICOM PS3.18 2020e - Web Services

11.8 Request Cancellation (Current)
Prev | 11 Worklist Service and Resources | Next

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

Prev | Up | Next
11.7.3.3 Response Payload | Home | 11.8.2 Behavior

DICOM PS3.18 2020e - Web Services