DICOM PS3.2 2023d - Conformance

N.5.3 DICOM Web Services

N.5.3.1 URI Web Service (WADO URI)

This section provides details regarding the URI Web Service. For an overview of the supported transactions see Table N.1-8 URI Service.

N.5.3.1.1 Supported Web Media Types
N.5.3.1.1.1 DICOM Media Types

The supported DICOM Storage SOP Classes / Transfer Syntaxes are listed in Section N.1.1 of this document.

[Provide requirements for display and processing of instances received via Web Services. This could either be done by referencing Section N.5.2.5.2 if the same requirements apply, or by copying the tables from Section N.5.2.5.2 and filling them appropriately, if the requirements for Web Services differ.]

N.5.3.1.1.2 Rendered Media Types

Table N.5-61 lists the supported rendered Media types depending on the Media Type category.

[Indicate which category / Media types are supported by your system by marking the cells with Y or N. Remove rows for Media Types neither supported as user agent nor as Origin Server].

Table N.5-61. Supported Rendered Media Types

Category

Media Type

URI User Agent

URI Origin Server

Single Frame Image

image/jpeg

image/gif

image/png

image/jp2

Multi-Frame Image

image/gif

Video

video/mpeg

video/mp4

video/H265

Text

text/html

text/plain

text/xml

text/rtf

application/pdf


N.5.3.1.2 Retrieve DICOM Instance Transaction - URI Web Service

[Provide requirements for display and processing of instances retrieved via URI Web Service. This could either be done by referencing Section N.5.2.5.2 (as indicated below), if the same requirements apply, or by copying the tables from Section N.5.2.5.2 and filling them appropriately if requirements for retrieved instances differ.]

In order to display or process DICOM instances retrieved via URI Web Service, see Section N.5.2.5.2.

N.5.3.1.2.1 User Agent

The URI Web Service user agent supports the Query Parameters listed in Table N.5-62.

[List the supported parameters and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-62. Query Parameters for Retrieve DICOM Instance URI Web Service - User Agent

Query Parameter

Supported Values

Comments

requestType

WADO

studyUID

<Study Instance UID>

seriesUID

<Series Instance UID>

objectUID

<SOP Instance UID>

contentType

application/dicom

[Must be compatible with the acceptable Media Types in the HTTP Header]

See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "UA" column

charset

<<UTF-8

ISO-8859-1

…>>

anonymize

yes

transferSyntax


The URI Web Service User Agent supports the Header Fields listed in Table N.5-63:

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-63. Header Fields for Retrieve DICOM Instance URI Web Service - User Agent

Header Field

Supported Values

Comments

Accept

application/dicom

See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "UA" column

Accept-charset

<<UTF-8

ISO-8859-1

…>>


N.5.3.1.2.2 Origin Server

The URI Web Service origin server receives GET requests for studies, series and instances containing query parameters and headers fields. Supported Values are listed in the query parameters and header fields tables (Table N.5-64 and Table N.5-65).

The URI is composed by a Base URI: see Section N.6.3.1 for the Base URI of the Origin Server.

The URI Web Service origin server supports the Query Parameters listed in Table N.5-64.

[List the supported parameters and their Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-64. Query Parameters for Retrieve DICOM Instance URI Web Service - Origin Server

Query Parameter

Supported Values

Comments

requestType

WADO

studyUID

<Study Instance UID>

seriesUID

<Series Instance UID>

objectUID

<SOP Instance ID>

contentType

application/dicom

See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "OS" column

charset

<<UTF-8

ISO-8859-1

…>>

anonymize

transferSyntax


The URI Web Service origin server supports the Header Fields listed in Table N.5-65.

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-65. Header Fields for Retrieve DICOM Instance URI Web Service - Origin Server

Header Field

Supported Values

Comments

Accept

application/dicom

See in the Overview section Table N.1-1 the supported DICOM SOP Classes / Transfer Syntaxes. Look for "Y" in the "OS" column

Accept-charset

<<UTF-8

ISO-8859-1

…>>


N.5.3.1.3 Retrieve Rendered Instance Transaction - URI Web Service

[Provide requirements for display and processing of instances retrieved via URI Web Service. This could either be done by referencing section 5.2.5.2 (as indicated below), if the same requirements apply, or by copying the tables from Section 5.2.5.2 and filling them appropriately if requirements for retrieved instances differ.]

To display or process DICOM instances retrieved via URI Web Service, see Section N.5.2.5.2.

N.5.3.1.3.1 User Agent

The URI Web Service user agent supports the Query Parameters listed in Table N.5-66.

[List the supported parameters and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-66. Query Parameters for Retrieve Rendered Instance URI Web Service - User Agent

Query Parameter

Supported Values

Comments

requestType

WADO

studyUID

<Study Instance UID>

seriesUID

<Series Instance UID>

objectUID

<SOP Instance UID>

contentType

<<image/jpeg

image/gif

image/png

image/jp2

video/mpeg

video/mp4

video/H265

text/html

text/plain>>

See Section N.5.3.1.1.2 for details

charset

<<UTF-8

ISO-8859-1

…>>

annotation

rows

columns

region

windowCenter

windowWidth

frameNumber

imageQuality

[The Value must be between 1 and 100.

1 means low quality and 100 imeans high quality]

presentationUID and

presentationSeriesUID

[if presentationUID specified then presentationSeriesUID must be present.]


The URI Web Service user agent supports Header Fields listed in Table N.5-67.

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-67. Header Fields for Retrieve Rendered Instance URI Web Service - User Agent

Header Field

Supported Values

Comments

Accept

<<image/jpeg

image/gif

image/png

image/jp2

video/mpeg

video/mp4

video/H265

text/html

text/plain>>

See Section N.5.3.1.1.2 for details

Accept-charset

<<UTF-8

ISO-8859-1

…>>


N.5.3.1.3.2 Origin Server

The URI Web Service origin server receives GET requests for studies, series and instances containing query parameters and headers fields. Supported Values are listed in the query parameters and header fields tables (Table N.5-68 and Table N.5-69).

The URI is composed by a Base URI: see Section N.6.3.1 for the Base URI of the origin server.

The URI Web Service origin server supports Query Parameters listed in Table N.5-68.

[List the supported parameters and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-68. Query Parameters for Retrieve Rendered Instance URI Web Service - Origin Server

Query Parameter

Supported Values

Comments

requestType

WADO

studyUID

<Study Instance UID>

seriesUID

<Series Instance UID>

objectUID

<SOP Instance ID>

contentType

<<image/jpeg

image/gif

imag/png

image/jp2

video/mpeg

video/mp4

video/H265

text/html

text/plain >>

See details in Section N.5.3.1.1.2

charset

<<UTF-8

ISO-8859-1

…>>

annotation

<<patient

technique>>

Add additionally supported key word Values here

rows

columns

region

windowCenter

windowWidth

frameNumber

imageQuality

[The Value must be between 1 and 100.

1 means low quality and 100 imeans high quality.]

presentationUID and

presentationSeriesUID

[if presentationUID specified then presentationSeriesUID must be present.]


The URI Web Service origin server supports Header Fields listed in Table N.5-69.

[List the supported Header Fields and their supported Values. Fill in information on your implementation in the "Comments" column when necessary.]

Table N.5-69. Header Fields for Retrieve Rendered Instance URI Web Service - Origin Server

Header Field

Supported Values

Comments

Accept

<<Image/jpeg

image/gif

image/png

image/jp2

video/mpeg

video/mp4

video/H265

text/html

text/plain>>

See details in Section N.5.3.1.1.2 Rendered Media Types


DICOM PS3.2 2023d - Conformance