DICOM PS3.18 2016a - Web Services

6.5.6 WADO-RS - RetrieveMetadata

This action retrieves the DICOM instances presented as the study, series, or instance metadata with the bulk data removed. The response is metadata for the DICOM attributes.

The study, series, or instance metadata includes all attributes; however, a RESTful Service is permitted to replace the Value Field of an attribute with a BulkDataURL for attributes with Value Representations (VR) of DS, FL, FD, IS, LT, OB, OD, OF, OW, SL, SS, ST, UL, UN, US, and UT. The client can use the BulkDataURL with the RetrieveBulkData action to retrieve the original Value Field of that attribute.

Note

  1. The server is not required to replace any attribute with a BulkDataURL; this is intended to allow the server to provide clients with metadata of a reasonably small size by leaving out large data Value Fields.

  2. Attributes with binary Value Fields are encoded as XML Base64 binary values.

  3. Some DICOM instances, such as SR documents, may be entirely described in the metadata.

6.5.6.1 Request

The specific Services resources to be used for the RetrieveMetadata action shall be as follows:

  • Resources

    • {SERVICE}/studies/{StudyInstanceUID}/metadata

    • {SERVICE}/studies/{StudyInstanceUID}/series/{SeriesInstanceUID}/metadata

    • {SERVICE}/studies/{StudyInstanceUID}/series/{SeriesInstanceUID}/instances/{SOPInstanceUID}/metadata

    where

    • {SERVICE} is the base URL for the service. This may be a combination of protocol (either http or https), host, port, and application.

    • {StudyInstanceUID} is the study instance UID for a single study.

    • {SeriesInstanceUID} is the series instance UID for a single series.

    • {SOPInstanceUID} is the SOP Instance UID for a single SOP Instance.

  • Method

    • GET

  • Headers

    • Accept

      • multipart/related; type=application/dicom+xml

        Specifies that the response should be PS3.19 XML. All WADO-RS providers must support this Media Type.

      • application/json

        Specifies that the results should be DICOM JSON (see Annex F). A WADO-RS provider may optionally support this Media Type

DICOM PS3.18 2016a - Web Services