Page 316 |
DICOM PS3.2 2020a - Conformance |
K.3 Introduction
K.3.1 Revision History
Table K.3.1-1. Revision History
Document Version |
Date of Issue |
Author |
Description |
1.1 |
October 24, 2011 |
WG-27 |
Version for Final Text |
1.2 |
March 26, 2013 |
WG-27 |
Revised Introduction |
K.3.2 Audience, Remarks, Terms and Definitions, Basics of DICOM Communication, Abbrevi- ations, References
See example text in Section A.3.
K.3.3 Additional Remarks for This Example
ThisdocumentisasampleDICOMConformanceStatementcreatedforDICOMPS3.2.Itistobeusedsolelyasanexampletoillustrate howtocreateaDICOMConformanceStatementforaDICOMServiceClassProvider(SCP).Thesubjectofthedocument,EXAMPLE- QIDO-SERVICE, is a fictional product.
K.4 Networking
K.4.1 Implementation Model
K.4.1.1 Application Data Flow
DICOM HTTP Interface
Local |
QIDO-RS |
Remote |
|
Query |
|||
Service AE |
AE |
||
Request |
|||
|
|
Figure K.4.1-1. Application Data Flow Diagram
TheQIDO-RSProviderApplicationreceivesQIDOrequestsfromaremoteAE.TheserequestsareHTTPGETrequests.Itisassociated with the local real-world activity "Query Remote Device". It uses the request to select matching Studies, Series or Instances. It then returns a set of matching Studies, Series or Instances or a response code indicating warning or failure back to the requesting device.
K.4.1.2 Functional Definition of AEs
K.4.1.2.1 Functional Definition of QIDO Service Application
The reception of a QIDO-RS GET request will activate the QIDO-RS Provider. An internal query request is sent to the search capab- ilitiesoftheassociatedPACSorVendorNeutralArchive(VNA).ThesearchresultisbasedupontheURLoftheQIDO-RSGETrequest. The response is a status code indicating the success, warning, or failure of the search along with any matching results stored in the Remote PACS or VNA.
K.4.2 AE Specifications
This AE complies with Section 10.6 in PS3.18, specification for QIDO-RS.
- Standard -
DICOM PS3.2 2020a - Conformance |
Page 317 |
K.4.2.1 QIDO-RS Specifications
K.4.2.1.1 QIDO-RS Search for Studies
Table K.4.2-1. QIDO-RS Search for Studies Specification
Parameter |
Restrictions |
Media Types |
Restricted to "multipart/related; type=application/dicom+xml" or |
|
"application/dicom+json" |
Matching Attributes |
See Table K.4.2-1a |
Return Attributes |
See Table K.4.2-1a |
Limit and Offset supported |
Yes |
Person Name Matching |
Literal, case insensitive. Section Section K.4.2.2 “Extended Negotiation”. |
Table K.4.2-1a. QIDO-RS Study Attribute Matching
Keyword |
Tag |
Types of Matching |
STUDY Level |
|
|
StudyDate |
00080020 |
S,*,U,R |
StudyTime |
00080030 |
S,*,U,R |
AccessionNumber |
00080050 |
S,*,U |
ModalitiesInStudy |
00080061 |
S,*,U |
ReferringPhysiciansName |
00080090 |
S,*,U |
StudyDescription |
00081030 |
S,*,U |
PhysicianOfRecord |
00081048 |
U |
PatientsName |
00100010 |
S,*,U |
PatientID |
00100020 |
S,*,U |
PatientBirthDate |
00100030 |
NONE |
PatientSex |
00100040 |
NONE |
StudyInstanceUID |
0020000D |
UNIQUE |
StudyID |
00200010 |
S,*,U |
NumberOfStudyRelatedSeries |
00201206 |
NONE |
NumberOfStudyRelatedInstances |
00201208 |
NONE |
RetrieveURL |
00081190 |
NONE |
Common to all query levels |
|
|
InstanceAvailability |
00080056 |
S,*,U |
SpecificCharacterSet |
00080005 |
NONE |
RetrieveURL |
00081190 |
NONE |
Types of Matching (see Section C.2.2.2 “Attribute Matching” in PS3.4) :
"S" indicates the identifier attribute uses Single Value Matching
"L" indicates UID List Matching
"U" indicates Universal Matching.
- Standard -
Page 318 |
DICOM PS3.2 2020a - Conformance |
Note
If only Universal Matching is supported for an attribute then that attribute can only be passed as an "includefield" query key
"*" indicates wild card matching
"R" indicates Range Matching
"SEQUENCE" indicates Sequence Matching
"NONE" indicates that no matching is supported, but that values for this Element requested will be returned with all requests
"UNIQUE" indicates that this is the Unique Key for that query level, in which case Universal Matching or Single Value Matching is used depending on the query level (see Section C.2.2.1.1 “Unique Keys” in PS3.4).
K.4.2.1.2 QIDO-RS Search for Series
Table K.4.2-2. QIDO-RS Search for Series Specification
Parameter |
Restrictions |
Media Types |
Restricted to "multipart/related; type=application/dicom+xml" or |
|
"application/dicom+json" |
Matching Attributes |
See Table K.4.2-2a |
Return Attributes |
See Table K.4.2-2a |
Limit and Offset supported |
Yes |
Relational Queries Supported |
No |
Table K.4.2-2a. QIDO-RS Series Attribute Matching
Keyword |
Tag |
Types of Matching |
SERIES Level |
|
|
Modality |
00080060 |
S,*,U |
SeriesDescription |
0008103E |
NONE |
SeriesInstanceUID |
0020000E |
UNIQUE |
SeriesNumber |
00200011 |
S,*,U |
NumberOfSeriesRelatedInstances |
00201209 |
NONE |
PerformedProcedureStepStartDate |
00400244 |
S,*,U,R |
PerformedProcedureStepStartTime |
00400245 |
S,*,U,R |
RequestAttributeSequence |
00400275 |
SEQUENCE |
>ScheduledProcedureStepID |
00400009 |
S,*,U |
>RequestedProcedureID |
00401001 |
S,*,U |
Common to all query levels |
|
|
InstanceAvailability |
00080056 |
S,*,U |
SpecificCharacterSet |
00080005 |
NONE |
RetrieveURL |
00081190 |
NONE |
Types of matching: Section Section K.4.2.1.1 “QIDO-RS Search for Studies”.
- Standard -
DICOM PS3.2 2020a - Conformance |
Page 319 |
K.4.2.1.3 QIDO-RS Search for Instances
Table K.4.2-3. QIDO-RS Search for Instances Specification
Parameter |
Restrictions |
Media Types |
Restricted to "multipart/related; type=application/dicom+xml" or |
|
"application/dicom+json" |
Matching Attributes |
See Table K.4.2-3a |
Return Attributes |
See Table K.4.2-3a |
Limit and Offset supported |
Yes |
Relational Queries Supported |
Series-level, only |
Table K.4.2-3a. QIDO-RS Instance Attribute Matching
Keyword |
Tag |
Types of Matching |
SERIES Level |
|
|
Modality |
00080060 |
S,*,U |
SeriesDescription |
0008103E |
NONE |
SeriesInstanceUID |
0020000E |
UNIQUE |
SeriesNumber |
00200011 |
S,*,U |
NumberOfSeriesRelatedInstances |
00201209 |
NONE |
PerformedProcedureStepStartDate |
00400244 |
S,*,U,R |
PerformedProcedureStepStartTime |
00400245 |
S,*,U,R |
RequestAttributeSequence |
00400275 |
SEQUENCE |
>ScheduledProcedureStepID |
00400009 |
S,*,U |
>RequestedProcedureID |
00401001 |
S,*,U |
COMPOSITE INSTANCE Level |
|
|
SOPClassUID |
00080016 |
L |
SOPInstanceUID |
00080018 |
UNIQUE |
InstanceNumber |
00200013 |
S,*,U |
Rows |
00280010 |
NONE |
Columns |
00280011 |
NONE |
BitsAllocated |
00280100 |
NONE |
NumberOfFrames |
00280008 |
NONE |
Common to all query levels |
|
|
InstanceAvailability |
00080056 |
S,*,U |
SpecificCharacterSet |
00080005 |
NONE |
RetrieveURL |
00081190 |
NONE |
Types of matching: Section Section K.4.2.1.1 “QIDO-RS Search for Studies”.
K.4.2.1.4 Connection Policies
K.4.2.1.4.1 General
All standard RS connection policies apply. There are no extensions for RS options.
- Standard -
Page 320 |
DICOM PS3.2 2020a - Conformance |
K.4.2.1.4.2 Number of Connections
EXAMPLE-QIDO-SERVICE limits the number of simultaneous RS requests. Additional requests will be queued after the HTTP con- nection is accepted. When an earlier request completes, a pending request will proceed.
Table K.4.2-4. Number of HTTP Requests Supported
Maximum number of simultaneous RS requests |
100 (configurable) |
K.4.2.1.4.3 Asynchronous Nature |
|
EXAMPLE-QIDO-SERVICE does not support RS asynchronous response.
K.4.2.1.4.4 Response Status
TheEXAMPLE-QIDO-SERVICEshallprovidearesponsemessageheadercontainingtheappropriatestatuscodeindicatingsuccess, warning, or failure as shown in Table K.4.2-5.
Table K.4.2-5. HTTP Standard Response Codes
Code |
Name |
Description |
Success |
|
|
200 |
OK |
Thequerycompletedandanymatchingresultsarereturnedinthemessagebody. |
Failure |
|
|
400 |
Bad Request |
This indicates that the QIDO-RS Provider was unable to fulfill it because it cannot |
|
|
understand the query component. |
401 |
Unauthorized |
This indicates that the QIDO-RS Provider refused to fulfill it because the client is |
|
|
not authorized. |
403 |
Forbidden |
This indicates that the QIDO-RS Provider understood the request, but is refusing |
|
|
to fulfill it (e.g., no single patient specified, an authorized user with insufficient |
|
|
privileges, etc.). |
413 |
Request entity too large |
Thisindicatesthatthequerywastoobroadandanarrowerqueryorpagingshould |
|
|
be requested. This code will be returned for queries that do not specify PatientID. |
503 |
Busy |
Service is unavailable. |
K.4.2.2 Extended Negotiation
EXAMPLE-QIDO-SERVICE does not support the "fuzzymatching" query key.
EXAMPLE-QIDO-SERVICE will perform case insensitive matching for PN VR attributes but will not perform other forms of fuzzy matching. This applies to the following attributes:
•Referring Physician's Name (0008,0090)
•Physician(s) of Record (0008,1048)
•Patient's Name (0010,0010)
K.4.3 Network Interfaces
K.4.3.1 Physical Network Interface
EXAMPLE-QIDO-SERVICE uses the network interface from the hosting EXAMPLE-PACS-ARCHIVE. See its conformance claim for details.
- Standard -