Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Recherche de données DICOM dans HealthImaging
<a name="dicomweb-search"></a>

AWS HealthImaging propose des représentations des QIDO-RS API [DICOMWeb](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) permettant de rechercher des études, des séries et des instances par identifiant de patient, et de recevoir leurs identifiants uniques pour une utilisation ultérieure. HealthImagingles QIDO-RS API DICOMWeb offrent de la flexibilité dans la manière dont vous recherchez les données stockées HealthImaging et assurent l'interopérabilité avec les applications existantes.

**Important**  
HealthImagingles API DICOMWeb peuvent être utilisées pour renvoyer des informations sur les ensembles d'images avec. QIDO-RS HealthImaging Les API DICOMWeb font référence uniquement aux [ensembles d'images](getting-started-concepts.md#concept-image-set) principaux, sauf indication contraire. Utilisez [les actions natives du HealthImaging cloud](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) ou le paramètre optionnel d'ensemble d'images des actions DICOMWeb pour récupérer des ensembles d'images non principaux. HealthImagingles API DICOMWeb peuvent être utilisées pour renvoyer des informations sur un ensemble d'images avec DICOMweb-conformant des réponses.  
 HealthImaging Les QIDO-RS actions DICOMWeb peuvent renvoyer un maximum de 10 000 enregistrements. [Si plus de 10 000 ressources existent, elles ne seront pas récupérables via les QIDO-RS actions, mais peuvent être récupérées via des actions DICOMWeb ou des WADO-RS actions natives du cloud.](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)   
Les API répertoriées dans cette section sont conçues conformément à la norme DICOMWeb (QIDO-RS) pour l'imagerie médicale basée sur le Web. Ils ne sont pas proposés par le biais AWS CLI de AWS SDK.

## API de recherche DICOMWeb pour HealthImaging
<a name="dicomweb-search-services"></a>

Le tableau suivant décrit toutes les HealthImaging représentations des QIDO-RS API DICOMWeb disponibles pour la recherche de données. HealthImaging


**HealthImaging représentations des API DICOMWeb QIDO-RS**  

| Nom | Description | 
| --- | --- | 
| SearchDICOMStudies | Recherchez des études DICOM en HealthImaging spécifiant les éléments de requête de recherche à l'aide d'une requête GET. Les résultats de recherche des études sont renvoyés au format JSON, triés par dernière mise à jour, date décroissante (de la plus récente à la plus ancienne). Consultez [Rechercher des études](dicomweb-search-studies.md). | 
| SearchDICOMSeries | Recherchez les séries DICOM en HealthImaging spécifiant les éléments de requête de recherche à l'aide d'une requête GET. Les résultats de recherche de séries sont renvoyés au format JSON, Series Number (0020, 0011) triés par ordre croissant (du plus ancien au plus récent). Consultez [Rechercher une série](dicomweb-search-series.md). | 
| SearchDICOMInstances | Recherchez des instances DICOM en HealthImaging spécifiant les éléments de requête de recherche à l'aide d'une requête GET. Les résultats de recherche d'instance sont renvoyés au format JSON, Instance Number (0020, 0013) triés par ordre croissant (du plus ancien au plus récent). Consultez [Rechercher des instances](dicomweb-search-instances.md). | 

## Types de requêtes DICOMWeb pris en charge pour HealthImaging
<a name="dicomweb-query-types"></a>

HealthImaging prend en charge les requêtes de ressources QIDO-RS hiérarchiques aux niveaux de l'étude, de la série et de l'instance SOP. Lorsque vous utilisez la recherche QIDO-RS hiérarchique pour HealthImaging :
+ La recherche d'études renvoie une liste d'études
+ La recherche d'une série d'études nécessite une série connue `StudyInstanceUID` et renvoie une liste de séries
+ La recherche dans une liste d'instances nécessite `StudyInstanceUID` une `SeriesInstanceUID`

Le tableau suivant décrit les types de requêtes QIDO-RS hiérarchiques pris en charge pour la recherche de données dans HealthImaging.


**HealthImaging types de QIDO-RS requêtes pris en charge**  

| Type de requête | Exemple | 
| --- | --- | 
| Requêtes sur les valeurs d'attribut | Recherchez toutes les séries dans une étude où`modality=CT`.<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`<br />Effectuez une recherche dans toutes les études pour lesquelles l'identifiant du patient et la date de l'étude correspondent respectivement à ces valeurs.<br />`…/studies?PatientID=11235813&StudyDate=20130509` | 
| Requêtes par mots clés | Recherchez toutes les séries à l'aide du `SeriesInstanceUID` mot-clé.<br />`.../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` | 
| Requêtes de balises | Recherchez des balises à l'aide des paramètres de requête transmis dans le group/element formulaire.<br />{group} {element} comme 0020000D | 
| Requêtes de plage | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | 
| Pagination des résultats avec et limit offset | `.../studies?limit=1&offset=0&00080020=20000101`<br />Vous pouvez utiliser les paramètres de limite et de décalage pour paginer les réponses de recherche. La valeur par défaut de la limite est 1000, et [HealthImaging Points de terminaison et quotas AWS](endpoints-quotas.md) vérifiez la valeur maximale.<br />Limite maximale = 1000, décalage maximal = 9000 | 
| Requêtes avec caractères génériques | Les requêtes Wildcard offrent une plus grande flexibilité lors de la recherche en utilisant « \* » et « ? ». « \* » correspond à n'importe quelle séquence de caractères (y compris une valeur de longueur nulle) et « ? » correspond à n'importe quel caractère.<br />Rechercher toutes les études dans une banque de données StudyDescription contenant le terme « Nucléaire » :<br />`.../studies?StudyDescription=*Nuclear*`<br />Recherchez toutes les études dont le texte StudyDescription se termine par « Nucléaire » :<br />`.../studies?StudyDescription=*Nuclear`<br />Recherchez toutes les études dont le nom StudyDescription commence par « Nucléaire » :<br />`.../studies?StudyDescription=Nuclear*`<br />Recherchez toutes les études dans lesquelles PatientID comporte exactement 3 caractères après 200965981 :<br />`.../studies?PatientID=200965981???` | 
| FuzzyMatching requêtes | Activez la correspondance floue sur les attributs DICOM des noms ((0010,0010), PatientName ReferringPhysicianName (0008,0090)) en ajoutant le paramètre de requête optionnel fuzzymatching :<br />`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`<br />Cette requête effectue une correspondance de mots de préfixe sans distinction majuscules/minuscules sur n'importe quelle partie de la valeur. PatientName Il renvoie des résultats avec PatientName des valeurs telles que « thomas », « Albert », « Thomas Albert », « Thomas^Albert », mais pas « hom » ou « ber ». | 
| IncludeField requêtes | Utilisez le paramètre de `includefield` requête pour demander des attributs DICOM supplémentaires au-delà du jeu de réponses par défaut.<br />Renvoie des attributs spécifiques par tag :<br />`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`<br />Renvoie tous les attributs disponibles :<br />`.../studies?PatientID=11235813&includefield=all`<br />Renvoie les sous-attributs de séquence (SQ) à l'aide de la notation en pointillés :<br />`.../studies?PatientID=11235813&includefield=00080096.00080100`<br />Renvoyer des éléments de données privés :<br />`.../instances?includefield=00191001&00190010=Philips` | 

## Utilisation IncludeField dans les QIDO-RS requêtes
<a name="dicomweb-includefield"></a>

Le paramètre de `includefield` requête vous permet de demander des attributs DICOM supplémentaires au-delà de la réponse par défaut définie dans les HealthImaging QIDO-RS requêtes. Vous pouvez l'utiliser `includefield` au niveau de l'étude, de la série et de l'instance.

### Syntaxe
<a name="dicomweb-includefield-syntax"></a>

Utilisez le format de requête GET suivant pour inclure des champs supplémentaires dans vos QIDO-RS requêtes :

```
GET .../studies?<query_params>&includefield=<tag_or_keyword>
GET .../studies/<StudyInstanceUID>/series?<query_params>&includefield=<tag_or_keyword>
GET .../studies/<StudyInstanceUID>/series/<SeriesInstanceUID>/instances?<query_params>&includefield=<tag_or_keyword>
```

Vous pouvez spécifier plusieurs `includefield` paramètres dans une seule demande :

```
GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010
```

### Valeurs prises en charge pour includefield
<a name="dicomweb-includefield-values"></a>

Le tableau suivant décrit les valeurs prises en charge pour le `includefield` paramètre.


**Valeurs de champ incluses prises en charge**  

| Type de la valeur | Description | Exemple | 
| --- | --- | --- | 
| Tag DICOM (8 caractères hexadécimaux) | Demandez un attribut DICOM spécifique par son tag au format GGGGEEEE. | includefield=00081030 | 
| all | Demandez tous les attributs DICOM disponibles pour le niveau de ressource. | includefield=all | 
| Parcours SQ en pointillés | <parent\_tag>Demandez un sous-attribut spécifique dans un attribut de séquence (SQ) en utilisant la notation par points :. <child\_tag>. | includefield=00080096.00080100 | 
| Tag d'élément de données privé | Demandez un tag privé (élément odd-group). Nécessite le privateCreatorElement paramètre. | includefield=00191001 | 
| Attributs DICOM standard, y compris les données en masse | Demandez un ou plusieurs attributs spécifiques par tag ou mot-clé. | includefield=00102201 | 

### Comportement et règles
<a name="dicomweb-includefield-behavior"></a>

Les règles suivantes s'appliquent aux `includefield` requêtes :
+ **Réponse par défaut** — Sans réponse`includefield`, la QIDO-RS réponse renvoie uniquement l'ensemble standard d'attributs.
+ **includefield=all — Renvoie tous** les attributs disponibles au niveau demandé. Lorsqu'il `all` est combiné avec d'autres `includefield` valeurs, `all` prend la priorité.
+ **Nombre maximum de balises** : une demande peut inclure jusqu'à 50 `includefield` paramètres.
+ **Balises dupliquées** : `includefield` les valeurs dupliquées sont dédupliquées et traitées comme une seule demande.
+ **Balises non valides ou manquantes** — Si une balise demandée n'existe pas dans les données DICOM ou n'est pas valide, elle est omise silencieusement dans la réponse. Les autres `includefield` attributs valides sont toujours renvoyés.

### Attributs de séquence (SQ)
<a name="dicomweb-includefield-sq"></a>

Utilisez la notation par points pour demander des attributs imbriqués dans un attribut Sequence (SQ) :

```
includefield=<parent_SQ_tag>.<child_tag>
```

Par exemple, pour récupérer CodeValue (0008 0100) dans (0008 0096 ReferringPhysicianIdentificationSequence ) :

```
GET .../studies?PatientID=11235813&includefield=00080096.00080100
```

Multi-level l'imbrication est prise en charge. Par exemple :

```
includefield=00081115.00081199.00081150
```

### Tags privés
<a name="dicomweb-includefield-private"></a>

Les éléments de données DICOM privés (balises de groupe impair) sont pris en charge à tous les niveaux de ressources. Pour demander des balises privées, incluez le paramètre de `privateCreatorElement` requête.

Utilisez la syntaxe suivante :

```
GET .../instances?includefield=<private_tag>&<creator_tag>=<creator_name>
```

Par exemple :

```
GET .../instances?includefield=00191001&00190010=Philips
```

Les règles suivantes s'appliquent aux tags privés :
+ Le `privateCreatorElement` tag et le nom du créateur doivent être fournis en tant que paramètre de correspondance si le tag privé est demandé.
+ Si la valeur spécifiée n'`privateCreatorElement`est pas trouvée, la balise privée est omise silencieusement.
+ Le fait de demander uniquement une `privateCreatorElement` balise sans élément de données privé renvoie uniquement le nom et la valeur de l'élément créateur. Il ne renvoie pas toutes les balises appartenant au bloc de ce créateur.

### Balises de données en masse
<a name="dicomweb-includefield-bulkdata"></a>

Les attributs DICOM contenant des données en masse (OB, OD, OF, OL, UN, OW, OV) dont la valeur binaire est supérieure à 1 Mo demandés dans le cadre du `includefield` sont renvoyés à la `bulkdataURI` place de la valeur binaire brute. Pour plus d'informations sur la récupération de données groupées, voir Extraction de données groupées [DICOM](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html) dans. HealthImaging

### Que renvoie includefield=all à chaque niveau ?
<a name="dicomweb-includefield-all-levels"></a>

Lorsqu'elle `includefield=all` est spécifiée, la réponse inclut tous les attributs au niveau de ressource spécifique.

#### Niveau d'étude (includefield=all)
<a name="dicomweb-includefield-all-study"></a>

Le tableau suivant répertorie tous les attributs renvoyés au niveau de l'étude lorsqu'ils `includefield=all` sont spécifiés.


**Attributs au niveau de l'étude pour includefield=all**  

| Balise | Nom | VR | 
| --- | --- | --- | 
| 00080005 | SpecificCharacterSet | CS | 
| 00080020 | StudyDate | DA | 
| 00080030 | StudyTime | TM | 
| 00080050 | AccessionNumber | SH | 
| 00080051 | IssuerOfAccessionNumberSequence | SQ. | 
| 00080056 | InstanceAvailability | CS | 
| 00080061 | ModalitiesInStudy | CS | 
| 00080062 | SOPClassesInStudy | UI | 
| 00080090 | ReferringPhysicianName | PN | 
| 0008009C | ConsultingPhysicianName | PN | 
| 00080201 | TimezoneOffsetFromUTC | SH | 
| 00081030 | StudyDescription | LO | 
| 00081048 | PhysiciansOfRecord | PN | 
| 00081060 | NameOfPhysiciansReadingStudy | PN | 
| 00081080 | AdmittingDiagnosesDescription | LO | 
| 00081190 | Extraire l'URL | UR | 
| 00100010 | PatientName | PN | 
| 00100020 | Identifiant du patient | LO | 
| 00100021 | IssuerOfPatientID | LO | 
| 00100022 | TypeOfPatientID | CS | 
| 00100026 | SourcePatientGroupIdentificationSequence | SQ. | 
| 00100027 | GroupOfPatientsIdentificationSequence | SQ. | 
| 00100028 | SubjectRelativePositionInImage | ETATS-UNIS | 
| 00100030 | PatientBirthDate | DA | 
| 00100032 | PatientBirthTime | TM | 
| 00100033 | PatientBirthDateInAlternativeCalendar | LO | 
| 00100034 | PatientDeathDateInAlternativeCalendar | LO | 
| 00100035 | PatientAlternativeCalendar | CS | 
| 00100040 | PatientSex | CS | 
| 00100050 | PatientInsurancePlanCodeSequence | SQ. | 
| 00100101 | PatientPrimaryLanguageCodeSequence | SQ. | 
| 00100102 | PatientPrimaryLanguageModifierCodeSequence | SQ. | 
| 00100200 | QualityControlSubject | CS | 
| 00100201 | QualityControlSubjectTypeCodeSequence | SQ. | 
| 00100213 | StrainNomenclature | LO | 
| 00100214 | StrainStockNumber | LO | 
| 00100215 | StrainSourceRegistryCodeSequence | SQ. | 
| 00100217 | StrainSource | LO | 
| 00100219 | StrainCodeSequence | SQ. | 
| 00100223 | GeneticModificationsNomenclature | LO | 
| 00100229 | GeneticModificationsCodeSequence | SQ. | 
| 00101001 | OtherPatientNames | PN | 
| 00101005 | PatientBirthName | PN | 
| 00101010 | PatientAge | AS | 
| 00101020 | PatientSize | SERGENT | 
| 00101021 | PatientSizeCodeSequence | SQ. | 
| 00101022 | PatientBodyMassIndex | SERGENT | 
| 00101023 | Dimension AP mesurée | SERGENT | 
| 00101024 | MeasuredLateralDimension | SERGENT | 
| 00101030 | PatientWeight | SERGENT | 
| 00101040 | PatientAddress | LO | 
| 00101060 | PatientMotherBirthName | PN | 
| 00101080 | MilitaryRank | LO | 
| 00101081 | BranchOfService | LO | 
| 00102000 | MedicalAlerts | LO | 
| 00102110 | Allergies | LO | 
| 00102150 | CountryOfResidence | LO | 
| 00102152 | RegionOfResidence | LO | 
| 00102154 | PatientTelephoneNumbers | SH | 
| 00102160 | EthnicGroup | SH | 
| 00102180 | Profession | SH | 
| 001021A0 | SmokingStatus | CS | 
| 001021C0 | PregnancyStatus | ETATS-UNIS | 
| 001021D0 | LastMenstrualDate | DA | 
| 001021F0 | PatientReligiousPreference | LO | 
| 00102201 | PatientSpeciesDescription | LO | 
| 00102202 | PatientSpeciesCodeSequence | SQ. | 
| 00102203 | PatientSexNeutered | CS | 
| 00102210 | AnatomicalOrientationType | CS | 
| 00102292 | PatientBreedDescription | LO | 
| 00102293 | PatientBreedCodeSequence | SQ. | 
| 00102295 | BreedRegistrationNumber | LO | 
| 00102296 | BreedRegistryCodeSequence | SQ. | 
| 00102297 | ResponsiblePerson | PN | 
| 00102298 | ResponsiblePersonRole | CS | 
| 00102299 | ResponsibleOrganization | LO | 
| 00109431 | ExaminedBodyThickness | FL | 
| 0020000D | StudyInstanceUID | UI | 
| 00200010 | ID de l'étude | SH | 
| 00201206 | NumberOfStudyRelatedSeries | IS | 
| 00201208 | NumberOfStudyRelatedInstances | IS | 
| 00321032 | RequestingPhysician | PN | 
| 00321033 | RequestingService | LO | 
| 00321060 | RequestedProcedureDescription | LO | 
| 00321070 | RequestedContrastAgent | LO | 
| 00380010 | Numéro d'admission | LO | 
| 00380016 | RouteOfAdmissions | LO | 
| 00380020 | AdmittingDate | DA | 
| 00380021 | AdmittingTime | TM | 
| 00380050 | SpecialNeeds | LO | 
| 00380060 | ServiceEpisodeID | LO | 
| 00380062 | ServiceEpisodeDescription | LO | 
| 00380300 | CurrentPatientLocation | LO | 
| 00380400 | PatientInstitutionResidence | LO | 
| 00380500 | PatientState | LO | 
| 00400244 | PerformedProcedureStepStartDate | DA | 
| 00400245 | PerformedProcedureStepStartTime | TM | 
| 00400250 | PerformedProcedureStepEndDate | DA | 
| 00400251 | PerformedProcedureStepEndTime | TM | 
| 00400253 | PerformedProcedureStepID | SH | 
| 00081032 | ProcedureCodeSequence | SQ. | 
| 00100024 | IssuerOfPatientIDQualifiersSequence | SQ. | 
| 00321034 | RequestingServiceCodeSequence | SQ. | 
| 00321064 | RequestedProcedureCodeSequence | SQ. | 
| 00401012 | ReasonForPerformedProcedureCodeSequence | SQ. | 

#### Niveau de la série (includefield=all)
<a name="dicomweb-includefield-all-series"></a>

Le tableau suivant répertorie les attributs de niveau série renvoyés lorsqu'ils `includefield=all` sont spécifiés. Le niveau de la série renvoie également tous les attributs du niveau de l'étude répertoriés dans le tableau précédent.


**Attributs au niveau de la série pour includefield=all**  

| Balise | Nom | VR | 
| --- | --- | --- | 
| 00080021 | SeriesDate | DA | 
| 00080031 | SeriesTime | TM | 
| 00080060 | Modalité | CS | 
| 00080064 | ConversionType | CS | 
| 00080068 | PresentationIntentType | CS | 
| 00080070 | Fabricant | LO | 
| 00080080 | InstitutionName | LO | 
| 00080082 | InstitutionCodeSequence | SQ. | 
| 00081010 | StationName | SH | 
| 0008103E | SeriesDescription | LO | 
| 0008103F | SeriesDescriptionCodeSequence | SQ. | 
| 00081040 | InstitutionalDepartmentName | LO | 
| 00081041 | InstitutionalDepartmentTypeCodeSequence | SQ. | 
| 00081050 | PerformingPhysicianName | PN | 
| 00081070 | OperatorsName | PN | 
| 00081090 | ManufacturerModelName | LO | 
| 00180010 | ContrastBolusAgent | LO | 
| 00180015 | BodyPartExamined | CS | 
| 00180050 | SliceThickness | SERGENT | 
| 00180088 | SpacingBetweenSlices | SERGENT | 
| 00181000 | DeviceSerialNumber | LO | 
| 00181016 | SecondaryCaptureDeviceManufacturer | LO | 
| 00181018 | SecondaryCaptureDeviceManufacturerModelName | LO | 
| 00181019 | SecondaryCaptureDeviceSoftwareVersions | LO | 
| 00181020 | SoftwareVersions | LO | 
| 00181030 | ProtocolName | LO | 
| 00181050 | SpatialResolution | SERGENT | 
| 00181200 | DateOfLastCalibration | DA | 
| 00181201 | TimeOfLastCalibration | TM | 
| 00185100 | PatientPosition | CS | 
| 0020000D | StudyInstanceUID | UI | 
| 0020000E | SeriesInstanceUID | UI | 
| 00200011 | SeriesNumber | IS | 
| 00200052 | FrameOfReferenceUID | UI | 
| 00200060 | Latéralité | CS | 
| 00201209 | NumberOfSeriesRelatedInstances | IS | 
| 00540081 | NumberOfSlices | ETATS-UNIS | 
| 00540101 | NumberOfTimeSlices | ETATS-UNIS | 
| 00541000 | SeriesType | CS | 

#### Niveau de l'instance (includefield=all)
<a name="dicomweb-includefield-all-instance"></a>

Au niveau de l'instance, `includefield=all` renvoie les métadonnées DICOM complètes au niveau de l'instance. Cela inclut tous les attributs stockés dans les métadonnées de l'instance HealthImaging stockées. Toutes les balises DICOM présentes dans le fichier DICOM d'origine pour cette instance sont renvoyées, à l'exception de l'attribut de données en pixels.

**Topics**
+ [API de recherche DICOMWeb pour HealthImaging](#dicomweb-search-services)
+ [Types de requêtes DICOMWeb pris en charge pour HealthImaging](#dicomweb-query-types)
+ [Utilisation IncludeField dans les QIDO-RS requêtes](#dicomweb-includefield)
+ [À la recherche d'études DICOM dans HealthImaging](dicomweb-search-studies.md)
+ [Recherche de la série DICOM dans HealthImaging](dicomweb-search-series.md)
+ [Recherche d'instances DICOM dans HealthImaging](dicomweb-search-instances.md)