DICOM PS3.18 2021b - Web Services

11.4 Create Workitem Transaction (Current)
Prev | 11 Worklist Service and Resources | Next

## 11.4 Create Workitem Transaction

This transaction creates a Workitem on the target Worklist. It corresponds to the UPS DIMSE N-CREATE operation.

### 11.4.1 Request

The request shall have the following syntax:

    POST SP /workitems ?{workitem} SP version CRLF

    Accept: dicom-media-type CRLF

    Content-Type: dicom-media-type CRLF

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

    *(header-field CRLF)

    CRLF

    Workitem

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

#### 11.4.1.1 Target Resources

The Target Resource is either the Worklist, or a Workitem.

Table 11.4.1-1. Create Transaction Resources

Resource | URI Template
--- | ---
Worklist | /workitems
Workitem | /workitems?{workitem}

If the Target Resource is the Worklist, then the Workitem dataset in the payload shall contain the Workitem UID

The value of the workitem Query Parameter is the Workitem UID, which corresponds to the Affected SOP Instance UID of the UPS DIMSE N-CREATE operation.

#### 11.4.1.2 Query Parameters

The origin server shall support Query Parameters as required in Section 11.1.2.

The user agent shall supply in the request Query Parameters as required in Section 11.1.2.

#### 11.4.1.3 Request Header Fields

The origin server shall support header fields in Table 11.4.1-3.

The user agent shall supply in the request header fields as defined in Table 11.4.1-3.

Table 11.4.1-3. 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.4.1.4 Request Payload

The payload shall have a single part, containing a Workitem encoded in the media type specified in the Content-Type header field. The payload shall contain all data elements to be stored. The Affected SOP Instance UID shall not be present in the Workitem dataset.

The Workitem in the payload shall comply with all Instance requirements in the Req. Type N-CREATE column of Table CC.2.5-3 “UPS SOP Class N-CREATE/N-SET/N-GET/C-FIND Attributes” in PS3.4.

Prev | Up | Next
11.3 Transactions Overview | Home | 11.4.2 Behavior

DICOM PS3.18 2021b - Web Services