11.4 Create Workitem Transaction

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

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 / Transfer-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
Name	Values	User Agent	Origin Server	Description
Content-Type	dicom-media-type	M	M	The media-type of the 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.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