Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Ricerca di dati DICOM in HealthImaging AWS HealthImaging offre rappresentazioni delle QIDO-RS API [DICOMWeb](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) per cercare studi, serie e istanze in base all'ID del paziente e ricevere i relativi identificatori univoci per un ulteriore utilizzo. HealthImagingle QIDO-RS API DICOMWeb offrono flessibilità nel modo in cui cerchi i dati archiviati e forniscono l'interoperabilità con le applicazioni legacy. HealthImaging **Importante** HealthImagingle API DICOMWeb possono essere utilizzate per restituire informazioni sul set di immagini con. QIDO-RS HealthImaging [Le API DICOMWeb fanno riferimento solo ai set di immagini primari, salvo diversa indicazione.](getting-started-concepts.md#concept-image-set) Utilizza [le azioni native del HealthImaging cloud](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) o il parametro opzionale del set di immagini delle azioni DICOMWeb per recuperare set di immagini non primari. HealthImagingle API DICOMWeb possono essere utilizzate per restituire informazioni sul set di immagini con risposte. DICOMweb-conformant HealthImaging QIDO-RS Le azioni DICOMWeb possono restituire un massimo di 10.000 record. [Nel caso in cui esistano più di 10.000 risorse, queste non saranno recuperabili tramite QIDO-RS le azioni, ma possono essere recuperate tramite azioni WADO-RS DICOMWeb o azioni native del cloud.](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) Le API elencate in questa sezione sono integrate in conformità allo standard DICOMWeb () per l'imaging medico basato sul web. QIDO-RS Non sono offerte tramite SDK. AWS CLI AWS ## API di ricerca DICOMWeb per HealthImaging La tabella seguente descrive tutte le HealthImaging rappresentazioni delle QIDO-RS API DICOMWeb disponibili per la ricerca di dati. HealthImaging **HealthImaging rappresentazioni delle API DICOMWeb QIDO-RS** | Nome | Description | | --- | --- | | SearchDICOMStudies | Cerca gli studi DICOM in specificando gli elementi della query HealthImaging di ricerca utilizzando una richiesta GET. I risultati della ricerca degli studi vengono restituiti in formato JSON, ordinati per ultimo aggiornamento, data decrescente (dalla più recente alla più vecchia). Per informazioni, consulta [Cerca studi](dicomweb-search-studies.md). | | SearchDICOMSeries | Cerca le serie DICOM in HealthImaging specificando gli elementi della query di ricerca utilizzando una richiesta GET. I risultati della ricerca delle serie vengono restituiti in formato JSON, ordinati Series Number (0020, 0011) in ordine crescente (dalla più vecchia alla più recente). Per informazioni, consulta [Cerca serie](dicomweb-search-series.md). | | SearchDICOMInstances | Cerca le istanze DICOM in HealthImaging specificando gli elementi della query di ricerca utilizzando una richiesta GET. I risultati della ricerca delle istanze vengono restituiti in formato JSON, ordinati Instance Number (0020, 0013) in ordine crescente (dalla più vecchia alla più recente). Per informazioni, consulta [Cerca istanze](dicomweb-search-instances.md). | ## Tipi di query DICOMWeb supportati per HealthImaging HealthImaging supporta interrogazioni QIDO-RS gerarchiche sulle risorse a livello di studio, serie e istanza SOP. Quando si utilizza QIDO-RS la ricerca gerarchica per: HealthImaging + La ricerca di studi restituisce un elenco di studi + La ricerca di una serie di studi richiede una serie nota `StudyInstanceUID` e restituisce un elenco di serie + La ricerca in un elenco di istanze richiede un nome noto `StudyInstanceUID` e `SeriesInstanceUID` La tabella seguente descrive i tipi di query QIDO-RS gerarchiche supportati per la ricerca di dati. HealthImaging **HealthImaging tipi di query supportati QIDO-RS** | Tipo di query | Esempio | | --- | --- | | interrogazioni sui valori degli attributi | Cerca tutte le serie in uno studio dove`modality=CT`.
`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`
Cerca in tutti gli studi in cui l'ID del paziente e la data dello studio corrispondono rispettivamente a questi valori.
`…/studies?PatientID=11235813&StudyDate=20130509` | | Interrogazioni con parole chiave | Cerca tutte le serie utilizzando la `SeriesInstanceUID` parola chiave.
`.../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` | | Interrogazioni di tag | Cerca i tag utilizzando i parametri di interrogazione passati nel group/element modulo.
{group} {element} come 0020000D | | Interrogazioni sull'intervallo | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | | Paginazione dei risultati con e limit offset | `.../studies?limit=1&offset=0&00080020=20000101`
È possibile utilizzare i parametri limit e offset per impaginare le risposte di ricerca. Il valore predefinito del limite è 1000 e vedi il [HealthImaging Endpoint e quote AWS](endpoints-quotas.md) valore massimo.
Limite massimo = 1000, offset massimo = 9000 | | Interrogazioni con Wildcard | Le interrogazioni Wildcard offrono una maggiore flessibilità nella ricerca utilizzando «\*» e «?». «\*» corrisponde a qualsiasi sequenza di caratteri (incluso un valore di lunghezza zero) e «?» corrisponde a qualsiasi carattere singolo.
Cerca tutti gli studi in un datastore che StudyDescription contiene «Nuclear»:
`.../studies?StudyDescription=*Nuclear*`
Cerca tutti gli studi che StudyDescription terminano con «Nucleare»:
`.../studies?StudyDescription=*Nuclear`
Cerca tutti gli studi che StudyDescription iniziano con «Nucleare»:
`.../studies?StudyDescription=Nuclear*`
Cerca tutti gli studi in cui PatientID ha esattamente 3 caratteri qualsiasi dopo 200965981:
`.../studies?PatientID=200965981???` | | FuzzyMatching domande | Abilita la corrispondenza fuzzy sugli attributi DICOM del nome ((0010,0010), PatientName ReferringPhysicianName (0008,0090)) aggiungendo il parametro di query opzionale fuzzymatching:
`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`
Questa query esegue la corrispondenza delle parole del prefisso senza distinzione tra maiuscole e minuscole su qualsiasi parte del valore. PatientName Restituisce risultati con PatientName valori come «thomas», «Albert», «Thomas Albert», «Thomas^Albert», ma non «hom» o «ber». | | IncludeField interrogazioni | Utilizzate il parametro `includefield` query per richiedere attributi DICOM aggiuntivi oltre al set di risposte predefinito.
Restituisce attributi specifici per tag:
`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`
Restituisce tutti gli attributi disponibili:
`.../studies?PatientID=11235813&includefield=all`
Restituisce gli attributi secondari della sequenza (SQ) utilizzando la notazione punteggiata:
`.../studies?PatientID=11235813&includefield=00080096.00080100`
Restituisce elementi di dati privati:
`.../instances?includefield=00191001&00190010=Philips` | ## Utilizzo IncludeField nelle QIDO-RS interrogazioni Il parametro `includefield` query consente di richiedere attributi DICOM aggiuntivi oltre alla risposta predefinita impostata nelle HealthImaging QIDO-RS query. È possibile utilizzarlo `includefield` a livello di studio, di serie e di istanza. ### Sintassi Utilizza il seguente formato di richiesta GET per includere campi aggiuntivi nelle tue QIDO-RS query: ``` GET .../studies?&includefield= GET .../studies//series?&includefield= GET .../studies//series//instances?&includefield= ``` È possibile specificare più `includefield` parametri in un'unica richiesta: ``` GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010 ``` ### Valori supportati per includefield La tabella seguente descrive i valori supportati per il `includefield` parametro. **Valori includefield supportati** | Value type (Tipo di valore) | Description | Esempio | | --- | --- | --- | | Tag DICOM (8 caratteri esadecimali) | Richiedi un attributo DICOM specifico tramite il relativo tag in formato GGGGEEEE. | includefield=00081030 | | all | Richiedi tutti gli attributi DICOM disponibili per il livello di risorsa. | includefield=all | | Percorso SQL punteggiato | Richiedi un attributo secondario specifico all'interno di un attributo Sequence (SQ) utilizzando la notazione a punti:. . | includefield=00080096.00080100 | | Tag con elemento di dati privato | Richiedi un tag privato (elemento di gruppo dispari). Richiede il parametro. privateCreatorElement | includefield=00191001 | | Attributi DICOM standard, inclusi bulkdata | Richiedi attributi singoli o multipli specifici per tag o parola chiave. | includefield=00102201 | ### Comportamento e regole Le seguenti regole si applicano alle `includefield` interrogazioni: + **Risposta predefinita**: senza`includefield`, la QIDO-RS risposta restituisce solo il set di attributi standard. + **includefield=all — Restituisce tutti gli** attributi disponibili al livello richiesto. Se combinato con altri `all` `includefield` valori, ha la priorità. `all` + **Numero massimo di tag**: una richiesta può includere fino a 50 `includefield` parametri. + **Tag duplicati**: `includefield` i valori duplicati vengono deduplicati e trattati come una singola richiesta. + **Tag non validi o mancanti**: se un tag richiesto non esiste nei dati DICOM o non è valido, viene omesso silenziosamente dalla risposta. Vengono comunque restituiti altri attributi validi`includefield`. ### Attributi di sequenza (SQ) Usa la notazione a punti per richiedere attributi annidati all'interno di un attributo Sequence (SQ): ``` includefield=. ``` Ad esempio, per recuperare CodeValue (0008,0100) all'interno di (0008,0096): ReferringPhysicianIdentificationSequence ``` GET .../studies?PatientID=11235813&includefield=00080096.00080100 ``` Multi-level la nidificazione è supportata. Esempio: ``` includefield=00081115.00081199.00081150 ``` ### Tag privati Gli elementi di dati DICOM privati (tag con gruppi dispari) sono supportati a tutti i livelli di risorse. Per richiedere tag privati, includi il `privateCreatorElement` parametro di query. Utilizzare la seguente sintassi: ``` GET .../instances?includefield=&= ``` Esempio: ``` GET .../instances?includefield=00191001&00190010=Philips ``` Le seguenti regole si applicano ai tag privati: + Il `privateCreatorElement` tag e il nome del creatore devono essere forniti come parametro di corrispondenza se viene richiesto il tag privato. + Se il valore specificato non `privateCreatorElement` viene trovato, il tag privato viene omesso silenziosamente. + La richiesta di un solo `privateCreatorElement` tag senza un elemento di dati privato restituisce solo il nome e il valore dell'elemento creatore. Non restituisce tutti i tag appartenenti al blocco di quel creatore. ### Tag Bulkdata Gli attributi DICOM con VR bulkdata (OB, OD, OF, OL, UN, OW, OV) con valore binario superiore a 1 MB richiesti come parte di `includefield` vengono restituiti `bulkdataURI` al posto del valore binario non elaborato. [Per ulteriori informazioni sul recupero di bulkdata, vedere Recupero di bulkdata DICOM in. HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html) ### Cosa restituisce includefield=all a ogni livello? Quando `includefield=all` viene specificata, la risposta include tutti gli attributi a livello di risorsa specifico. #### Livello di studio (includefield=all) La tabella seguente elenca tutti gli attributi restituiti a livello di studio quando specificato. `includefield=all` **Attributi a livello di studio per includefield=all** | Tag | Nome | Realtà virtuale | | --- | --- | --- | | 00080005 | SpecificCharacterSet | CS | | 00080020 | StudyDate | GIORNO | | 00080030 | StudyTime | TM | | 00080050 | AccessionNumber | SH | | 00080051 | IssuerOfAccessionNumberSequence | QUADRATO | | 00080056 | InstanceAvailability | CS | | 00080061 | ModalitiesInStudy | CS | | 00080062 | SOPClassesInStudy | Interfaccia utente | | 00080090 | ReferringPhysicianName | PN | | 0008009C | ConsultingPhysicianName | PN | | 00080201 | TimezoneOffsetFromUTC | SH | | 00081030 | StudyDescription | LOTO | | 00081048 | PhysiciansOfRecord | PN | | 00081060 | NameOfPhysiciansReadingStudy | PN | | 00081080 | AdmittingDiagnosesDescription | LOTO | | 00081190 | Recupera URL | NUR | | 00100010 | PatientName | PN | | 00100020 | ID del paziente | LOTO | | 0010021 | IssuerOfPatientID | LOTO | | 0010022 | TypeOfPatientID | CS | | 00100026 | SourcePatientGroupIdentificationSequence | QUADRATO | | 00100027 | GroupOfPatientsIdentificationSequence | QUADRATO | | 00100028 | SubjectRelativePositionInImage | US | | 00100030 | PatientBirthDate | GIORNO | | 00100032 | PatientBirthTime | TM | | 00100033 | PatientBirthDateInAlternativeCalendar | LOTO | | 0010034 | PatientDeathDateInAlternativeCalendar | LOTO | | 0010035 | PatientAlternativeCalendar | CS | | 00100040 | PatientSex | CS | | 00100050 | PatientInsurancePlanCodeSequence | QUADRATO | | 00100101 | PatientPrimaryLanguageCodeSequence | QUADRATO | | 00100102 | PatientPrimaryLanguageModifierCodeSequence | QUADRATO | | 00100200 | QualityControlSubject | CS | | 00100201 | QualityControlSubjectTypeCodeSequence | QUADRATO | | 00100213 | StrainNomenclature | LOTO | | 00100214 | StrainStockNumber | LO | | 00100215 | StrainSourceRegistryCodeSequence | QUADRATO | | 00100217 | StrainSource | LOTO | | 00100219 | StrainCodeSequence | QUADRATO | | 00100223 | GeneticModificationsNomenclature | LOTO | | 00100229 | GeneticModificationsCodeSequence | QUADRATO | | 00101001 | OtherPatientNames | PN | | 00101005 | PatientBirthName | PN | | 00101010 | PatientAge | AS | | 00101020 | PatientSize | ANNUNCI | | 00101021 | PatientSizeCodeSequence | QUADRATO | | 00101022 | PatientBodyMassIndex | ANNUNCI | | 00101023 | Misura la dimensione del DAP | ANNUNCI | | 00101024 | MeasuredLateralDimension | ANNUNCI | | 00101030 | PatientWeight | ANNUNCI | | 00101040 | PatientAddress | LOTO | | 00101060 | PatientMotherBirthName | PN | | 00101080 | MilitaryRank | LOTO | | 00101081 | BranchOfService | LOTO | | 00102000 | MedicalAlerts | LOTO | | 00102110 | Allergie | LO | | 00102150 | CountryOfResidence | LO | | 00102152 | RegionOfResidence | LOTO | | 00102154 | PatientTelephoneNumbers | SH | | 00102160 | EthnicGroup | SH | | 00102180 | Occupazione | SH | | 001021A0 | SmokingStatus | CS | | 001021C0 | PregnancyStatus | US | | 001021D0 | LastMenstrualDate | DADO | | 001021F0 | PatientReligiousPreference | LOTO | | 00102201 | PatientSpeciesDescription | LO | | 00102202 | PatientSpeciesCodeSequence | QUADRATO | | 00102203 | PatientSexNeutered | CS | | 00102210 | AnatomicalOrientationType | CS | | 00102292 | PatientBreedDescription | LOTO | | 00102293 | PatientBreedCodeSequence | QUADRATO | | 00102295 | BreedRegistrationNumber | LOTO | | 00102296 | BreedRegistryCodeSequence | QUADRATO | | 00102297 | ResponsiblePerson | PN | | 00102298 | ResponsiblePersonRole | CS | | 00102299 | ResponsibleOrganization | LOTO | | 00109431 | ExaminedBodyThickness | FLOLA | | 0020.000 D | StudyInstanceUID | Interfaccia utente | | 00200010 | ID dello studio | SH | | 00201206 | NumberOfStudyRelatedSeries | IS | | 00201208 | NumberOfStudyRelatedInstances | IS | | 00321032 | RequestingPhysician | PN | | 00321033 | RequestingService | LOTO | | 00321060 | RequestedProcedureDescription | LOTO | | 0032 1070 | RequestedContrastAgent | LOTO | | 00380010 | ID di ammissione | LOTO | | 00380016 | RouteOfAdmissions | LOTO | | 00380020 | AdmittingDate | GIORNO | | 00380021 | AdmittingTime | TM | | 00380050 | SpecialNeeds | LOTO | | 00380060 | ServiceEpisodeIDENTITÀ | LO | | 00380062 | ServiceEpisodeDescription | LOTO | | 00380300 | CurrentPatientLocation | LOTO | | 0038 0400 | PatientInstitutionResidence | LOTO | | 00380500 | PatientState | LOTO | | 00400244 | PerformedProcedureStepStartDate | GIORNO | | 00400245 | PerformedProcedureStepStartTime | TM | | 00400250 | PerformedProcedureStepEndDate | GIORNO | | 00400251 | PerformedProcedureStepEndTime | TM | | 00400253 | PerformedProcedureStepID | SH | | 00081032 | ProcedureCodeSequence | QUADRATO | | 00100024 | IssuerOfPatientIDQualifiersSequence | QUADRATO | | 00321034 | RequestingServiceCodeSequence | QUADRATO | | 00321064 | RequestedProcedureCodeSequence | QUADRATO | | 00401012 | ReasonForPerformedProcedureCodeSequence | QUADRATO | #### Livello di serie (includefield=all) La tabella seguente elenca gli attributi a livello di serie restituiti quando viene specificato. `includefield=all` Il livello di serie restituisce anche tutti gli attributi a livello di studio elencati nella tabella precedente. **Attributi a livello di serie per includefield=all** | Tag | Nome | Realtà virtuale | | --- | --- | --- | | 00080021 | SeriesDate | GIORNO | | 00080031 | SeriesTime | TM | | 00080060 | Modalità | CS | | 00080064 | ConversionType | CS | | 00080068 | PresentationIntentType | CS | | 00080070 | Produttore | LOTO | | 00080080 | InstitutionName | LOTO | | 00080082 | InstitutionCodeSequence | QUADRATO | | 00081010 | StationName | SH | | 0008103E | SeriesDescription | LOTO | | 0008103F | SeriesDescriptionCodeSequence | QUADRATO | | 00081040 | InstitutionalDepartmentName | LOTO | | 00081041 | InstitutionalDepartmentTypeCodeSequence | QUADRATO | | 00081050 | PerformingPhysicianName | PN | | 00081070 | OperatorsName | PN | | 00081090 | ManufacturerModelName | LOTO | | 00180010 | ContrastBolusAgent | LOTO | | 0018 0015 | BodyPartExamined | CS | | 00180050 | SliceThickness | ANNUNCI | | 00180088 | SpacingBetweenSlices | ANNUNCI | | 00181000 | DeviceSerialNumber | LOTO | | 0018 1016 | SecondaryCaptureDeviceManufacturer | LOTO | | 0018 1018 | SecondaryCaptureDeviceManufacturerModelName | LO | | 0018 1019 | SecondaryCaptureDeviceSoftwareVersions | LOTO | | 0018 1020 | SoftwareVersions | LO | | 0018 1030 | ProtocolName | LO | | 0018 1050 | SpatialResolution | ANNUNCI | | 00181200 | DateOfLastCalibration | GIORNO | | 00181201 | TimeOfLastCalibration | TM | | 00185100 | PatientPosition | CS | | 0020000 D | StudyInstanceUID | Interfaccia utente | | 0020000E | SeriesInstanceUID | Interfaccia utente | | 00200011 | SeriesNumber | IS | | 00200052 | FrameOfReferenceUID | Interfaccia utente | | 00200060 | Lateralità | CS | | 00201209 | NumberOfSeriesRelatedInstances | IS | | 00540081 | NumberOfSlices | US | | 00540101 | NumberOfTimeSlices | US | | 00541000 | SeriesType | CS | #### Livello di istanza (includefield=all) A livello di istanza, `includefield=all` restituisce i metadati DICOM completi a livello di istanza. Ciò include tutti gli attributi memorizzati nei metadati dell'istanza in storage. HealthImaging Viene restituito ogni tag DICOM presente nel file DICOM originale per quell'istanza, ad eccezione dell'attributo pixel data. **Topics** + [API di ricerca DICOMWeb per HealthImaging](#dicomweb-search-services) + [Tipi di query DICOMWeb supportati per HealthImaging](#dicomweb-query-types) + [Utilizzo IncludeField nelle QIDO-RS interrogazioni](#dicomweb-includefield) + [Alla ricerca di studi DICOM in HealthImaging](dicomweb-search-studies.md) + [Ricerca di serie DICOM in HealthImaging](dicomweb-search-series.md) + [Ricerca di istanze DICOM in HealthImaging](dicomweb-search-instances.md)