Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mencari data DICOM di HealthImaging
<a name="dicomweb-search"></a>

AWS HealthImaging menawarkan representasi QIDO-RS API [DicomWeb](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) untuk mencari studi, seri, dan instance berdasarkan ID Pasien, dan menerima pengenal uniknya untuk penggunaan lebih lanjut. HealthImaging QIDO-RS API DicomWeb menawarkan fleksibilitas dalam cara Anda mencari data yang disimpan HealthImaging dan menyediakan interoperabilitas dengan aplikasi lama.

**Penting:**  
HealthImagingAPI DicomWeb dapat digunakan untuk mengembalikan informasi kumpulan gambar dengan. QIDO-RS HealthImaging API DicomWeb hanya mereferensikan [kumpulan gambar](getting-started-concepts.md#concept-image-set) utama kecuali dinyatakan lain. Gunakan [tindakan bawaan HealthImaging cloud,](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) atau parameter kumpulan gambar opsional dari tindakan DicomWeb untuk mengambil kumpulan gambar non-primer. HealthImagingAPI DicomWeb dapat digunakan untuk mengembalikan informasi kumpulan gambar dengan DICOMweb-conformant tanggapan.  
 HealthImaging QIDO-RS Tindakan DicomWeb dapat mengembalikan maksimal 10.000 catatan. [Jika ada lebih dari 10.000 sumber daya, mereka tidak akan dapat diambil melalui QIDO-RS tindakan, tetapi dapat diambil melalui tindakan DicomWeb atau WADO-RS tindakan asli cloud.](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)   
API yang tercantum di bagian ini dibangun sesuai dengan standar DicomWeb (QIDO-RS) untuk pencitraan medis berbasis web. Mereka tidak ditawarkan melalui AWS CLI dan AWS SDK.

## API pencarian DicomWeb untuk HealthImaging
<a name="dicomweb-search-services"></a>

Tabel berikut menjelaskan semua HealthImaging representasi QIDO-RS API DicomWeb yang tersedia untuk mencari data di. HealthImaging


**HealthImaging representasi API DicomWeb QIDO-RS**  

| Nama | Deskripsi | 
| --- | --- | 
| SearchDICOMStudies | Cari studi DICOM HealthImaging dengan menentukan elemen kueri pencarian menggunakan permintaan GET. Hasil pencarian studi dikembalikan dalam format JSON, diurutkan berdasarkan pembaruan terakhir, tanggal turun (terbaru ke terlama). Lihat [Cari studi](dicomweb-search-studies.md). | 
| SearchDICOMSeries | Cari seri DICOM HealthImaging dengan menentukan elemen kueri penelusuran menggunakan permintaan GET. Hasil pencarian seri dikembalikan dalam format JSON, diurutkan berdasarkan Series Number (0020, 0011) urutan menaik (tertua hingga terbaru). Lihat [Cari seri](dicomweb-search-series.md). | 
| SearchDICOMInstances | Cari instance DICOM HealthImaging dengan menentukan elemen kueri penelusuran menggunakan permintaan GET. Hasil pencarian instance dikembalikan dalam format JSON, diurutkan berdasarkan Instance Number (0020, 0013) urutan menaik (tertua hingga terbaru). Lihat [Cari contoh](dicomweb-search-instances.md). | 

## Jenis kueri DicomWeb yang didukung untuk HealthImaging
<a name="dicomweb-query-types"></a>

HealthImaging mendukung kueri sumber daya QIDO-RS hierarkis di tingkat Study, Series, dan SOP Instance. Saat menggunakan pencarian QIDO-RS hierarkis untuk HealthImaging:
+ Mencari studi mengembalikan daftar Studi
+ Mencari Seri Studi membutuhkan yang diketahui `StudyInstanceUID` dan mengembalikan daftar Seri
+ Mencari daftar Instans membutuhkan yang diketahui `StudyInstanceUID` dan `SeriesInstanceUID`

Tabel berikut menjelaskan jenis kueri QIDO-RS hierarkis yang didukung untuk mencari data di HealthImaging.


**HealthImaging jenis QIDO-RS kueri yang didukung**  

| Jenis kueri | Contoh | 
| --- | --- | 
| Kueri nilai atribut | Cari semua seri dalam Studi di mana`modality=CT`.<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`<br />Cari semua studi di mana ID pasien dan tanggal studi adalah nilai-nilai ini, masing-masing.<br />`…/studies?PatientID=11235813&StudyDate=20130509` | 
| Kueri kata kunci | Cari semua seri menggunakan `SeriesInstanceUID` kata kunci.<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` | 
| Kueri tag | Cari tag menggunakan parameter kueri yang diteruskan dalam group/element formulir.<br />{group} {element} seperti 0020000D | 
| Rentang kueri | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | 
| Hasil paging dengan limit dan offset | `.../studies?limit=1&offset=0&00080020=20000101`<br />Anda dapat menggunakan parameter limit dan offset untuk membuat paginasi respons pencarian. Nilai default limit adalah 1000, dan lihat [HealthImaging Titik akhir dan kuota AWS](endpoints-quotas.md) untuk nilai maksimum.<br />Batas maks = 1000, Max offset = 9000 | 
| Kueri wildcard | Kueri wildcard memberikan lebih banyak fleksibilitas pada pencarian menggunakan “\*” dan “?”. “\*” cocok dengan urutan karakter apa pun (termasuk nilai panjang nol) dan “?” cocok dengan karakter tunggal apa pun.<br />Cari semua studi di datastore yang StudyDescription berisi “Nuklir”:<br />`.../studies?StudyDescription=*Nuclear*`<br />Cari semua studi yang StudyDescription diakhiri dengan “Nuklir”:<br />`.../studies?StudyDescription=*Nuclear`<br />Cari semua studi di mana StudyDescription dimulai dengan “Nuklir”:<br />`.../studies?StudyDescription=Nuclear*`<br />Cari semua studi di mana PatientID memiliki persis 3 karakter setelah 200965981:<br />`.../studies?PatientID=200965981???` | 
| FuzzyMatching kueri | Aktifkan pencocokan fuzzy pada atribut DICOM nama ((0010.0010), PatientName ReferringPhysicianName (0008.0090)) dengan menambahkan parameter kueri opsional fuzzymatching:<br />`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`<br />Kueri ini melakukan pencocokan kata awalan case-insensitive pada bagian mana pun dari nilai. PatientName Ia mengembalikan hasil dengan PatientName nilai-nilai seperti “thomas”, “Albert”, “Thomas Albert”, “Thomas^Albert”, tetapi tidak “hom” atau “ber”. | 
| IncludeField kueri | Gunakan parameter `includefield` kueri untuk meminta atribut DICOM tambahan di luar set respons default.<br />Kembalikan atribut tertentu dengan tag:<br />`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`<br />Kembalikan semua atribut yang tersedia:<br />`.../studies?PatientID=11235813&includefield=all`<br />Sub-atribut urutan kembali (SQ) menggunakan notasi putus-putus:<br />`.../studies?PatientID=11235813&includefield=00080096.00080100`<br />Kembalikan elemen data pribadi:<br />`.../instances?includefield=00191001&00190010=Philips` | 

## Menggunakan IncludeField dalam QIDO-RS kueri
<a name="dicomweb-includefield"></a>

Parameter `includefield` kueri memungkinkan Anda meminta atribut DICOM tambahan di luar respons default yang ditetapkan dalam HealthImaging QIDO-RS kueri. Anda dapat menggunakan `includefield` di tingkat studi, seri, dan contoh.

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

Gunakan format permintaan GET berikut untuk menyertakan bidang tambahan dalam QIDO-RS kueri Anda:

```
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>
```

Anda dapat menentukan beberapa `includefield` parameter dalam satu permintaan:

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

### Nilai yang didukung untuk includefield
<a name="dicomweb-includefield-values"></a>

Tabel berikut menjelaskan nilai yang didukung untuk `includefield` parameter.


**Nilai includefield yang didukung**  

| Tipe nilai | Deskripsi | Contoh | 
| --- | --- | --- | 
| Tag DICOM (8 karakter hex) | Minta atribut DICOM tertentu dengan tagnya dalam format GGGGEEEE. | includefield=00081030 | 
| all | Minta semua atribut DICOM yang tersedia untuk tingkat sumber daya. | includefield=all | 
| Jalur SQ bertitik | <parent\_tag>Minta sub-atribut tertentu dalam atribut Sequence (SQ) menggunakan notasi titik:. <child\_tag>. | includefield=00080096.00080100 | 
| Tag elemen data pribadi | Minta tag pribadi (elemen grup ganjil). Membutuhkan privateCreatorElement parameter. | includefield=00191001 | 
| Atribut DICOM standar termasuk bulkdata | Minta atribut tunggal atau beberapa tertentu dengan tag atau kata kunci. | includefield=00102201 | 

### Perilaku dan aturan
<a name="dicomweb-includefield-behavior"></a>

Aturan berikut berlaku untuk `includefield` kueri:
+ **Respons default** - Tanpa`includefield`, QIDO-RS respons hanya mengembalikan set atribut standar.
+ **includefield=all — Mengembalikan semua atribut** yang tersedia pada tingkat yang diminta. Ketika `all` dikombinasikan dengan `includefield` nilai-nilai lain, `all` mengambil prioritas.
+ **Tag maksimum** — Permintaan dapat mencakup hingga 50 `includefield` parameter.
+ **Tag duplikat** - `includefield` Nilai duplikat di-deduplikasi dan diperlakukan sebagai permintaan tunggal.
+ **Tag tidak valid atau hilang** — Jika tag yang diminta tidak ada dalam data DICOM atau tidak valid, tag tersebut akan dihilangkan secara diam-diam dari respons. `includefield`Atribut valid lainnya masih dikembalikan.

### Atribut urutan (SQ)
<a name="dicomweb-includefield-sq"></a>

Gunakan notasi titik untuk meminta atribut bersarang dalam atribut Sequence (SQ):

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

Misalnya, untuk mengambil CodeValue (0008.0100) dalam ReferringPhysicianIdentificationSequence (0008.0096):

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

Multi-level bersarang didukung. Contoh:

```
includefield=00081115.00081199.00081150
```

### Tag pribadi
<a name="dicomweb-includefield-private"></a>

Elemen data DICOM pribadi (tag grup ganjil) didukung di semua tingkat sumber daya. Untuk meminta tag pribadi, sertakan parameter `privateCreatorElement` kueri.

Gunakan sintaks berikut:

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

Contoh:

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

Aturan berikut berlaku untuk tag pribadi:
+ `privateCreatorElement`Tag dan nama pembuat harus disediakan sebagai parameter kecocokan jika tag pribadi diminta.
+ Jika yang `privateCreatorElement` ditentukan tidak ditemukan, tag pribadi dihilangkan secara diam-diam.
+ Meminta hanya `privateCreatorElement` tag tanpa elemen data pribadi mengembalikan nama elemen pencipta dan nilai saja. Itu tidak mengembalikan semua tag milik blok pembuat itu.

### Tag Bulkdata
<a name="dicomweb-includefield-bulkdata"></a>

Atribut DICOM dengan bulkdata VR (OB, OD, OF, OL, UN, OW, OV) dengan nilai biner lebih besar dari 1 MB yang diminta sebagai bagian dari dikembalikan sebagai `bulkdataURI` pengganti nilai biner mentah. `includefield` Untuk informasi selengkapnya tentang mengambil bulkdata, lihat [Mengambil](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html) bulkdata DICOM di. HealthImaging

### Apa yang dikembalikan includefield=all di setiap level?
<a name="dicomweb-includefield-all-levels"></a>

Kapan `includefield=all` ditentukan, respons mencakup semua atribut pada tingkat sumber daya tertentu.

#### Tingkat studi (includefield=all)
<a name="dicomweb-includefield-all-study"></a>

Tabel berikut mencantumkan semua atribut yang dikembalikan pada tingkat studi ketika `includefield=all` ditentukan.


**Atribut tingkat studi untuk includefield=all**  

| Tag | Nama | VR | 
| --- | --- | --- | 
| 00080005 | SpecificCharacterSet | CS | 
| 00080020 | StudyDate | DA | 
| 00080030 | StudyTime | TM | 
| 00080050 | AccessionNumber | SH | 
| 00080051 | IssuerOfAccessionNumberSequence | PERSEGI | 
| 00080056 | InstanceAvailability | CS | 
| 00080061 | ModalitiesInStudy | CS | 
| 00080062 | SOPClassesInStudy | UI | 
| 00080090 | ReferringPhysicianName | PN | 
| 0008009C | ConsultingPhysicianName | PN | 
| 00080201 | TimezoneOffsetFromUTC | SH | 
| 00081030 | StudyDescription | LIHATLAH | 
| 00081048 | PhysiciansOfRecord | PN | 
| 00081060 | NameOfPhysiciansReadingStudy | PN | 
| 00081080 | AdmittingDiagnosesDescription | LIHATLAH | 
| 00081190 | RetrieveUrl | UR | 
| 00100010 | PatientName | PN | 
| 00100020 | PatientID | LIHATLAH | 
| 00100021 | IssuerOfPatientID | LIHATLAH | 
| 00100022 | TypeOfPatientID | CS | 
| 00100026 | SourcePatientGroupIdentificationSequence | PERSEGI | 
| 00100027 | GroupOfPatientsIdentificationSequence | PERSEGI | 
| 00100028 | SubjectRelativePositionInImage | AS | 
| 00100030 | PatientBirthDate | DA | 
| 00100032 | PatientBirthTime | TM | 
| 00100033 | PatientBirthDateInAlternativeCalendar | LIHATLAH | 
| 00100034 | PatientDeathDateInAlternativeCalendar | LIHATLAH | 
| 00100035 | PatientAlternativeCalendar | CS | 
| 00100040 | PatientSex | CS | 
| 00100050 | PatientInsurancePlanCodeSequence | PERSEGI | 
| 00100101 | PatientPrimaryLanguageCodeSequence | PERSEGI | 
| 00100102 | PatientPrimaryLanguageModifierCodeSequence | PERSEGI | 
| 00100200 | QualityControlSubject | CS | 
| 00100201 | QualityControlSubjectTypeCodeSequence | PERSEGI | 
| 00100213 | StrainNomenclature | LIHATLAH | 
| 00100214 | StrainStockNumber | LIHATLAH | 
| 00100215 | StrainSourceRegistryCodeSequence | PERSEGI | 
| 00100217 | StrainSource | LIHATLAH | 
| 00100219 | StrainCodeSequence | PERSEGI | 
| 00100223 | GeneticModificationsNomenclature | LIHATLAH | 
| 00100229 | GeneticModificationsCodeSequence | PERSEGI | 
| 00101001 | OtherPatientNames | PN | 
| 00101005 | PatientBirthName | PN | 
| 00101010 | PatientAge | AS | 
| 00101020 | PatientSize | DS | 
| 00101021 | PatientSizeCodeSequence | PERSEGI | 
| 00101022 | PatientBodyMassIndex | DS | 
| 00101023 | MeasuredapDimension | DS | 
| 00101024 | MeasuredLateralDimension | DS | 
| 00101030 | PatientWeight | DS | 
| 00101040 | PatientAddress | LIHATLAH | 
| 00101060 | PatientMotherBirthName | PN | 
| 00101080 | MilitaryRank | LIHATLAH | 
| 00101081 | BranchOfService | LIHATLAH | 
| 00102000 | MedicalAlerts | LIHATLAH | 
| 00102110 | Alergi | LIHATLAH | 
| 00102150 | CountryOfResidence | LIHATLAH | 
| 00102152 | RegionOfResidence | LIHATLAH | 
| 00102154 | PatientTelephoneNumbers | SH | 
| 00102160 | EthnicGroup | SH | 
| 00102180 | Pekerjaan | SH | 
| 001021A0 | SmokingStatus | CS | 
| 001021C0 | PregnancyStatus | AS | 
| 001021D0 | LastMenstrualDate | DA | 
| 001021F0 | PatientReligiousPreference | LIHATLAH | 
| 00102201 | PatientSpeciesDescription | LIHATLAH | 
| 00102202 | PatientSpeciesCodeSequence | PERSEGI | 
| 00102203 | PatientSexNeutered | CS | 
| 00102210 | AnatomicalOrientationType | CS | 
| 00102292 | PatientBreedDescription | LIHATLAH | 
| 00102293 | PatientBreedCodeSequence | PERSEGI | 
| 00102295 | BreedRegistrationNumber | LIHATLAH | 
| 00102296 | BreedRegistryCodeSequence | PERSEGI | 
| 00102297 | ResponsiblePerson | PN | 
| 00102298 | ResponsiblePersonRole | CS | 
| 00102299 | ResponsibleOrganization | LIHATLAH | 
| 00109431 | ExaminedBodyThickness | FL | 
| 0020000D | StudyInstanceUID | UI | 
| 00200010 | StudyID | SH | 
| 00201206 | NumberOfStudyRelatedSeries | ADALAH | 
| 00201208 | NumberOfStudyRelatedInstances | ADALAH | 
| 00321032 | RequestingPhysician | PN | 
| 00321033 | RequestingService | LIHATLAH | 
| 00321060 | RequestedProcedureDescription | LIHATLAH | 
| 00321070 | RequestedContrastAgent | LIHATLAH | 
| 00380010 | ID Penerimaan/AdmissionId | LIHATLAH | 
| 00380016 | RouteOfAdmissions | LIHATLAH | 
| 00380020 | AdmittingDate | DA | 
| 00380021 | AdmittingTime | TM | 
| 00380050 | SpecialNeeds | LIHATLAH | 
| 00380060 | ServiceEpisodeID | LIHATLAH | 
| 00380062 | ServiceEpisodeDescription | LIHATLAH | 
| 00380300 | CurrentPatientLocation | LIHATLAH | 
| 00380400 | PatientInstitutionResidence | LIHATLAH | 
| 00380500 | PatientState | LIHATLAH | 
| 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 | 

#### Tingkat seri (includefield=all)
<a name="dicomweb-includefield-all-series"></a>

Tabel berikut mencantumkan atribut tingkat seri yang dikembalikan saat `includefield=all` ditentukan. Tingkat seri juga mengembalikan semua atribut tingkat studi yang tercantum dalam tabel sebelumnya.


**Atribut tingkat seri untuk includefield=all**  

| Tag | Nama | VR | 
| --- | --- | --- | 
| 00080021 | SeriesDate | DA | 
| 00080031 | SeriesTime | TM | 
| 00080060 | Modalitas | CS | 
| 00080064 | ConversionType | CS | 
| 00080068 | PresentationIntentType | CS | 
| 00080070 | Pabrikan | LIHATLAH | 
| 00080080 | InstitutionName | LIHATLAH | 
| 00080082 | InstitutionCodeSequence | SQ | 
| 00081010 | StationName | SH | 
| 0008103E | SeriesDescription | LIHATLAH | 
| 0008103F | SeriesDescriptionCodeSequence | SQ | 
| 00081040 | InstitutionalDepartmentName | LIHATLAH | 
| 00081041 | InstitutionalDepartmentTypeCodeSequence | SQ | 
| 00081050 | PerformingPhysicianName | PN | 
| 00081070 | OperatorsName | PN | 
| 00081090 | ManufacturerModelName | LIHATLAH | 
| 00180010 | ContrastBolusAgent | LIHATLAH | 
| 00180015 | BodyPartExamined | CS | 
| 00180050 | SliceThickness | DS | 
| 00180088 | SpacingBetweenSlices | DS | 
| 00181000 | DeviceSerialNumber | LIHATLAH | 
| 00181016 | SecondaryCaptureDeviceManufacturer | LIHATLAH | 
| 00181018 | SecondaryCaptureDeviceManufacturerModelName | LIHATLAH | 
| 00181019 | SecondaryCaptureDeviceSoftwareVersions | LIHATLAH | 
| 00181020 | SoftwareVersions | LIHATLAH | 
| 00181030 | ProtocolName | LIHATLAH | 
| 00181050 | SpatialResolution | DS | 
| 00181200 | DateOfLastCalibration | DA | 
| 00181201 | TimeOfLastCalibration | TM | 
| 00185100 | PatientPosition | CS | 
| 0020000D | StudyInstanceUID | UI | 
| 0020000E | SeriesInstanceUID | UI | 
| 00200011 | SeriesNumber | ADALAH | 
| 00200052 | FrameOfReferenceUID | UI | 
| 00200060 | Lateralitas | CS | 
| 00201209 | NumberOfSeriesRelatedInstances | ADALAH | 
| 00540081 | NumberOfSlices | AS | 
| 00540101 | NumberOfTimeSlices | AS | 
| 00541000 | SeriesType | CS | 

#### Tingkat instans (includefield=all)
<a name="dicomweb-includefield-all-instance"></a>

Pada tingkat instance, `includefield=all` mengembalikan metadata DICOM tingkat instance penuh. Ini termasuk semua atribut yang disimpan dalam metadata instance dalam HealthImaging penyimpanan. Setiap tag DICOM yang ada dalam file DICOM asli untuk instance itu dikembalikan, kecuali atribut data piksel.

**Topics**
+ [API pencarian DicomWeb untuk HealthImaging](#dicomweb-search-services)
+ [Jenis kueri DicomWeb yang didukung untuk HealthImaging](#dicomweb-query-types)
+ [Menggunakan IncludeField dalam QIDO-RS kueri](#dicomweb-includefield)
+ [Mencari studi DICOM di HealthImaging](dicomweb-search-studies.md)
+ [Mencari seri DICOM di HealthImaging](dicomweb-search-series.md)
+ [Mencari instance DICOM di HealthImaging](dicomweb-search-instances.md)