QIDO-RS

• Resource

  • SearchForStudies

    • {+SERVICE}/studies{?query*,fuzzymatching,limit,offset}

  • SearchForSeries

    • {+SERVICE}/studies/{StudyInstanceUID}/series{?query*,fuzzymatching,limit,offset}

    • {+SERVICE}/series{?query*,fuzzymatching,limit,offset}

  • SearchForInstances

    • {+SERVICE}/studies/{StudyInstanceUID}/series/{SeriesInstanceUID}/instances{?query*,fuzzymatching,limit,offset}

    • {+SERVICE}/studies/{StudyInstanceUID}/instances{?query*,fuzzymatching,limit,offset}

    • {+SERVICE}/instances{?query*,fuzzymatching,limit,offset}

  where

  • {+SERVICE} is the base URL for the QIDO RESTful service. This may be a combination of protocol (http or https), authority, and path.

  • {StudyInstanceUID} is the unique Study Instance UID for a single study.

  • {SeriesInstanceUID} is the unique Series Instance UID for a single series.

• Method

  • GET

• Headers

  • Accept - The Media Type of the query results. The types allowed for this request header are:

    • PS3.19 XML (one part per result)

    • application/dicom+json (default)

      Annex F (the one and only part contains all results)

    A QIDO-RS provider shall support both Accept header values

  • Cache-control: no-cache (recommended)

    If included, specifies that search results returned should be current and not cached.

• {query}

  • {attributeID}={value}

    0-n / {attributeID}={value} pairs allowed

  • includefield={attributeID} | all

  Each {attributeID} must refer to one of:

  • Patient IE attributes

  • Study IE attributes

  • Series IE attributes (SearchForSeries or SearchForInstances requests only)

  • Composite Instance IE attributes (SearchForInstances requests only)

  • PS3.4 )

  • Timezone Offset From UTC (0008,0201)

  Section 6.7.1.1.1 for {attributeID} and {value} encoding rules

• fuzzymatching=true | false

• limit={limit}

  The “limit” parameter value is an unsigned integer, which specifies the maximum number of results the origin server shall return. If the “limit” parameter is not present the origin server shall return the maximum number of results in a single response that it supports.

• offset={offset}

  The “offset” parameter value is an unsigned integer, which specifies the number of results the origin server shall skip before the first returned result. If the “offset” query parameter is not present, its value is 0

..../dcm4chee-arc/aets/DCM4CHEE/rs/studies/count?returnempty=false&PatientName=t&fuzzymatching=true&compressionfailed=false

..../dcm4chee-arc/aets/DCM4CHEE/rs/studies?returnempty=false&PatientName=t&fuzzymatching=true&compressionfailed=false

..../dcm4chee-arc/aets/DCM4CHEE/rs/studies?includefield=all&offset=0&limit=21&orderby=-StudyDate,-StudyTime&returnempty=false&PatientName=t&fuzzymatching=true&compressionfailed=false