DICOM PS3.18 2019d - Web Services

10.5 Store Transaction

This transaction uses the POST method to Store representations of Studies, Series, and Instances contained in the request payload.

The Store transaction supports only DICOM resources. The resource can be supplied as a single Instance, or as separate Metadata and Bulkdata.

10.5.1 Request

The request shall have the following syntax:

POST SP "/" {/resource} SP version CRLF
Accept: 1#media-type CRLF
Content-Type: dicom-media-type CRLF
(Content-Length: uint / Content-Encoding: encoding) CRLF
*(header-field CRLF)
CRLF
payload

10.5.1.1 Target Resources

10.5.1.1.1 DICOM Resources

Table 10.5.1-1 defines the resources used to store Instances.

Table 10.5.1-1. Store Transaction DICOM Resources

Resource

URI Template

Description

Studies

/studies

Stores a set of representations that may have different Study Instance UIDs.

Study

/studies/{study}

Stores a set of representations that belong to the same Study, i.e., each representation shall have the same Study Instance UID.


10.5.1.2 Query Parameters

The Store transaction has no Query Parameters.

10.5.1.3 Request Header Fields

The origin server shall support Header Fields as required in Table 10.5.1-2.

The user agent shall supply in the request Header Fields as required in Table 10.5.1-2.

Table 10.5.1-2. Request Header Fields

Name

Values

Usage

Description

User Agent

Origin Server

Content-Type

media-type

M

M

The DICOM Media Type of the request payload

Shall be present if the request has a 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.

10.5.1.4 Request Payload

The request payload shall be present and shall contain one or more representations specified by the Content-Type header field.

The payload may contain Instances from more than one Study if the Study Instance UID is not specified in the Target URI.

The request payload shall consist of either:

  • PS3.10 SOP Instances, or

  • Metadata accompanied by Bulkdata.

PS3.10 binary instances shall be encoded with one message part per DICOM Instance.

Metadata and Bulkdata requests will be encoded in the following manner (see Figure 8.6-1 Mapping between IOD and HTTP message parts):

  • All XML request messages shall be encoded as described in the Native DICOM Model defined in PS3.19 with one message part per XML object; the Attributes of the Image Pixel Description Macro may be omitted for the media types specified in Table 10.5.2-1.

  • All JSON request messages shall be encoded as an array of DICOM JSON Model Objects defined in Annex F in a single message part; the Attributes of the Image Pixel Description Macro may be omitted for the media types specified in Table 10.5.2-1.

  • Bulkdata (with the exception of Encapsulated Document (0042,0011) element) and uncompressed pixel data shall be encoded in a Little-Endian format using the application/octet-stream media type with one message part per Bulkdata item.

  • Compressed pixel data shall be encoded in one of two ways:

    • single-frame pixel data encoded using a single-frame media type (one message part);

    • multi-frame or video pixel data encoded using a multi-frame media type (multiple frames in one message part).

Uncompressed Bulkdata shall be encoded as application/octet-stream.

An Encapsulated Document (0042,0011) Bulkdata element shall be encoded using the media-type from the MIME Type of the Encapsulated Document (0042,0012) Attribute with one message part per document.

DICOM PS3.18 2019d - Web Services