As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Pesquisando dados DICOM em HealthImaging HealthImaging A AWS oferece representações das QIDO-RS APIs [DICOMWeb](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) para pesquisar estudos, séries e instâncias por ID do paciente e receber seus identificadores exclusivos para uso posterior. HealthImagingAs QIDO-RS APIs DICOMWeb da oferecem flexibilidade na forma como você pesquisa dados armazenados HealthImaging e fornecem interoperabilidade com aplicativos legados. **Importante** HealthImagingAs APIs DICOMWeb da podem ser usadas para retornar informações do conjunto de imagens com. QIDO-RS HealthImaging As APIs DICOMWeb fazem referência somente a [conjuntos de imagens](getting-started-concepts.md#concept-image-set) primárias, salvo indicação em contrário. Use [ações nativas da HealthImaging nuvem](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) ou o parâmetro opcional de conjunto de imagens das ações DICOMWeb para recuperar conjuntos de imagens não primárias. HealthImagingAs APIs DICOMWeb da podem ser usadas para retornar informações do conjunto de imagens com respostas. DICOMweb-conformant HealthImaging QIDO-RS As ações do DICOMWeb podem retornar no máximo 10.000 registros. [Caso existam mais de 10.000 recursos, eles não serão recuperáveis por meio das QIDO-RS ações, mas poderão ser recuperados por meio de ações DICOMWeb ou WADO-RS ações nativas da nuvem.](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) As APIs listadas nesta seção são criadas em conformidade com o padrão DICOMWeb (QIDO-RS) para imagens médicas baseadas na web. Eles não são oferecidos por meio de AWS CLI AWS SDKs. ## APIs de pesquisa DICOMWeb para HealthImaging A tabela a seguir descreve todas as HealthImaging representações das QIDO-RS APIs DICOMWeb disponíveis para pesquisar dados em. HealthImaging **HealthImaging representações de APIs DICOMWeb QIDO-RS** | Name (Nome) | Description | | --- | --- | | SearchDICOMStudies | Pesquise estudos DICOM HealthImaging especificando elementos de consulta de pesquisa usando uma solicitação GET. Os resultados da pesquisa do estudo são retornados no formato JSON, ordenados pela última atualização, com data decrescente (da mais recente para a mais antiga). Consulte [Pesquise estudos](dicomweb-search-studies.md). | | SearchDICOMSeries | Pesquise a série DICOM HealthImaging especificando os elementos da consulta de pesquisa usando uma solicitação GET. Os resultados da pesquisa em série são retornados no formato JSON, ordenados por Series Number (0020, 0011) ordem crescente (do mais antigo para o mais recente). Consulte [Pesquisar séries](dicomweb-search-series.md). | | SearchDICOMInstances | Pesquise instâncias DICOM HealthImaging especificando elementos de consulta de pesquisa usando uma solicitação GET. Os resultados da pesquisa de instâncias são retornados no formato JSON, ordenados por Instance Number (0020, 0013) ordem crescente (do mais antigo para o mais recente). Consulte [Pesquisar instâncias](dicomweb-search-instances.md). | ## Tipos de consulta DICOMWeb suportados para HealthImaging HealthImaging suporta consultas QIDO-RS hierárquicas de recursos nos níveis de estudo, série e instância SOP. Ao usar a pesquisa QIDO-RS hierárquica para: HealthImaging + A busca por estudos retorna uma lista de estudos + Pesquisar uma série de estudos requer uma série conhecida `StudyInstanceUID` e retorna uma lista de séries + Pesquisar uma lista de instâncias requer uma informação conhecida `StudyInstanceUID` e `SeriesInstanceUID` A tabela a seguir descreve os tipos de consulta QIDO-RS hierárquica compatíveis para pesquisar dados em. HealthImaging **HealthImaging tipos de QIDO-RS consulta suportados** | Tipo da consulta | Exemplo | | --- | --- | | Consultas de valores de atributos | Pesquise todas as séries em um estudo onde`modality=CT`.
`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`
Pesquise todos os estudos em que o ID do paciente e a data do estudo sejam esses valores, respectivamente.
`…/studies?PatientID=11235813&StudyDate=20130509` | | Consultas de palavras-chave | Pesquise todas as séries usando a `SeriesInstanceUID` palavra-chave.
`.../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` | | Consultas de tags | Pesquise tags usando parâmetros de consulta passados no group/element formulário.
{group} {element} como 0020000D | | Intervalo de consultas | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | | Paginação de resultados com e limit offset | `.../studies?limit=1&offset=0&00080020=20000101`
Você pode usar os parâmetros de limite e deslocamento para paginar as respostas da pesquisa. O valor padrão do limite é 1000 e veja [HealthImaging Endpoints e cotas da AWS](endpoints-quotas.md) o valor máximo.
Limite máximo = 1000, deslocamento máximo = 9000 | | Consultas curingas | As consultas curinga oferecem mais flexibilidade na pesquisa usando “\*” e “?”. “\*” corresponde a qualquer sequência de caracteres (incluindo um valor de comprimento zero) e “?” corresponde a qualquer caractere único.
Pesquise todos os estudos em um armazenamento de dados que StudyDescription contenha “Nuclear”:
`.../studies?StudyDescription=*Nuclear*`
Pesquise todos os estudos que StudyDescription terminam com “Nuclear”:
`.../studies?StudyDescription=*Nuclear`
Pesquise todos os estudos que StudyDescription começam com “Nuclear”:
`.../studies?StudyDescription=Nuclear*`
Pesquise todos os estudos em que o PatientID tenha exatamente 3 caracteres após 200965981:
`.../studies?PatientID=200965981???` | | FuzzyMatching consultas | Ative a correspondência difusa nos atributos DICOM do nome ((0010.0010), PatientName ReferringPhysicianName (0008.0090)) adicionando o parâmetro de consulta opcional fuzzymatching:
`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`
Essa consulta realiza a correspondência de palavras de prefixo sem distinção entre maiúsculas e minúsculas em qualquer parte do valor. PatientName Ele retorna resultados com PatientName valores como “thomas”, “Albert”, “Thomas Albert”, “Thomas^Albert”, mas não “hom” ou “ber”. | | IncludeField consultas | Use o parâmetro de `includefield` consulta para solicitar atributos DICOM adicionais além do conjunto de respostas padrão.
Retorne atributos específicos por tag:
`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`
Retorne todos os atributos disponíveis:
`.../studies?PatientID=11235813&includefield=all`
Subatributos da sequência de retorno (SQ) usando notação pontilhada:
`.../studies?PatientID=11235813&includefield=00080096.00080100`
Retorne elementos de dados privados:
`.../instances?includefield=00191001&00190010=Philips` | ## Usando IncludeField em QIDO-RS consultas O parâmetro de `includefield` consulta permite que você solicite atributos DICOM adicionais além da resposta padrão definida nas HealthImaging QIDO-RS consultas. Você pode usar `includefield` nos níveis de estudo, série e instância. ### Sintaxe Use o seguinte formato de solicitação GET para incluir campos adicionais em suas QIDO-RS consultas: ``` GET .../studies?&includefield= GET .../studies//series?&includefield= GET .../studies//series//instances?&includefield= ``` Você pode especificar vários `includefield` parâmetros em uma única solicitação: ``` GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010 ``` ### Valores suportados para includefield A tabela a seguir descreve os valores compatíveis com o `includefield` parâmetro. **Valores de campo de inclusão suportados** | Tipo de valor | Description | Exemplo | | --- | --- | --- | | Etiqueta DICOM (8 caracteres hexadecimais) | Solicite um atributo DICOM específico por meio de sua tag no formato GGGGEEEE. | includefield=00081030 | | all | Solicite todos os atributos DICOM disponíveis para o nível do recurso. | includefield=all | | Caminho SQL pontilhado | Solicite um subatributo específico dentro de um atributo Sequence (SQ) usando a notação de pontos:. . | includefield=00080096.00080100 | | Tag de elemento de dados privado | Solicite uma tag privada (elemento de grupo ímpar). Requer o privateCreatorElement parâmetro. | includefield=00191001 | | Atributos DICOM padrão, incluindo dados em massa | Solicite atributos únicos ou múltiplos específicos por tag ou palavra-chave. | includefield=00102201 | ### Comportamento e regras As regras a seguir se aplicam às `includefield` consultas: + **Resposta padrão** — Sem `includefield` ela, a QIDO-RS resposta retorna somente o conjunto padrão de atributos. + **includefield=all — Retorna todos os** atributos disponíveis no nível solicitado. Quando `all` é combinado com outros `includefield` valores, `all` tem prioridade. + **Máximo de tags** — Uma solicitação pode incluir até 50 `includefield` parâmetros. + **Tags duplicadas** — `includefield` os valores duplicados são desduplicados e tratados como uma única solicitação. + **Tags inválidas ou ausentes** — Se uma tag solicitada não existir nos dados DICOM ou for inválida, ela será silenciosamente omitida da resposta. Outros `includefield` atributos válidos ainda são retornados. ### Atributos de sequência (SQ) Use a notação de pontos para solicitar atributos aninhados em um atributo Sequence (SQ): ``` includefield=. ``` Por exemplo, para recuperar CodeValue (0008.0100) dentro ReferringPhysicianIdentificationSequence de (0008.0096): ``` GET .../studies?PatientID=11235813&includefield=00080096.00080100 ``` Multi-level o aninhamento é suportado. Por exemplo: ``` includefield=00081115.00081199.00081150 ``` ### Etiquetas privadas Elementos de dados DICOM privados (tags de grupos ímpares) são suportados em todos os níveis de recursos. Para solicitar tags privadas, inclua o parâmetro de `privateCreatorElement` consulta. Use a seguinte sintaxe: ``` GET .../instances?includefield=&= ``` Por exemplo: ``` GET .../instances?includefield=00191001&00190010=Philips ``` As regras a seguir se aplicam às tags privadas: + A `privateCreatorElement` tag e o nome do criador devem ser fornecidos como um parâmetro de correspondência se a tag privada for solicitada. + Se o especificado não `privateCreatorElement` for encontrado, a tag privada será omitida silenciosamente. + Solicitar somente uma `privateCreatorElement` tag sem um elemento de dados privado retorna somente o nome e o valor do elemento criador. Ele não retorna todas as tags pertencentes ao bloco do criador. ### Tags de dados em massa Os atributos DICOM com VRs de dados em massa (OB, OD, OF, OL, UN, OW, OV) com valor binário maior que 1 MB solicitado como parte do `includefield` são retornados `bulkdataURI` em vez do valor binário bruto. Para obter mais informações sobre como recuperar dados em massa, consulte [Recuperando](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html) dados em massa DICOM em. HealthImaging ### O que includefield=all retorna em cada nível? Quando `includefield=all` é especificada, a resposta inclui todos os atributos no nível de recurso específico. #### Nível de estudo (includefield=all) A tabela a seguir lista todos os atributos retornados no nível do estudo quando `includefield=all` especificado. **Atributos do nível de estudo para includefield=all** | Tag | Nome | RV | | --- | --- | --- | | 00080005 | SpecificCharacterSet | CS | | 00:08 020 | StudyDate | DA | | 00:08:30 | StudyTime | TM | | 00:08:0:050 | AccessionNumber | SH | | 00:08 051 | IssuerOfAccessionNumberSequence | SQ | | 00:08:0:056 | InstanceAvailability | CS | | 00:08 061 | ModalitiesInStudy | CS | | 00:08 062 | SOPClassesInStudy | Interface do usuário | | 00:08 090 | ReferringPhysicianName | PN | | 0008009C | ConsultingPhysicianName | PN | | 00:08 0201 | TimezoneOffsetFromUTC | SH | | 00:08:1030 | StudyDescription | LO | | 00:08:1048 | PhysiciansOfRecord | PN | | 00:08:1060 | NameOfPhysiciansReadingStudy | PN | | 00:08:1080 | AdmittingDiagnosesDescription | LO | | 00:08 1190 | Recuperar URL | NOSSO | | 00100010 | PatientName | PN | | 00100020 | ID do paciente | LO | | 00100021 | IssuerOfPatientID | LO | | 00100022 | TypeOfPatientID | CS | | 00:100026 | SourcePatientGroupIdentificationSequence | SQ | | 00:100027 | GroupOfPatientsIdentificationSequence | SQ | | 00:100028 | SubjectRelativePositionInImage | EUA | | 00:100030 | PatientBirthDate | DA | | 00100032 | PatientBirthTime | TM | | 00100033 | PatientBirthDateInAlternativeCalendar | LO | | 00100034 | PatientDeathDateInAlternativeCalendar | LO | | 00100035 | PatientAlternativeCalendar | CS | | 00:100040 | PatientSex | CS | | 00100050 | PatientInsurancePlanCodeSequence | SQ | | 00:10:0101 | PatientPrimaryLanguageCodeSequence | SQ | | 00:100:102 | PatientPrimaryLanguageModifierCodeSequence | SQ | | 00:100:200 | QualityControlSubject | CS | | 00:100:201 | QualityControlSubjectTypeCodeSequence | SQ | | 00:10:0213 | StrainNomenclature | LO | | 00:10:0214 | StrainStockNumber | LO | | 00:10:0215 | StrainSourceRegistryCodeSequence | SQ | | 00:10:0217 | StrainSource | LO | | 00:10:0219 | StrainCodeSequence | SQ | | 00:10:223 | GeneticModificationsNomenclature | LO | | 00:10:229 | GeneticModificationsCodeSequence | SQ | | 00:10:1001 | OtherPatientNames | PN | | 00:1010:05 | PatientBirthName | PN | | 00:10:1010 | PatientAge | AS | | 00:10:10.20 | PatientSize | DS | | 00:10:021 | PatientSizeCodeSequence | SQ | | 00:10:022 | PatientBodyMassIndex | DS | | 00:10:023 | Dimensão PAD medida | DS | | 00:10:1024 | MeasuredLateralDimension | DS | | 00:10:0,130 | PatientWeight | DS | | 00:10:1040 | PatientAddress | LO | | 00:10:1060 | PatientMotherBirthName | PN | | 00:10:1080 | MilitaryRank | LO | | 00:10:081 | BranchOfService | LO | | 00:10:2000 | MedicalAlerts | LO | | 00:10:2110 | Alergias | LO | | 00:10:2150 | CountryOfResidence | LO | | 00:10:2152 | RegionOfResidence | LO | | 00:10:2154 | PatientTelephoneNumbers | SH | | 00:10:2160 | EthnicGroup | SH | | 00:10:2180 | Ocupação | SH | | 001021A0 | SmokingStatus | CS | | 001021C0 | PregnancyStatus | EUA | | 001021D0 | LastMenstrualDate | DA | | 001021F0 | PatientReligiousPreference | LO | | 00:10:2201 | PatientSpeciesDescription | LO | | 00:10:2202 | PatientSpeciesCodeSequence | SQ | | 00:10:2203 | PatientSexNeutered | CS | | 00:10:2210 | AnatomicalOrientationType | CS | | 00:10:2292 | PatientBreedDescription | LO | | 00:10:2293 | PatientBreedCodeSequence | SQ | | 00:10:2295 | BreedRegistrationNumber | LO | | 00:10:2296 | BreedRegistryCodeSequence | SQ | | 00:10:2297 | ResponsiblePerson | PN | | 00:10:2298 | ResponsiblePersonRole | CS | | 00:10:2299 | ResponsibleOrganization | LO | | 00:10:94.31 | ExaminedBodyThickness | FL | | 0020000D | StudyInstanceUID | Interface do usuário | | 00200010 | ID do estudo | SH | | 00:20:206 | NumberOfStudyRelatedSeries | IS | | 00:20:208 | NumberOfStudyRelatedInstances | IS | | 00:32:1032 | RequestingPhysician | PN | | 00:32.1033 | RequestingService | LO | | 00:32:10.60 | RequestedProcedureDescription | LO | | 00:32:10,70 | RequestedContrastAgent | LO | | 00:38:0010 | ID de admissão | LO | | 00:380:016 | RouteOfAdmissions | LO | | 00:38:0020 | AdmittingDate | DA | | 00:38:0021 | AdmittingTime | TM | | 00:38:0050 | SpecialNeeds | LO | | 00:38:0060 | ServiceEpisodeID | LO | | 00:38:0062 | ServiceEpisodeDescription | LO | | 00:380:300 | CurrentPatientLocation | LO | | 00:380:400 | PatientInstitutionResidence | LO | | 00:380:500 | PatientState | LO | | 00:400 244 | PerformedProcedureStepStartDate | DA | | 00:40:245 | PerformedProcedureStepStartTime | TM | | 00:400:250 | PerformedProcedureStepEndDate | DA | | 00:40:0251 | PerformedProcedureStepEndTime | TM | | 00:40:253 | PerformedProcedureStepID | SH | | 00:081032 | ProcedureCodeSequence | SQ | | 00100024 | IssuerOfPatientIDQualifiersSequence | SQ | | 00:32:10,34 | RequestingServiceCodeSequence | SQ | | 00:32:10,64 | RequestedProcedureCodeSequence | SQ | | 00:40:10.12 | ReasonForPerformedProcedureCodeSequence | SQ | #### Nível da série (includefield=all) A tabela a seguir lista os atributos de nível de série retornados quando `includefield=all` é especificado. O nível da série também retorna todos os atributos do nível de estudo listados na tabela anterior. **Atributos de nível de série para includefield=all** | Tag | Nome | RV | | --- | --- | --- | | 00:08 021 | SeriesDate | DA | | 00:08 031 | SeriesTime | TM | | 00:08:060 | Modalidade | CS | | 00:08 064 | ConversionType | CS | | 00:08 068 | PresentationIntentType | CS | | 00:08 070 | Fabricante | LO | | 00:08 080 | InstitutionName | LO | | 00:08 082 | InstitutionCodeSequence | SQ | | 00:08:1010 | StationName | SH | | 0008103E | SeriesDescription | LO | | 0008103F | SeriesDescriptionCodeSequence | SQ | | 00:08:1040 | InstitutionalDepartmentName | LO | | 00:08:1041 | InstitutionalDepartmentTypeCodeSequence | SQ | | 00:08:1050 | PerformingPhysicianName | PN | | 00:08:1070 | OperatorsName | PN | | 00:08:1090 | ManufacturerModelName | LO | | 00:18:0010 | ContrastBolusAgent | LO | | 00:18:0015 | BodyPartExamined | CS | | 00:18:0050 | SliceThickness | DS | | 00:18:0088 | SpacingBetweenSlices | DS | | 00:18:1000 | DeviceSerialNumber | LO | | 00:18:10.16 | SecondaryCaptureDeviceManufacturer | LO | | 00:18:1018 | SecondaryCaptureDeviceManufacturerModelName | LO | | 00:18:1019 | SecondaryCaptureDeviceSoftwareVersions | LO | | 00:18:10.20 | SoftwareVersions | LO | | 00:18:10.30 | ProtocolName | LO | | 00:18:10.50 | SpatialResolution | DS | | 00:18:1200 | DateOfLastCalibration | DA | | 00:18:1201 | TimeOfLastCalibration | TM | | 00:18:5100 | PatientPosition | CS | | 0020000D | StudyInstanceUID | Interface do usuário | | 0020000E | SeriesInstanceUID | Interface do usuário | | 00200011 | SeriesNumber | IS | | 0020:052 | FrameOfReferenceUID | Interface do usuário | | 00:20:060 | Lateralidade | CS | | 00:20:209 | NumberOfSeriesRelatedInstances | IS | | 00540081 | NumberOfSlices | EUA | | 00540101 | NumberOfTimeSlices | EUA | | 00:54.1000 | SeriesType | CS | #### Nível da instância (includefield=all) No nível da instância, `includefield=all` retorna os metadados DICOM completos no nível da instância. Isso inclui todos os atributos armazenados nos metadados da instância armazenados HealthImaging. Cada tag DICOM presente no arquivo DICOM original dessa instância é retornada, exceto o atributo de dados de pixel. **Topics** + [APIs de pesquisa DICOMWeb para HealthImaging](#dicomweb-search-services) + [Tipos de consulta DICOMWeb suportados para HealthImaging](#dicomweb-query-types) + [Usando IncludeField em QIDO-RS consultas](#dicomweb-includefield) + [Pesquisando estudos DICOM em HealthImaging](dicomweb-search-studies.md) + [Pesquisando a série DICOM em HealthImaging](dicomweb-search-series.md) + [Pesquisando instâncias DICOM em HealthImaging](dicomweb-search-instances.md)