Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # DICOM-Daten durchsuchen in HealthImaging AWS HealthImaging bietet Darstellungen von [ QIDO-RSDICOMWeb-APIs](https://www.dicomstandard.org/using/dicomweb/query-qido-rs), um anhand der Patienten-ID nach Studien, Serien und Instanzen zu suchen und deren eindeutige Identifikatoren für die weitere Verwendung zu erhalten. HealthImagingDie QIDO-RS DICOMWeb-APIs bieten Flexibilität bei der Suche nach in älteren Anwendungen gespeicherten Daten HealthImaging und sorgen für Interoperabilität mit älteren Anwendungen. **Wichtig** HealthImagingDie DICOMWeb-APIs können verwendet werden, um Bilddatensatzinformationen mit zurückzugeben. QIDO-RS HealthImaging DICOMWeb-APIs verweisen nur auf primäre [Bilddatensätze](getting-started-concepts.md#concept-image-set), sofern nicht anders angegeben. Verwenden Sie HealthImaging [Cloud-native Aktionen oder den optionalen Imageset-Parameter von DICOMWeb-Aktionen,](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) um Bilddatensätze abzurufen, die nicht primär sind. HealthImagingDie DICOMWeb-APIs können verwendet werden, um Bilddatensatzinformationen mit Antworten zurückzugeben. DICOMweb-conformant HealthImaging QIDO-RS DICOMWeb-Aktionen können maximal 10.000 Datensätze zurückgeben. [Falls mehr als 10.000 Ressourcen vorhanden sind, können sie nicht über die Aktionen abgerufen werden, sondern können über QIDO-RS WADO-RS DICOMWeb-Aktionen oder Cloud-native Aktionen abgerufen werden.](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) Die in diesem Abschnitt aufgeführten APIs entsprechen dem DICOMWeb () QIDO-RS -Standard für webbasierte medizinische Bildgebung. Sie werden nicht über SDKs AWS CLI angeboten. AWS ## DICOMWeb-Such-APIs für HealthImaging In der folgenden Tabelle werden alle HealthImaging Darstellungen der QIDO-RS DICOMWeb-APIs beschrieben, in denen Daten gesucht werden können. HealthImaging **HealthImaging Repräsentationen von DICOMWeb-APIs QIDO-RS** | Name | Description | | --- | --- | | SearchDICOMStudies | Suchen Sie nach DICOM-Studien, HealthImaging indem Sie Suchabfrageelemente mithilfe einer GET-Anfrage angeben. Die Ergebnisse der Studiensuche werden im JSON-Format zurückgegeben, sortiert nach letzter Aktualisierung und absteigendem Datum (vom letzten zum ältesten). Siehe [Suchen Sie nach Studien](dicomweb-search-studies.md). | | SearchDICOMSeries | Suchen Sie nach DICOM-Serien in, HealthImaging indem Sie Suchabfrageelemente mithilfe einer GET-Anfrage angeben. Die Suchergebnisse für Serien werden im JSON-Format zurückgegeben, sortiert nach Series Number (0020, 0011) aufsteigender Reihenfolge (vom ältesten zum neuesten). Siehe [Suchen Sie nach Serien](dicomweb-search-series.md). | | SearchDICOMInstances | Suchen Sie nach DICOM-Instanzen, HealthImaging indem Sie Suchabfrageelemente mithilfe einer GET-Anforderung angeben. Die Ergebnisse der Instanzsuche werden im JSON-Format zurückgegeben, sortiert nach Instance Number (0020, 0013) aufsteigender Reihenfolge (vom ältesten zum neuesten). Siehe [Suchen Sie nach Instanzen](dicomweb-search-instances.md). | ## Unterstützte DICOMWeb-Abfragetypen für HealthImaging HealthImaging unterstützt QIDO-RS hierarchische Ressourcenabfragen auf den Ebenen Study, Series und SOP Instance. Bei Verwendung der QIDO-RS hierarchischen Suche nach: HealthImaging + Bei der Suche nach Studien wird eine Liste von Studien zurückgegeben + Die Suche nach einer Reihe einer Studie erfordert eine bekannte Datenreihe `StudyInstanceUID` und gibt eine Liste von Reihen zurück + Für die Suche in einer Liste von Instanzen ist ein bekanntes `StudyInstanceUID` und `SeriesInstanceUID` In der folgenden Tabelle werden unterstützte QIDO-RS hierarchische Abfragetypen für die Suche nach Daten beschrieben HealthImaging. **HealthImaging unterstützte QIDO-RS Abfragetypen** | Abfragetyp | Beispiel | | --- | --- | | Abfragen von Attributwerten | Suchen Sie in einer Studie nach allen Serien, wo`modality=CT`.
`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`
Durchsucht alle Studien, bei denen die Patienten-ID und das Studiendatum diesen Werten entsprechen.
`…/studies?PatientID=11235813&StudyDate=20130509` | | Abfragen nach Schlüsselwörtern | Durchsuchen Sie alle Serien mit dem `SeriesInstanceUID` Schlüsselwort.
`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894868` | | Tag-Abfragen | Suchen Sie mithilfe von im group/element Formular übergebenen Abfrageparametern nach Tags.
{Gruppe} {Element} wie 0020000D | | Bereichsabfragen | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | | Pagieren von Ergebnissen mit und limit offset | `.../studies?limit=1&offset=0&00080020=20000101`
Sie können die Parameter Limit und Offset verwenden, um Suchantworten zu paginieren. Der Standardwert für Limit ist 1000. Den Maximalwert [HealthImaging AWS-Endpunkte und Kontingente](endpoints-quotas.md) finden Sie unter.
Maximaler Grenzwert = 1000, maximaler Offset = 9000 | | Abfragen mit Platzhaltern | Platzhalterabfragen bieten mehr Flexibilität bei der Suche mit „\*“ und „?“. „\*“ entspricht einer beliebigen Zeichenfolge (einschließlich eines Längenwerts von Null) und „?“ entspricht einem beliebigen einzelnen Zeichen.
Sucht nach allen Studien in einem Datenspeicher, der „Nuclear“ StudyDescription enthält:
`.../studies?StudyDescription=*Nuclear*`
Suche nach allen Studien, die mit „Nuclear“ StudyDescription enden:
`.../studies?StudyDescription=*Nuclear`
Suche nach allen Studien, die mit „Nuclear“ StudyDescription beginnen:
`.../studies?StudyDescription=Nuclear*`
Suchen Sie nach allen Studien, in denen PatientID genau 3 beliebige Zeichen nach 200965981 enthält:
`.../studies?PatientID=200965981???` | | FuzzyMatching Abfragen | Aktivieren Sie den Fuzzy-Matching für Namens-DICOM-Attribute ((0010,0010), PatientName ReferringPhysicianName (0008,0090)), indem Sie den optionalen Abfrageparameter Fuzzymatching hinzufügen:
`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`
Bei dieser Abfrage wird für jeden Teil des Werts ein Präfixabgleich ohne Berücksichtigung der Groß- und Kleinschreibung durchgeführt. PatientName Sie gibt Ergebnisse mit PatientName Werten wie „Thomas“, „Albert“, „Thomas Albert“, „Thomas^Albert“ zurück, aber nicht mit „hom“ oder „ber“. | | IncludeField Abfragen | Verwenden Sie den `includefield` Abfrageparameter, um zusätzliche DICOM-Attribute anzufordern, die über den Standardantwortsatz hinausgehen.
Gibt bestimmte Attribute nach Tag zurück:
`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`
Gibt alle verfügbaren Attribute zurück:
`.../studies?PatientID=11235813&includefield=all`
Gibt die Unterattribute der Sequenz (SQ) in gepunkteter Notation zurück:
`.../studies?PatientID=11235813&includefield=00080096.00080100`
Private Datenelemente zurückgeben:
`.../instances?includefield=00191001&00190010=Philips` | ## Verwendung IncludeField in QIDO-RS Abfragen Mit dem `includefield` Abfrageparameter können Sie zusätzliche DICOM-Attribute anfordern, die über die Standardantwortmenge in HealthImaging QIDO-RS Abfragen hinausgehen. Sie können ihn `includefield` auf Studien-, Serien- und Instanzebene verwenden. ### Syntax Verwenden Sie das folgende GET-Anforderungsformat, um zusätzliche Felder in Ihre QIDO-RS Abfragen aufzunehmen: ``` GET .../studies?&includefield= GET .../studies//series?&includefield= GET .../studies//series//instances?&includefield= ``` Sie können mehrere `includefield` Parameter in einer einzigen Anfrage angeben: ``` GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010 ``` ### Unterstützte Werte für includefield In der folgenden Tabelle werden die unterstützten Werte für den `includefield` Parameter beschrieben. **Unterstützte Include-Feldwerte** | Werttyp | Description | Beispiel | | --- | --- | --- | | DICOM-Tag (8 Hex-Zeichen) | Fordert ein bestimmtes DICOM-Attribut anhand seines Tags im GGGGEEEE-Format an. | includefield=00081030 | | all | Fordert alle verfügbaren DICOM-Attribute für die Ressourcenebene an. | includefield=all | | Punktierter SQ-Pfad | Fordert ein bestimmtes Unterattribut innerhalb eines Sequence (SQ) -Attributs mithilfe der Punktnotation an:. . | includefield=00080096.00080100 | | Tag für private Datenelemente | Fordern Sie ein privates Tag an (Element mit einer ungeraden Gruppe). Erfordert den ParameterprivateCreatorElement. | includefield=00191001 | | Standard-DICOM-Attribute, einschließlich Bulkdata | Fordern Sie bestimmte einzelne oder mehrere Attribute nach Tag oder Schlüsselwort an. | includefield=00102201 | ### Verhalten und Regeln Die folgenden Regeln gelten für `includefield` Abfragen: + **Standardantwort** — Ohne `includefield` Angabe gibt die QIDO-RS Antwort nur die Standardattribute zurück. + **includefield=all — Gibt alle** verfügbaren Attribute auf der angeforderten Ebene zurück. Wenn mit anderen `includefield` Werten kombiniert `all` wird, hat Vorrang. `all` + **Maximale Anzahl von Tags** — Eine Anfrage kann bis zu 50 `includefield` Parameter enthalten. + **Doppelte Tags** — Doppelte `includefield` Werte werden dedupliziert und als eine einzige Anfrage behandelt. + **Ungültige oder fehlende Tags** — Wenn ein angefordertes Tag in den DICOM-Daten nicht vorhanden oder ungültig ist, wird es stillschweigend in der Antwort weggelassen. Andere gültige `includefield` Attribute werden weiterhin zurückgegeben. ### Sequenzattribute (SQ) Verwenden Sie die Punktnotation, um verschachtelte Attribute innerhalb eines Sequence-Attributs (SQ) anzufordern: ``` includefield=. ``` Um beispielsweise CodeValue (0008.0100) innerhalb ReferringPhysicianIdentificationSequence von (0008.0096) abzurufen: ``` GET .../studies?PatientID=11235813&includefield=00080096.00080100 ``` Multi-level Verschachtelung wird unterstützt. Beispiel: ``` includefield=00081115.00081199.00081150 ``` ### Private Stichwörter Private DICOM-Datenelemente (ODD-Group-Tags) werden auf allen Ressourcenebenen unterstützt. Um private Tags anzufordern, geben Sie den Abfrageparameter an`privateCreatorElement`. Verwenden Sie die folgende Syntax: ``` GET .../instances?includefield=&= ``` Beispiel: ``` GET .../instances?includefield=00191001&00190010=Philips ``` Die folgenden Regeln gelten für private Tags: + Das `privateCreatorElement` Tag und der Name des Erstellers müssen als Vergleichsparameter angegeben werden, wenn das private Tag angefordert wird. + Wenn das angegebene Tag nicht gefunden `privateCreatorElement` wird, wird das private Tag stillschweigend weggelassen. + Wenn nur ein `privateCreatorElement` Tag ohne ein privates Datenelement angefordert wird, werden nur der Name und der Wert des Erstellerelements zurückgegeben. Es werden nicht alle Tags zurückgegeben, die zum Block dieses Erstellers gehören. ### Massendaten-Tags DICOM-Attribute mit Bulkdata-VRs (OB, OD, OF, OL, UN, OW, OV), deren Binärwert größer als 1 MB ist, als Teil von angefordert wurden, `includefield` werden `bulkdataURI` anstelle des rohen Binärwerts als zurückgegeben. [Weitere Informationen zum Abrufen von Massendaten finden Sie unter DICOM-Massendaten abrufen in. HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html) ### Was gibt includefield=all auf jeder Ebene zurück? Wenn `includefield=all` angegeben, umfasst die Antwort alle Attribute auf der jeweiligen Ressourcenebene. #### Studienebene (includefield=all) In der folgenden Tabelle sind alle Attribute aufgeführt, die auf der Studienebene zurückgegeben wurden, sofern diese angegeben wurde. `includefield=all` **Attribute auf Studienebene für includefield=all** | Markierung | Name | VR | | --- | --- | --- | | 00080005 | SpecificCharacterSet | CS | | 00080020 | StudyDate | TAG | | 00080030 | StudyTime | TM | | 00080050 | AccessionNumber | SH | | 00080051 | IssuerOfAccessionNumberSequence | Q | | 00080056 | InstanceAvailability | CS | | 00080061 | ModalitiesInStudy | CS | | 00080062 | SOPClassesInStudy | Benutzeroberfläche | | 00080090 | ReferringPhysicianName | PN | | 0008009C | ConsultingPhysicianName | PN | | 00080201 | TimezoneOffsetFromUTC | SH | | 00081030 | StudyDescription | VIEL | | 00081048 | PhysiciansOfRecord | PN | | 00081060 | NameOfPhysiciansReadingStudy | PN | | 00081080 | AdmittingDiagnosesDescription | VIEL | | 00081190 | URL abrufen | UR | | 00100010 | PatientName | PN | | 00100020 | ID des Patienten | LO | | 00100021 | IssuerOfPatientID | NIEDRIG | | 00100022 | TypeOfPatientID | CS | | 00100026 | SourcePatientGroupIdentificationSequence | Q | | 00100027 | GroupOfPatientsIdentificationSequence | Q | | 00100028 | SubjectRelativePositionInImage | US | | 00100030 | PatientBirthDate | TAG | | 00100032 | PatientBirthTime | TM | | 00100033 | PatientBirthDateInAlternativeCalendar | NIEDRIG | | 00100034 | PatientDeathDateInAlternativeCalendar | NIEDRIG | | 00100035 | PatientAlternativeCalendar | CS | | 00100040 | PatientSex | CS | | 00100050 | PatientInsurancePlanCodeSequence | Q | | 00100101 | PatientPrimaryLanguageCodeSequence | Q | | 00100102 | PatientPrimaryLanguageModifierCodeSequence | Q | | 00100200 | QualityControlSubject | CS | | 00100201 | QualityControlSubjectTypeCodeSequence | Q | | 00100213 | StrainNomenclature | VIEL | | 00100214 | StrainStockNumber | VIEL | | 00100215 | StrainSourceRegistryCodeSequence | Q | | 00100217 | StrainSource | VIEL | | 00100219 | StrainCodeSequence | Q | | 00100223 | GeneticModificationsNomenclature | NIEDRIG | | 00100229 | GeneticModificationsCodeSequence | Q | | 00101001 | OtherPatientNames | PN | | 00101005 | PatientBirthName | PN | | 00101010 | PatientAge | AS | | 00101020 | PatientSize | DS | | 00101021 | PatientSizeCodeSequence | Q | | 00101022 | PatientBodyMassIndex | DS | | 00101023 | Gemessene AP-Abmessung | DS | | 00101024 | MeasuredLateralDimension | DS | | 00101030 | PatientWeight | DS | | 00101040 | PatientAddress | VIEL | | 00101060 | PatientMotherBirthName | PN | | 00101080 | MilitaryRank | VIEL | | 00101081 | BranchOfService | VIEL | | 00102000 | MedicalAlerts | VIEL | | 00102110 | Allergien | LO | | 00102150 | CountryOfResidence | VIEL | | 00102152 | RegionOfResidence | VIEL | | 00102154 | PatientTelephoneNumbers | SH | | 00102160 | EthnicGroup | SH | | 00102180 | Beruf | SH | | 001021A0 | SmokingStatus | CS | | 001021C0 | PregnancyStatus | US | | 001021D0 | LastMenstrualDate | TAG | | 001021F0 | PatientReligiousPreference | VIEL | | 00102201 | PatientSpeciesDescription | VIEL | | 00102202 | PatientSpeciesCodeSequence | Q | | 00102203 | PatientSexNeutered | CS | | 00102210 | AnatomicalOrientationType | CS | | 00102292 | PatientBreedDescription | VIEL | | 00102293 | PatientBreedCodeSequence | Q | | 00102295 | BreedRegistrationNumber | VIEL | | 00102296 | BreedRegistryCodeSequence | Q | | 00102297 | ResponsiblePerson | PN | | 00102298 | ResponsiblePersonRole | CS | | 00102299 | ResponsibleOrganization | NIEDRIG | | 00109431 | ExaminedBodyThickness | FL | | 0020000D | StudyInstanceUID | Benutzeroberfläche | | 00200010 | Studien-ID | SH | | 00201206 | NumberOfStudyRelatedSeries | IS | | 00201208 | NumberOfStudyRelatedInstances | IS | | 00321032 | RequestingPhysician | PN | | 00321033 | RequestingService | NIEDRIG | | 00321060 | RequestedProcedureDescription | VIEL | | 00321070 | RequestedContrastAgent | VIEL | | 00380010 | Zulassungsnummer | LO | | 00380016 | RouteOfAdmissions | VIEL | | 00380020 | AdmittingDate | TAG | | 00380021 | AdmittingTime | TM | | 00380050 | SpecialNeeds | NIEDRIG | | 00380060 | ServiceEpisodeID | LO | | 00380062 | ServiceEpisodeDescription | VIEL | | 00380300 | CurrentPatientLocation | NIEDRIG | | 00380400 | PatientInstitutionResidence | NIEDRIG | | 00380500 | PatientState | LO | | 00400244 | PerformedProcedureStepStartDate | TAG | | 00400245 | PerformedProcedureStepStartTime | TM | | 00400250 | PerformedProcedureStepEndDate | TAG | | 00400251 | PerformedProcedureStepEndTime | TM | | 00400253 | PerformedProcedureStepID | SH | | 00081032 | ProcedureCodeSequence | Q | | 00100024 | IssuerOfPatientIDQualifiersSequence | Q | | 00321034 | RequestingServiceCodeSequence | Q | | 00321064 | RequestedProcedureCodeSequence | Q | | 00401012 | ReasonForPerformedProcedureCodeSequence | Q | #### Serienebene (includefield=all) In der folgenden Tabelle sind die Attribute auf Serienebene aufgeführt, die zurückgegeben werden, wenn sie angegeben ist. `includefield=all` Die Datenreihenebene gibt auch alle in der vorherigen Tabelle aufgeführten Attribute auf Studienebene zurück. **Attribute auf Reihenebene für includefield=all** | Markierung | Name | VR | | --- | --- | --- | | 00080021 | SeriesDate | DA | | 00080031 | SeriesTime | TM | | 00080060 | Modalität | CS | | 00080064 | ConversionType | CS | | 00080068 | PresentationIntentType | CS | | 00080070 | Hersteller | LO | | 00080080 | InstitutionName | LO | | 00080082 | InstitutionCodeSequence | Q | | 00081010 | StationName | SH | | 0008103E | SeriesDescription | VIEL | | 0008103F | SeriesDescriptionCodeSequence | Q | | 00081040 | InstitutionalDepartmentName | NIEDRIG | | 00081041 | InstitutionalDepartmentTypeCodeSequence | Q | | 00081050 | PerformingPhysicianName | PN | | 00081070 | OperatorsName | PN | | 00081090 | ManufacturerModelName | NIEDRIG | | 00180010 | ContrastBolusAgent | VIEL | | 00180015 | BodyPartExamined | CS | | 00180050 | SliceThickness | DS | | 00180088 | SpacingBetweenSlices | DS | | 00181000 | DeviceSerialNumber | NIEDRIG | | 00181016 | SecondaryCaptureDeviceManufacturer | VIEL | | 00181018 | SecondaryCaptureDeviceManufacturerModelName | VIEL | | 00181019 | SecondaryCaptureDeviceSoftwareVersions | VIEL | | 00181020 | SoftwareVersions | VIEL | | 00181030 | ProtocolName | VIEL | | 00181050 | SpatialResolution | DS | | 00181200 | DateOfLastCalibration | TAG | | 00181201 | TimeOfLastCalibration | TM | | 00185100 | PatientPosition | CS | | 0020000D | StudyInstanceUID | Benutzeroberfläche | | 0020000E | SeriesInstanceUID | Benutzeroberfläche | | 00200011 | SeriesNumber | IS | | 00200052 | FrameOfReferenceUID | Benutzeroberfläche | | 00200060 | Lateralität | CS | | 00201209 | NumberOfSeriesRelatedInstances | IS | | 00540081 | NumberOfSlices | US | | 00540101 | NumberOfTimeSlices | US | | 00541000 | SeriesType | CS | #### Instanzebene (includefield=all) Gibt auf Instanzebene die vollständigen DICOM-Metadaten auf Instanzebene `includefield=all` zurück. Dies schließt alle Attribute ein, die in den Instanzmetadaten im Speicher gespeichert sind. HealthImaging Jedes DICOM-Tag, das in der ursprünglichen DICOM-Datei für diese Instanz vorhanden ist, wird zurückgegeben, mit Ausnahme des Pixeldatenattributs. **Topics** + [DICOMWeb-Such-APIs für HealthImaging](#dicomweb-search-services) + [Unterstützte DICOMWeb-Abfragetypen für HealthImaging](#dicomweb-query-types) + [Verwendung IncludeField in QIDO-RS Abfragen](#dicomweb-includefield) + [Auf der Suche nach DICOM-Studien in HealthImaging](dicomweb-search-studies.md) + [Auf der Suche nach der DICOM-Serie in HealthImaging](dicomweb-search-series.md) + [Suche nach DICOM-Instanzen in HealthImaging](dicomweb-search-instances.md)