DICOM PS3.18 2021e - Web Services

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.

DICOM PS3.18 2021e - Web Services