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

# Mengakses set gambar dengan AWS HealthImaging
<a name="accessing-image-sets"></a>

Mengakses data pencitraan medis di AWS HealthImaging biasanya melibatkan pencarian [kumpulan gambar](getting-started-concepts.md#concept-image-set) dengan kunci unik dan mendapatkan [metadata](getting-started-concepts.md#concept-metadata) dan [bingkai gambar](getting-started-concepts.md#concept-image-frame) terkait (data piksel).

**Penting:**  
Selama impor, HealthImaging memproses binari instance DICOM (`.dcm`file) dan mengubahnya menjadi kumpulan gambar. Gunakan [tindakan bawaan HealthImaging cloud](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html) (APIs) untuk mengelola penyimpanan data dan kumpulan gambar. Gunakan HealthImaging [representasi DICOMweb layanan](dicomweb-retrieve.md) untuk mengembalikan DICOMweb respons.

Topik berikut menjelaskan cara menggunakan tindakan asli HealthImaging cloud di Konsol Manajemen AWS, AWS CLI, dan AWS SDKs untuk mencari kumpulan gambar dan mendapatkan properti, metadata, dan bingkai gambar terkait.

**Topics**
+ [Memahami set gambar](understanding-image-sets.md)
+ [Mencari set gambar](search-image-sets.md)
+ [Mendapatkan properti set gambar](get-image-set-properties.md)
+ [Mendapatkan metadata set gambar](get-image-set-metadata.md)
+ [Mendapatkan data piksel set gambar](get-image-frame.md)

# Memahami set gambar
<a name="understanding-image-sets"></a>

Kumpulan gambar adalah AWS yang menyerupai Seri DICOM, dan berfungsi sebagai dasar untuk AWS HealthImaging. Kumpulan gambar dibuat saat Anda mengimpor data DICOM Anda ke dalam HealthImaging. Layanan ini mencoba untuk mengatur data P10 yang diimpor sesuai dengan hierarki DICOM Studi, Seri, dan Instance.

Kumpulan gambar diperkenalkan karena alasan berikut:
+  Mendukung berbagai macam alur kerja pencitraan medis (klinis dan nonklinis) melalui fleksibel. APIs 
+  Menyediakan mekanisme untuk menyimpan dan merekonsiliasi data duplikat dan tidak konsisten secara tahan lama. Data P10 yang diimpor yang bertentangan dengan kumpulan gambar utama yang sudah ada di toko akan dipertahankan sebagai non-primer. Setelah menyelesaikan konflik metadata, data dapat dibuat primer. 
+  Maksimalkan keselamatan pasien dengan mengelompokkan hanya data terkait.
+  Dorong data untuk dibersihkan untuk membantu meningkatkan visibilitas inkonsistensi. Untuk informasi selengkapnya, lihat [Memodifikasi set gambar](modifying-image-sets.md). 
**Penting:**  
Penggunaan klinis data DICOM sebelum dibersihkan dapat mengakibatkan kerusakan pasien.

Menu berikut menjelaskan kumpulan gambar secara lebih rinci dan memberikan contoh dan diagram untuk membantu Anda memahami fungsionalitas dan tujuannya. HealthImaging

## Apa itu set gambar?
<a name="what-is-image-set"></a>

Kumpulan gambar adalah AWS konsep yang mendefinisikan mekanisme pengelompokan abstrak untuk mengoptimalkan data pencitraan medis terkait yang sangat mirip dengan Seri DICOM. Saat Anda mengimpor data pencitraan DICOM P10 ke penyimpanan HealthImaging data AWS, data tersebut diubah menjadi kumpulan gambar yang terdiri dari [metadata](getting-started-concepts.md#concept-metadata) dan bingkai [gambar](getting-started-concepts.md#concept-image-frame) (data piksel). 

**catatan**  
[Metadata set gambar dinormalisasi.](metadata-normalization.md) Dengan kata lain, satu set atribut dan nilai umum dipetakan ke elemen tingkat Pasien, Studi, dan Seri yang tercantum dalam [Registry of DICOM Data Elements](https://dicom.nema.org/medical/dicom/2022b/output/html/part06.html#table_6-1). HealthImaging menggunakan elemen DICOM berikut saat mengelompokkan objek DICOM P10 yang masuk ke dalam kumpulan gambar.  


**Elemen DICOM yang digunakan untuk pembuatan set gambar**  
<a name="table-dicom-elements-image-set"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/healthimaging/latest/devguide/understanding-image-sets.html)
Selama impor, beberapa set gambar mempertahankan pengkodean sintaks transfer aslinya, sementara yang lain ditranskode ke High-Throughput JPEG 2000 (K) lossless secara default. HTJ2 Jika kumpulan gambar dikodekan dalam HTJ2 K, itu harus diterjemahkan sebelum dilihat. Untuk informasi selengkapnya, lihat [Sintaks transfer yang didukung](supported-transfer-syntaxes.md) dan [Pustaka decoding bingkai gambar](reference-libraries.md).  
[Bingkai gambar (data piksel) dikodekan dalam High-Throughput JPEG 2000 (HTJ2K) dan harus diterjemahkan sebelum dilihat.](reference-libraries.md)

Kumpulan gambar adalah AWS sumber daya, sehingga mereka diberi [Nama Sumber Daya Amazon (ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). Mereka dapat ditandai dengan hingga 50 pasangan nilai kunci dan diberikan [kontrol akses berbasis peran (RBAC) dan kontrol akses berbasis [atribut](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) (ABAC) melalui](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) IAM. Selain itu, kumpulan gambar [diberi versi](list-image-set-versions.md), sehingga semua perubahan dipertahankan dan versi sebelumnya dapat diakses.

Mengimpor data DICOM P10 menghasilkan kumpulan gambar yang berisi metadata DICOM dan bingkai gambar untuk satu atau beberapa instance Service-Object Pair (SOP) dalam Seri DICOM yang sama.

![\[Diagram yang menunjukkan kumpulan gambar di AWS HealthImaging.\]](http://docs.aws.amazon.com/id_id/healthimaging/latest/devguide/images/image-set-what-is.png)


**catatan**  
Pekerjaan impor DICOM:  
Selalu buat set gambar baru atau naikkan versi set gambar yang ada.
Jangan deduplikat penyimpanan Instance SOP. Setiap impor Instance SOP yang sama menggunakan penyimpanan tambahan sebagai kumpulan gambar non-primer baru, atau versi tambahan dari kumpulan gambar utama yang ada.
Secara otomatis mengatur instans SOP dengan metadata yang konsisten dan tidak bertentangan sebagai kumpulan gambar utama, yang berisi instance dengan elemen metadata Pasien, Studi, dan Seri yang konsisten.  
Jika instance yang terdiri dari seri DICOM diimpor dalam dua atau lebih pekerjaan impor, dan instance tidak bertentangan dengan instance yang sudah ada di penyimpanan data, maka semua instance akan diatur dalam satu set gambar Primer.
Buat kumpulan gambar non-primer yang berisi data DICOM P10 yang bertentangan dengan kumpulan gambar utama yang sudah ada di penyimpanan data.
Pertahankan data yang paling baru diterima sebagai versi terbaru dari kumpulan gambar utama.  
Jika instance yang terdiri dari seri DICOM adalah kumpulan gambar utama, dan satu instance diimpor lagi, salinan baru akan dimasukkan ke dalam kumpulan gambar utama, dan versi akan bertambah.

## Seperti apa tampilan metadata set gambar?
<a name="what-does-image-set-look-like"></a>

Gunakan `GetImageSetMetadata` tindakan untuk mengambil metadata set gambar. Metadata yang dikembalikan dikompresi dengan`gzip`, jadi Anda harus membuka ritsletingnya sebelum melihat. Untuk informasi selengkapnya, lihat [Mendapatkan metadata set gambar](get-image-set-metadata.md).

Contoh berikut menunjukkan struktur [metadata](getting-started-concepts.md#concept-metadata) set gambar dalam format JSON.

```
{
	"SchemaVersion": "1.1",
	"DatastoreID": "2aa75d103f7f45ab977b0e93f00e6fe9",
	"ImageSetID": "46923b66d5522e4241615ecd64637584",
	"Patient": {
		"DICOM": {
			"PatientBirthDate": null,
			"PatientSex": null,
			"PatientID": "2178309",
			"PatientName": "MISTER^CT"
		}
	},
	"Study": {
		"DICOM": {
			"StudyTime": "083501",
			"PatientWeight": null
		},
		"Series": {
			"1.2.840.113619.2.30.1.1762295590.1623.978668949.887": {
				"DICOM": {
				    "Modality": "CT",
					"PatientPosition": "FFS"
				},
				"Instances": {
					"1.2.840.113619.2.30.1.1762295590.1623.978668949.888": {
						"DICOM": {
							"SourceApplicationEntityTitle": null,
							"SOPClassUID": "1.2.840.10008.5.1.4.1.1.2",
							"HighBit": 15,
							"PixelData": null,
							"Exposure": "40",
							"RescaleSlope": "1",
						"ImageFrames": [
							{
								"ID": "0d1c97c51b773198a3df44383a5fd306",
								"PixelDataChecksumFromBaseToFullResolution": [
									{
										"Width": 256,
										"Height": 188,
										"Checksum": 2598394845
									},
									{
										"Width": 512,
										"Height": 375,
										"Checksum": 1227709180
									}
								],
								"MinPixelValue": 451,
								"MaxPixelValue": 1466,
								"FrameSizeInBytes": 384000
							}
						]
					}
				}
			}
		}
	}
}
```

## Contoh pembuatan set gambar: beberapa pekerjaan impor
<a name="example-creation-multiple-import-jobs"></a>

Contoh berikut menunjukkan bagaimana beberapa pekerjaan impor selalu membuat set gambar baru dan *tidak pernah* menambahkan ke yang sudah ada.

![\[Diagram yang menunjukkan seperti apa beberapa pekerjaan impor set gambar HealthImaging.\]](http://docs.aws.amazon.com/id_id/healthimaging/latest/devguide/images/image-set-example-multiple-import-jobs.png)


## Contoh pembuatan set gambar: pekerjaan impor tunggal dengan dua varian
<a name="example-creation-two-variants"></a>

Contoh berikut menunjukkan pekerjaan impor tunggal yang akan gagal digabungkan menjadi satu set gambar karena instance 1 dan 3 memiliki Pasien yang berbeda IDs dari instance 2 dan 4. Untuk mengatasi hal ini, Anda dapat menggunakan `UpdateImageSetMetadata` tindakan untuk menyelesaikan konflik ID Pasien dengan set gambar Primer yang ada. Setelah konflik diselesaikan, Anda dapat menggunakan `CopyImageSet` tindakan dengan argumen `--promoteToPrimary` untuk menambahkan gambar yang disetel ke kumpulan gambar Primer.

![\[Diagram yang menunjukkan seperti apa dua varian kumpulan gambar dalam HealthImaging menggunakan satu pekerjaan impor.\]](http://docs.aws.amazon.com/id_id/healthimaging/latest/devguide/images/image-set-example-import-two-variants.png)


## Contoh pembuatan set gambar: pekerjaan impor tunggal dengan pengoptimalan
<a name="example-creation-optimization"></a>

Contoh berikut menunjukkan pekerjaan impor tunggal yang membuat dua set gambar untuk meningkatkan throughput, meskipun nama pasien cocok. 

![\[Diagram yang menunjukkan seperti apa optimasi set gambar dalam HealthImaging menggunakan satu pekerjaan impor.\]](http://docs.aws.amazon.com/id_id/healthimaging/latest/devguide/images/image-set-example-optimization.png)


# Mencari set gambar
<a name="search-image-sets"></a>

Gunakan `SearchImageSets` tindakan untuk menjalankan kueri penelusuran terhadap semua [kumpulan gambar](getting-started-concepts.md#concept-image-set) di penyimpanan `ACTIVE` HealthImaging data. Menu berikut memberikan prosedur untuk contoh Konsol Manajemen AWS dan kode untuk AWS CLI dan AWS SDKs. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_SearchImageSets.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_SearchImageSets.html)di *AWS HealthImaging API Referensi*.

**catatan**  
Ingatlah poin-poin berikut saat mencari set gambar.  
`SearchImageSets`menerima parameter kueri penelusuran tunggal dan mengembalikan respons paginasi dari semua kumpulan gambar yang memiliki kriteria pencocokan. Semua kueri rentang tanggal harus dimasukkan sebagai`(lowerBound, upperBound)`.
Secara default, `SearchImageSets` gunakan `updatedAt` bidang untuk menyortir dalam urutan menurun dari yang terbaru ke yang terlama.
Jika Anda membuat penyimpanan data dengan AWS KMS kunci milik pelanggan, Anda harus memperbarui kebijakan AWS KMS kunci sebelum berinteraksi dengan kumpulan gambar. Untuk informasi selengkapnya, lihat [Membuat kunci terkelola pelanggan](data-encryption.md#creating-co-cmk).

**Untuk mencari set gambar**  
Pilih menu berdasarkan preferensi akses Anda ke AWS HealthImaging.

## AWS Konsol
<a name="code-example-console-image-set-search"></a>

**catatan**  
Prosedur berikut menunjukkan cara mencari set gambar menggunakan filter `Series Instance UID` dan `Updated at` properti.

------
#### [ Series Instance UID ]

**Cari set gambar menggunakan filter `Series Instance UID` properti**

1. Buka [halaman HealthImaging Console Data Stores](https://console.aws.amazon.com/medical-imaging/home#/dataStores).

1. Pilih penyimpanan data.

   Halaman **detail penyimpanan data** terbuka dan tab **Image sets** dipilih secara default.

1. Pilih menu filter properti dan pilih`Series Instance UID`.

1. Di kolom **Masukkan nilai untuk dicari**, masukkan (tempel) UID Instans Seri yang menarik.
**catatan**  
Nilai UID Instance Seri harus identik dengan yang tercantum dalam [Registry of DICOM Unique Identifiers](https://dicom.nema.org/dicom/2013/output/chtml/part06/chapter_A.html) (). UIDs Perhatikan persyaratan termasuk serangkaian angka yang berisi setidaknya satu periode di antara mereka. Periode tidak diperbolehkan pada awal atau akhir Instans Seri UIDs. Huruf dan spasi putih tidak diperbolehkan, jadi berhati-hatilah saat menyalin dan menempelkan UIDs.

1. Pilih menu **Rentang tanggal**, pilih rentang tanggal untuk UID Instans Seri, dan pilih **Terapkan**.

1. Pilih **Cari**.

   Instance Seri UIDs yang termasuk dalam rentang tanggal yang dipilih dikembalikan dalam urutan Terbaru secara default.

------
#### [ Updated at ]

**Cari set gambar menggunakan filter `Updated at` properti**

1. Buka [halaman HealthImaging Console Data Stores](https://console.aws.amazon.com/medical-imaging/home#/dataStores).

1. Pilih penyimpanan data.

   Halaman **detail penyimpanan data** terbuka dan tab **Image sets** dipilih secara default.

1. Pilih menu filter properti dan pilih`Updated at`.

1. Pilih menu **Rentang tanggal**, pilih rentang tanggal yang ditetapkan gambar, dan pilih **Terapkan**.

1. Pilih **Cari**.

   Kumpulan gambar yang termasuk dalam rentang tanggal yang dipilih dikembalikan dalam urutan Terbaru secara default.

------

## AWS CLI dan SDKs
<a name="code-example-cli-sdk-image-set-search"></a>

------
#### [ C\$1\$1 ]

**SDK untuk C\$1\$1**  
Fungsi utilitas untuk mencari set gambar.  

```
//! Routine which searches for image sets based on defined input attributes.
/*!
  \param dataStoreID: The HealthImaging data store ID.
  \param searchCriteria: A search criteria instance.
  \param imageSetResults: Vector to receive the image set IDs.
  \param clientConfig: Aws client configuration.
  \return bool: Function succeeded.
  */
bool AwsDoc::Medical_Imaging::searchImageSets(const Aws::String &dataStoreID,
                                              const Aws::MedicalImaging::Model::SearchCriteria &searchCriteria,
                                              Aws::Vector<Aws::String> &imageSetResults,
                                              const Aws::Client::ClientConfiguration &clientConfig) {
    Aws::MedicalImaging::MedicalImagingClient client(clientConfig);
    Aws::MedicalImaging::Model::SearchImageSetsRequest request;
    request.SetDatastoreId(dataStoreID);
    request.SetSearchCriteria(searchCriteria);

    Aws::String nextToken; // Used for paginated results.
    bool result = true;
    do {
        if (!nextToken.empty()) {
            request.SetNextToken(nextToken);
        }

        Aws::MedicalImaging::Model::SearchImageSetsOutcome outcome = client.SearchImageSets(
                request);
        if (outcome.IsSuccess()) {
            for (auto &imageSetMetadataSummary: outcome.GetResult().GetImageSetsMetadataSummaries()) {
                imageSetResults.push_back(imageSetMetadataSummary.GetImageSetId());
            }

            nextToken = outcome.GetResult().GetNextToken();
        }
        else {
            std::cout << "Error: " << outcome.GetError().GetMessage() << std::endl;
            result = false;
        }
    } while (!nextToken.empty());

    return result;
}
```
Kasus penggunaan \$11: operator EQUAL.  

```
        Aws::Vector<Aws::String> imageIDsForPatientID;
        Aws::MedicalImaging::Model::SearchCriteria searchCriteriaEqualsPatientID;
        Aws::Vector<Aws::MedicalImaging::Model::SearchFilter> patientIDSearchFilters = {
                Aws::MedicalImaging::Model::SearchFilter().WithOperator(Aws::MedicalImaging::Model::Operator::EQUAL)
                .WithValues({Aws::MedicalImaging::Model::SearchByAttributeValue().WithDICOMPatientId(patientID)})
        };

        searchCriteriaEqualsPatientID.SetFilters(patientIDSearchFilters);
        bool result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
                                                               searchCriteriaEqualsPatientID,
                                                               imageIDsForPatientID,
                                                               clientConfig);
        if (result) {
            std::cout << imageIDsForPatientID.size() << " image sets found for the patient with ID '"
            <<  patientID << "'." << std::endl;
            for (auto &imageSetResult : imageIDsForPatientID) {
                std::cout << "  Image set with ID '" << imageSetResult << std::endl;
            }
        }
```
Kasus penggunaan \$12: ANTARA operator menggunakan DICOMStudy Tanggal dan DICOMStudy Waktu.   

```
         Aws::MedicalImaging::Model::SearchByAttributeValue useCase2StartDate;
        useCase2StartDate.SetDICOMStudyDateAndTime(Aws::MedicalImaging::Model::DICOMStudyDateAndTime()
        .WithDICOMStudyDate("19990101")
        .WithDICOMStudyTime("000000.000"));

        Aws::MedicalImaging::Model::SearchByAttributeValue useCase2EndDate;
        useCase2EndDate.SetDICOMStudyDateAndTime(Aws::MedicalImaging::Model::DICOMStudyDateAndTime()
        .WithDICOMStudyDate(Aws::Utils::DateTime(std::chrono::system_clock::now()).ToLocalTimeString("%Y%m%d"))
        .WithDICOMStudyTime("000000.000"));

        Aws::MedicalImaging::Model::SearchFilter useCase2SearchFilter;
        useCase2SearchFilter.SetValues({useCase2StartDate, useCase2EndDate});
        useCase2SearchFilter.SetOperator(Aws::MedicalImaging::Model::Operator::BETWEEN);

        Aws::MedicalImaging::Model::SearchCriteria useCase2SearchCriteria;
        useCase2SearchCriteria.SetFilters({useCase2SearchFilter});

        Aws::Vector<Aws::String> usesCase2Results;
        result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
                                                          useCase2SearchCriteria,
                                                          usesCase2Results,
                                                          clientConfig);
        if (result) {
            std::cout << usesCase2Results.size() << " image sets found for between 1999/01/01 and present."
                      <<  std::endl;
            for (auto &imageSetResult : usesCase2Results) {
                std::cout << "  Image set with ID '" << imageSetResult << std::endl;
            }
        }
```
Kasus penggunaan \$13: ANTARA operator menggunakan createDat. Studi waktu sebelumnya bertahan.   

```
        Aws::MedicalImaging::Model::SearchByAttributeValue useCase3StartDate;
        useCase3StartDate.SetCreatedAt(Aws::Utils::DateTime("20231130T000000000Z",Aws::Utils::DateFormat::ISO_8601_BASIC));

        Aws::MedicalImaging::Model::SearchByAttributeValue useCase3EndDate;
        useCase3EndDate.SetCreatedAt(Aws::Utils::DateTime(std::chrono::system_clock::now()));

        Aws::MedicalImaging::Model::SearchFilter useCase3SearchFilter;
        useCase3SearchFilter.SetValues({useCase3StartDate, useCase3EndDate});
        useCase3SearchFilter.SetOperator(Aws::MedicalImaging::Model::Operator::BETWEEN);

        Aws::MedicalImaging::Model::SearchCriteria useCase3SearchCriteria;
        useCase3SearchCriteria.SetFilters({useCase3SearchFilter});

        Aws::Vector<Aws::String> usesCase3Results;
        result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
                                                          useCase3SearchCriteria,
                                                          usesCase3Results,
                                                          clientConfig);
        if (result) {
            std::cout << usesCase3Results.size() << " image sets found for created between 2023/11/30 and present."
                      <<  std::endl;
            for (auto &imageSetResult : usesCase3Results) {
                std::cout << "  Image set with ID '" << imageSetResult << std::endl;
            }
        }
```
Kasus penggunaan \$14: Operator EQUAL di DICOMSeries InstanceUID dan BETWEET di UpdateDAT dan mengurutkan respons dalam urutan ASC di bidang UpdateDAT.   

```
        Aws::MedicalImaging::Model::SearchByAttributeValue useCase4StartDate;
        useCase4StartDate.SetUpdatedAt(Aws::Utils::DateTime("20231130T000000000Z",Aws::Utils::DateFormat::ISO_8601_BASIC));

        Aws::MedicalImaging::Model::SearchByAttributeValue useCase4EndDate;
        useCase4EndDate.SetUpdatedAt(Aws::Utils::DateTime(std::chrono::system_clock::now()));

        Aws::MedicalImaging::Model::SearchFilter useCase4SearchFilterBetween;
        useCase4SearchFilterBetween.SetValues({useCase4StartDate, useCase4EndDate});
        useCase4SearchFilterBetween.SetOperator(Aws::MedicalImaging::Model::Operator::BETWEEN);

        Aws::MedicalImaging::Model::SearchByAttributeValue seriesInstanceUID;
        seriesInstanceUID.SetDICOMSeriesInstanceUID(dicomSeriesInstanceUID);

        Aws::MedicalImaging::Model::SearchFilter useCase4SearchFilterEqual;
        useCase4SearchFilterEqual.SetValues({seriesInstanceUID});
        useCase4SearchFilterEqual.SetOperator(Aws::MedicalImaging::Model::Operator::EQUAL);

        Aws::MedicalImaging::Model::SearchCriteria useCase4SearchCriteria;
        useCase4SearchCriteria.SetFilters({useCase4SearchFilterBetween, useCase4SearchFilterEqual});

        Aws::MedicalImaging::Model::Sort useCase4Sort;
        useCase4Sort.SetSortField(Aws::MedicalImaging::Model::SortField::updatedAt);
        useCase4Sort.SetSortOrder(Aws::MedicalImaging::Model::SortOrder::ASC);

        useCase4SearchCriteria.SetSort(useCase4Sort);

        Aws::Vector<Aws::String> usesCase4Results;
        result = AwsDoc::Medical_Imaging::searchImageSets(dataStoreID,
                                                          useCase4SearchCriteria,
                                                          usesCase4Results,
                                                          clientConfig);
        if (result) {
            std::cout << usesCase4Results.size() << " image sets found for EQUAL operator "
            << "on DICOMSeriesInstanceUID and BETWEEN on updatedAt and sort response\n"
            <<  "in ASC order on updatedAt field." <<  std::endl;
            for (auto &imageSetResult : usesCase4Results) {
                std::cout << "  Image set with ID '" << imageSetResult << std::endl;
            }
        }
```
+  Untuk detail API, lihat [SearchImageSets](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/SearchImageSets)di *Referensi AWS SDK untuk C\$1\$1 API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples). 

------
#### [ CLI ]

**AWS CLI**  
**Contoh 1: Untuk mencari set gambar dengan operator EQUAL**  
Contoh `search-image-sets` kode berikut menggunakan operator EQUAL untuk mencari set gambar berdasarkan nilai tertentu.  

```
aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria file://search-criteria.json
```
Isi dari `search-criteria.json`  

```
{
    "filters": [{
        "values": [{"DICOMPatientId" : "SUBJECT08701"}],
        "operator": "EQUAL"
    }]
}
```
Output:  

```
{
    "imageSetsMetadataSummaries": [{
        "imageSetId": "09876543210987654321098765432109",
        "createdAt": "2022-12-06T21:40:59.429000+00:00",
        "version": 1,
        "DICOMTags": {
            "DICOMStudyId": "2011201407",
            "DICOMStudyDate": "19991122",
             "DICOMPatientSex": "F",
             "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
             "DICOMPatientBirthDate": "19201120",
             "DICOMStudyDescription": "UNKNOWN",
             "DICOMPatientId": "SUBJECT08701",
             "DICOMPatientName": "Melissa844 Huel628",
             "DICOMNumberOfStudyRelatedInstances": 1,
             "DICOMStudyTime": "140728",
             "DICOMNumberOfStudyRelatedSeries": 1
            },
        "updatedAt": "2022-12-06T21:40:59.429000+00:00"
    }]
}
```
**Contoh 2: Untuk mencari set gambar dengan operator BETWEET menggunakan DICOMStudy Tanggal dan DICOMStudy Waktu**  
Contoh `search-image-sets` kode berikut mencari kumpulan gambar dengan Studi DICOM yang dihasilkan antara 1 Januari 1990 (12:00 AM) dan 1 Januari 2023 (12:00 AM).  
Catatan: DICOMStudy Waktu adalah opsional. Jika tidak ada, 12:00 AM (awal hari) adalah nilai waktu untuk tanggal yang disediakan untuk penyaringan.  

```
aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria file://search-criteria.json
```
Isi dari `search-criteria.json`  

```
{
    "filters": [{
        "values": [{
            "DICOMStudyDateAndTime": {
                "DICOMStudyDate": "19900101",
                "DICOMStudyTime": "000000"
            }
        },
        {
            "DICOMStudyDateAndTime": {
                "DICOMStudyDate": "20230101",
                "DICOMStudyTime": "000000"
            }
        }],
        "operator": "BETWEEN"
    }]
}
```
Output:  

```
{
    "imageSetsMetadataSummaries": [{
        "imageSetId": "09876543210987654321098765432109",
        "createdAt": "2022-12-06T21:40:59.429000+00:00",
        "version": 1,
        "DICOMTags": {
            "DICOMStudyId": "2011201407",
            "DICOMStudyDate": "19991122",
            "DICOMPatientSex": "F",
            "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
            "DICOMPatientBirthDate": "19201120",
            "DICOMStudyDescription": "UNKNOWN",
            "DICOMPatientId": "SUBJECT08701",
            "DICOMPatientName": "Melissa844 Huel628",
            "DICOMNumberOfStudyRelatedInstances": 1,
            "DICOMStudyTime": "140728",
            "DICOMNumberOfStudyRelatedSeries": 1
        },
        "updatedAt": "2022-12-06T21:40:59.429000+00:00"
    }]
}
```
**Contoh 3: Untuk mencari set gambar dengan operator BETWEET menggunakan createDat (studi waktu sebelumnya dipertahankan)**  
Contoh `search-image-sets` kode berikut mencari set gambar dengan Studi DICOM bertahan di HealthImaging antara rentang waktu di zona waktu UTC.  
Catatan: Berikan CreateDat dalam format contoh (“1985-04-12T 23:20:50.52 Z”).  

```
aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria  file://search-criteria.json
```
Isi dari `search-criteria.json`  

```
{
    "filters": [{
        "values": [{
            "createdAt": "1985-04-12T23:20:50.52Z"
        },
        {
            "createdAt": "2022-04-12T23:20:50.52Z"
        }],
        "operator": "BETWEEN"
    }]
}
```
Output:  

```
{
    "imageSetsMetadataSummaries": [{
        "imageSetId": "09876543210987654321098765432109",
        "createdAt": "2022-12-06T21:40:59.429000+00:00",
        "version": 1,
        "DICOMTags": {
            "DICOMStudyId": "2011201407",
            "DICOMStudyDate": "19991122",
            "DICOMPatientSex": "F",
            "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
            "DICOMPatientBirthDate": "19201120",
            "DICOMStudyDescription": "UNKNOWN",
            "DICOMPatientId": "SUBJECT08701",
            "DICOMPatientName": "Melissa844 Huel628",
            "DICOMNumberOfStudyRelatedInstances": 1,
            "DICOMStudyTime": "140728",
            "DICOMNumberOfStudyRelatedSeries": 1
        },
        "lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00"
    }]
}
```
**Contoh 4: Untuk mencari set gambar dengan operator EQUAL di DICOMSeries InstanceUID dan BETWEET pada UpdateDat dan mengurutkan respons dalam urutan ASC di bidang UpdateDAT**  
Contoh `search-image-sets` kode berikut mencari kumpulan gambar dengan operator EQUAL di DICOMSeries InstanceUID dan BETWEET pada UpdateDat dan mengurutkan respons dalam urutan ASC di bidang UpdateDAT.  
Catatan: Berikan UpdateDat dalam format contoh (“1985-04-12T 23:20:50.52 Z”).  

```
aws medical-imaging search-image-sets \
    --datastore-id 12345678901234567890123456789012 \
    --search-criteria  file://search-criteria.json
```
Isi dari `search-criteria.json`  

```
{
    "filters": [{
        "values": [{
            "updatedAt": "2024-03-11T15:00:05.074000-07:00"
        }, {
            "updatedAt": "2024-03-11T16:00:05.074000-07:00"
        }],
        "operator": "BETWEEN"
    }, {
        "values": [{
            "DICOMSeriesInstanceUID": "1.2.840.99999999.84710745.943275268089"
        }],
        "operator": "EQUAL"
    }],
    "sort": {
        "sortField": "updatedAt",
        "sortOrder": "ASC"
    }
}
```
Output:  

```
{
    "imageSetsMetadataSummaries": [{
        "imageSetId": "09876543210987654321098765432109",
        "createdAt": "2022-12-06T21:40:59.429000+00:00",
        "version": 1,
        "DICOMTags": {
            "DICOMStudyId": "2011201407",
            "DICOMStudyDate": "19991122",
            "DICOMPatientSex": "F",
            "DICOMStudyInstanceUID": "1.2.840.99999999.84710745.943275268089",
            "DICOMPatientBirthDate": "19201120",
            "DICOMStudyDescription": "UNKNOWN",
            "DICOMPatientId": "SUBJECT08701",
            "DICOMPatientName": "Melissa844 Huel628",
            "DICOMNumberOfStudyRelatedInstances": 1,
            "DICOMStudyTime": "140728",
            "DICOMNumberOfStudyRelatedSeries": 1
        },
        "lastUpdatedAt": "2022-12-06T21:40:59.429000+00:00"
    }]
}
```
Untuk informasi selengkapnya, lihat [Mencari kumpulan gambar](https://docs.aws.amazon.com/healthimaging/latest/devguide/search-image-sets.html) di *Panduan AWS HealthImaging Pengembang*.  
+  Untuk detail API, lihat [SearchImageSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/search-image-sets.html)di *Referensi AWS CLI Perintah*. 

------
#### [ Java ]

**SDK untuk Java 2.x**  
Fungsi utilitas untuk mencari set gambar.  

```
    public static List<ImageSetsMetadataSummary> searchMedicalImagingImageSets(
            MedicalImagingClient medicalImagingClient,
            String datastoreId, SearchCriteria searchCriteria) {
        try {
            SearchImageSetsRequest datastoreRequest = SearchImageSetsRequest.builder()
                    .datastoreId(datastoreId)
                    .searchCriteria(searchCriteria)
                    .build();
            SearchImageSetsIterable responses = medicalImagingClient
                    .searchImageSetsPaginator(datastoreRequest);
            List<ImageSetsMetadataSummary> imageSetsMetadataSummaries = new ArrayList<>();

            responses.stream().forEach(response -> imageSetsMetadataSummaries
                    .addAll(response.imageSetsMetadataSummaries()));

            return imageSetsMetadataSummaries;
        } catch (MedicalImagingException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }

        return null;
    }
```
Kasus penggunaan \$11: operator EQUAL.  

```
        List<SearchFilter> searchFilters = Collections.singletonList(SearchFilter.builder()
                .operator(Operator.EQUAL)
                .values(SearchByAttributeValue.builder()
                        .dicomPatientId(patientId)
                        .build())
                .build());

        SearchCriteria searchCriteria = SearchCriteria.builder()
                .filters(searchFilters)
                .build();

        List<ImageSetsMetadataSummary> imageSetsMetadataSummaries = searchMedicalImagingImageSets(
                medicalImagingClient,
                datastoreId, searchCriteria);
        if (imageSetsMetadataSummaries != null) {
            System.out.println("The image sets for patient " + patientId + " are:\n"
                    + imageSetsMetadataSummaries);
            System.out.println();
        }
```
Kasus penggunaan \$12: ANTARA operator menggunakan DICOMStudy Tanggal dan DICOMStudy Waktu.   

```
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyyMMdd");
        searchFilters = Collections.singletonList(SearchFilter.builder()
                .operator(Operator.BETWEEN)
                .values(SearchByAttributeValue.builder()
                                .dicomStudyDateAndTime(DICOMStudyDateAndTime.builder()
                                        .dicomStudyDate("19990101")
                                        .dicomStudyTime("000000.000")
                                        .build())
                                .build(),
                        SearchByAttributeValue.builder()
                                .dicomStudyDateAndTime(DICOMStudyDateAndTime.builder()
                                        .dicomStudyDate((LocalDate.now()
                                                .format(formatter)))
                                        .dicomStudyTime("000000.000")
                                        .build())
                                .build())
                .build());

        searchCriteria = SearchCriteria.builder()
                .filters(searchFilters)
                .build();

        imageSetsMetadataSummaries = searchMedicalImagingImageSets(medicalImagingClient,
                datastoreId, searchCriteria);
        if (imageSetsMetadataSummaries != null) {
            System.out.println(
                    "The image sets searched with BETWEEN operator using DICOMStudyDate and DICOMStudyTime are:\n"
                            +
                            imageSetsMetadataSummaries);
            System.out.println();
        }
```
Kasus penggunaan \$13: ANTARA operator menggunakan createDat. Studi waktu sebelumnya bertahan.   

```
        searchFilters = Collections.singletonList(SearchFilter.builder()
                .operator(Operator.BETWEEN)
                .values(SearchByAttributeValue.builder()
                                .createdAt(Instant.parse("1985-04-12T23:20:50.52Z"))
                                .build(),
                        SearchByAttributeValue.builder()
                                .createdAt(Instant.now())
                                .build())
                .build());

        searchCriteria = SearchCriteria.builder()
                .filters(searchFilters)
                .build();
        imageSetsMetadataSummaries = searchMedicalImagingImageSets(medicalImagingClient,
                datastoreId, searchCriteria);
        if (imageSetsMetadataSummaries != null) {
            System.out.println("The image sets searched with BETWEEN operator using createdAt are:\n "
                    + imageSetsMetadataSummaries);
            System.out.println();
        }
```
Kasus penggunaan \$14: Operator EQUAL di DICOMSeries InstanceUID dan BETWEET di UpdateDAT dan mengurutkan respons dalam urutan ASC di bidang UpdateDAT.   

```
        Instant startDate = Instant.parse("1985-04-12T23:20:50.52Z");
        Instant endDate = Instant.now();

        searchFilters = Arrays.asList(
                SearchFilter.builder()
                        .operator(Operator.EQUAL)
                        .values(SearchByAttributeValue.builder()
                                .dicomSeriesInstanceUID(seriesInstanceUID)
                                .build())
                        .build(),
                SearchFilter.builder()
                        .operator(Operator.BETWEEN)
                        .values(
                                SearchByAttributeValue.builder().updatedAt(startDate).build(),
                                SearchByAttributeValue.builder().updatedAt(endDate).build()
                        ).build());

        Sort sort = Sort.builder().sortOrder(SortOrder.ASC).sortField(SortField.UPDATED_AT).build();

        searchCriteria = SearchCriteria.builder()
                .filters(searchFilters)
                .sort(sort)
                .build();

        imageSetsMetadataSummaries = searchMedicalImagingImageSets(medicalImagingClient,
                datastoreId, searchCriteria);
        if (imageSetsMetadataSummaries != null) {
            System.out.println("The image sets searched with EQUAL operator on DICOMSeriesInstanceUID and BETWEEN on updatedAt and sort response\n" +
                    "in ASC order on updatedAt field are:\n "
                    + imageSetsMetadataSummaries);
            System.out.println();
        }
```
+  Untuk detail API, lihat [SearchImageSets](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/SearchImageSets)di *Referensi AWS SDK for Java 2.x API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples). 

------
#### [ JavaScript ]

**SDK untuk JavaScript (v3)**  
Fungsi utilitas untuk mencari set gambar.  

```
import { paginateSearchImageSets } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";

/**
 * @param {string} datastoreId - The data store's ID.
 * @param { import('@aws-sdk/client-medical-imaging').SearchFilter[] } filters - The search criteria filters.
 * @param { import('@aws-sdk/client-medical-imaging').Sort } sort - The search criteria sort.
 */
export const searchImageSets = async (
  datastoreId = "xxxxxxxx",
  searchCriteria = {},
) => {
  const paginatorConfig = {
    client: medicalImagingClient,
    pageSize: 50,
  };

  const commandParams = {
    datastoreId: datastoreId,
    searchCriteria: searchCriteria,
  };

  const paginator = paginateSearchImageSets(paginatorConfig, commandParams);

  const imageSetsMetadataSummaries = [];
  for await (const page of paginator) {
    // Each page contains a list of `jobSummaries`. The list is truncated if is larger than `pageSize`.
    imageSetsMetadataSummaries.push(...page.imageSetsMetadataSummaries);
    console.log(page);
  }
  // {
  //     '$metadata': {
  //         httpStatusCode: 200,
  //         requestId: 'f009ea9c-84ca-4749-b5b6-7164f00a5ada',
  //         extendedRequestId: undefined,
  //         cfId: undefined,
  //         attempts: 1,
  //         totalRetryDelay: 0
  //     },
  //     imageSetsMetadataSummaries: [
  //         {
  //             DICOMTags: [Object],
  //             createdAt: "2023-09-19T16:59:40.551Z",
  //             imageSetId: '7f75e1b5c0f40eac2b24cf712f485f50',
  //             updatedAt: "2023-09-19T16:59:40.551Z",
  //             version: 1
  //         }]
  // }

  return imageSetsMetadataSummaries;
};
```
Kasus penggunaan \$11: operator EQUAL.  

```
  const datastoreId = "12345678901234567890123456789012";

  try {
    const searchCriteria = {
      filters: [
        {
          values: [{ DICOMPatientId: "1234567" }],
          operator: "EQUAL",
        },
      ],
    };

    await searchImageSets(datastoreId, searchCriteria);
  } catch (err) {
    console.error(err);
  }
```
Kasus penggunaan \$12: ANTARA operator menggunakan DICOMStudy Tanggal dan DICOMStudy Waktu.   

```
  const datastoreId = "12345678901234567890123456789012";

  try {
    const searchCriteria = {
      filters: [
        {
          values: [
            {
              DICOMStudyDateAndTime: {
                DICOMStudyDate: "19900101",
                DICOMStudyTime: "000000",
              },
            },
            {
              DICOMStudyDateAndTime: {
                DICOMStudyDate: "20230901",
                DICOMStudyTime: "000000",
              },
            },
          ],
          operator: "BETWEEN",
        },
      ],
    };

    await searchImageSets(datastoreId, searchCriteria);
  } catch (err) {
    console.error(err);
  }
```
Kasus penggunaan \$13: ANTARA operator menggunakan createDat. Studi waktu sebelumnya bertahan.   

```
  const datastoreId = "12345678901234567890123456789012";

  try {
    const searchCriteria = {
      filters: [
        {
          values: [
            { createdAt: new Date("1985-04-12T23:20:50.52Z") },
            { createdAt: new Date() },
          ],
          operator: "BETWEEN",
        },
      ],
    };

    await searchImageSets(datastoreId, searchCriteria);
  } catch (err) {
    console.error(err);
  }
```
Kasus penggunaan \$14: Operator EQUAL di DICOMSeries InstanceUID dan BETWEET di UpdateDAT dan mengurutkan respons dalam urutan ASC di bidang UpdateDAT.   

```
  const datastoreId = "12345678901234567890123456789012";

  try {
    const searchCriteria = {
      filters: [
        {
          values: [
            { updatedAt: new Date("1985-04-12T23:20:50.52Z") },
            { updatedAt: new Date() },
          ],
          operator: "BETWEEN",
        },
        {
          values: [
            {
              DICOMSeriesInstanceUID:
                "1.1.123.123456.1.12.1.1234567890.1234.12345678.123",
            },
          ],
          operator: "EQUAL",
        },
      ],
      sort: {
        sortOrder: "ASC",
        sortField: "updatedAt",
      },
    };

    await searchImageSets(datastoreId, searchCriteria);
  } catch (err) {
    console.error(err);
  }
```
+  Untuk detail API, lihat [SearchImageSets](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/SearchImageSetsCommand)di *Referensi AWS SDK untuk JavaScript API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples). 

------
#### [ Python ]

**SDK untuk Python (Boto3)**  
Fungsi utilitas untuk mencari set gambar.  

```
class MedicalImagingWrapper:
    def __init__(self, health_imaging_client):
        self.health_imaging_client = health_imaging_client


    def search_image_sets(self, datastore_id, search_filter):
        """
        Search for image sets.

        :param datastore_id: The ID of the data store.
        :param search_filter: The search filter.
            For example: {"filters" : [{ "operator": "EQUAL", "values": [{"DICOMPatientId": "3524578"}]}]}.
        :return: The list of image sets.
        """
        try:
            paginator = self.health_imaging_client.get_paginator("search_image_sets")
            page_iterator = paginator.paginate(
                datastoreId=datastore_id, searchCriteria=search_filter
            )
            metadata_summaries = []
            for page in page_iterator:
                metadata_summaries.extend(page["imageSetsMetadataSummaries"])
        except ClientError as err:
            logger.error(
                "Couldn't search image sets. Here's why: %s: %s",
                err.response["Error"]["Code"],
                err.response["Error"]["Message"],
            )
            raise
        else:
            return metadata_summaries
```
Kasus penggunaan \$11: operator EQUAL.  

```
        search_filter = {
            "filters": [
                {"operator": "EQUAL", "values": [{"DICOMPatientId": patient_id}]}
            ]
        }

        image_sets = self.search_image_sets(data_store_id, search_filter)
        print(f"Image sets found with EQUAL operator\n{image_sets}")
```
Kasus penggunaan \$12: ANTARA operator menggunakan DICOMStudy Tanggal dan DICOMStudy Waktu.   

```
        search_filter = {
            "filters": [
                {
                    "operator": "BETWEEN",
                    "values": [
                        {
                            "DICOMStudyDateAndTime": {
                                "DICOMStudyDate": "19900101",
                                "DICOMStudyTime": "000000",
                            }
                        },
                        {
                            "DICOMStudyDateAndTime": {
                                "DICOMStudyDate": "20230101",
                                "DICOMStudyTime": "000000",
                            }
                        },
                    ],
                }
            ]
        }

        image_sets = self.search_image_sets(data_store_id, search_filter)
        print(
            f"Image sets found with BETWEEN operator using DICOMStudyDate and DICOMStudyTime\n{image_sets}"
        )
```
Kasus penggunaan \$13: ANTARA operator menggunakan createDat. Studi waktu sebelumnya bertahan.   

```
        search_filter = {
            "filters": [
                {
                    "values": [
                        {
                            "createdAt": datetime.datetime(
                                2021, 8, 4, 14, 49, 54, 429000
                            )
                        },
                        {
                            "createdAt": datetime.datetime.now()
                            + datetime.timedelta(days=1)
                        },
                    ],
                    "operator": "BETWEEN",
                }
            ]
        }

        recent_image_sets = self.search_image_sets(data_store_id, search_filter)
        print(
            f"Image sets found with with BETWEEN operator using createdAt\n{recent_image_sets}"
        )
```
Kasus penggunaan \$14: Operator EQUAL di DICOMSeries InstanceUID dan BETWEET di UpdateDAT dan mengurutkan respons dalam urutan ASC di bidang UpdateDAT.   

```
        search_filter = {
            "filters": [
                {
                    "values": [
                        {
                            "updatedAt": datetime.datetime(
                                2021, 8, 4, 14, 49, 54, 429000
                            )
                        },
                        {
                            "updatedAt": datetime.datetime.now()
                            + datetime.timedelta(days=1)
                        },
                    ],
                    "operator": "BETWEEN",
                },
                {
                    "values": [{"DICOMSeriesInstanceUID": series_instance_uid}],
                    "operator": "EQUAL",
                },
            ],
            "sort": {
                "sortOrder": "ASC",
                "sortField": "updatedAt",
            },
        }

        image_sets = self.search_image_sets(data_store_id, search_filter)
        print(
            "Image sets found with EQUAL operator on DICOMSeriesInstanceUID and BETWEEN on updatedAt and"
        )
        print(f"sort response in ASC order on updatedAt field\n{image_sets}")
```
Kode berikut membuat instance objek. MedicalImagingWrapper   

```
    client = boto3.client("medical-imaging")
    medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+  Untuk detail API, lihat [SearchImageSets](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/SearchImageSets)di *AWS SDK for Python (Boto3) Referensi* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples). 

------
#### [ SAP ABAP ]

**SDK for SAP ABAP**  

```
    TRY.
        " iv_datastore_id = '1234567890123456789012345678901234567890'
        oo_result = lo_mig->searchimagesets(
          iv_datastoreid = iv_datastore_id
          io_searchcriteria = io_search_criteria ).
        DATA(lt_imagesets) = oo_result->get_imagesetsmetadatasums( ).
        DATA(lv_count) = lines( lt_imagesets ).
        MESSAGE |Found { lv_count } image sets.| TYPE 'I'.
      CATCH /aws1/cx_migaccessdeniedex.
        MESSAGE 'Access denied.' TYPE 'I'.
      CATCH /aws1/cx_migconflictexception.
        MESSAGE 'Conflict error.' TYPE 'I'.
      CATCH /aws1/cx_miginternalserverex.
        MESSAGE 'Internal server error.' TYPE 'I'.
      CATCH /aws1/cx_migresourcenotfoundex.
        MESSAGE 'Resource not found.' TYPE 'I'.
      CATCH /aws1/cx_migthrottlingex.
        MESSAGE 'Request throttled.' TYPE 'I'.
      CATCH /aws1/cx_migvalidationex.
        MESSAGE 'Validation error.' TYPE 'I'.
    ENDTRY.
```
+  Untuk detail API, lihat [SearchImageSets](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)di *AWS SDK untuk referensi SAP ABAP* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples). 

------

**Ketersediaan contoh**  
Tidak dapat menemukan apa yang Anda butuhkan? Minta contoh kode menggunakan tautan **Berikan umpan balik** di bilah sisi kanan halaman ini.

# Mendapatkan properti set gambar
<a name="get-image-set-properties"></a>

Gunakan `GetImageSet` tindakan untuk mengembalikan properti untuk [gambar tertentu yang disetel](getting-started-concepts.md#concept-image-set) HealthImaging. Menu berikut memberikan prosedur untuk contoh Konsol Manajemen AWS dan kode untuk AWS CLI dan AWS SDKs. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSet.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSet.html)di *AWS HealthImaging API Referensi*.

**catatan**  
Secara default, AWS HealthImaging mengembalikan properti untuk versi terbaru dari kumpulan gambar. Untuk melihat properti untuk versi yang lebih lama dari kumpulan gambar, berikan permintaan Anda. `versionId`  
Gunakan`GetDICOMInstance`, HealthImaging representasi DICOMweb layanan, untuk mengembalikan biner instance DICOM (`.dcm`file). Untuk informasi selengkapnya, lihat [Mendapatkan instance DICOM dari HealthImaging](dicomweb-retrieve-instance.md).

**Untuk mendapatkan properti set gambar**  
Pilih menu berdasarkan preferensi akses Anda ke AWS HealthImaging.

## AWS Konsol
<a name="code-example-console-image-set-properties"></a>

1. Buka [halaman penyimpanan data HealthImaging ](https://console.aws.amazon.com/medical-imaging/home#/dataStores) konsol.

1. Pilih penyimpanan data.

   Halaman **detail penyimpanan data** terbuka dan tab **Image sets** dipilih secara default.

1. Pilih satu set gambar.

   Halaman **detail set Gambar** membuka dan menampilkan properti set gambar.

## AWS CLI dan SDKs
<a name="code-example-cli-sdk-image-set-properties"></a>

------
#### [ CLI ]

**AWS CLI**  
**Untuk mendapatkan properti set gambar**  
Contoh `get-image-set` kode berikut mendapatkan properti untuk set gambar.  

```
aws medical-imaging get-image-set \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id 18f88ac7870584f58d56256646b4d92b \
    --version-id 1
```
Output:  

```
{
    "versionId": "1",
    "imageSetWorkflowStatus": "COPIED",
    "updatedAt": 1680027253.471,
    "imageSetId": "18f88ac7870584f58d56256646b4d92b",
    "imageSetState": "ACTIVE",
    "createdAt": 1679592510.753,
    "datastoreId": "12345678901234567890123456789012"
}
```
Untuk informasi selengkapnya, lihat [Mendapatkan properti set gambar](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-properties.html) di *Panduan AWS HealthImaging Pengembang*.  
+  Untuk detail API, lihat [GetImageSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set.html)di *Referensi AWS CLI Perintah*. 

------
#### [ Java ]

**SDK untuk Java 2.x**  

```
    public static GetImageSetResponse getMedicalImageSet(MedicalImagingClient medicalImagingClient,
            String datastoreId,
            String imagesetId,
            String versionId) {
        try {
            GetImageSetRequest.Builder getImageSetRequestBuilder = GetImageSetRequest.builder()
                    .datastoreId(datastoreId)
                    .imageSetId(imagesetId);

            if (versionId != null) {
                getImageSetRequestBuilder = getImageSetRequestBuilder.versionId(versionId);
            }

            return medicalImagingClient.getImageSet(getImageSetRequestBuilder.build());
        } catch (MedicalImagingException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }

        return null;
    }
```
+  Untuk detail API, lihat [GetImageSet](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageSet)di *Referensi AWS SDK for Java 2.x API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples). 

------
#### [ JavaScript ]

**SDK untuk JavaScript (v3)**  

```
import { GetImageSetCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";

/**
 * @param {string} datastoreId - The ID of the data store.
 * @param {string} imageSetId - The ID of the image set.
 * @param {string} imageSetVersion - The optional version of the image set.
 *
 */
export const getImageSet = async (
  datastoreId = "xxxxxxxxxxxxxxx",
  imageSetId = "xxxxxxxxxxxxxxx",
  imageSetVersion = "",
) => {
  const params = { datastoreId: datastoreId, imageSetId: imageSetId };
  if (imageSetVersion !== "") {
    params.imageSetVersion = imageSetVersion;
  }
  const response = await medicalImagingClient.send(
    new GetImageSetCommand(params),
  );
  console.log(response);
  // {
  //     '$metadata': {
  //     httpStatusCode: 200,
  //         requestId: '0615c161-410d-4d06-9d8c-6e1241bb0a5a',
  //         extendedRequestId: undefined,
  //         cfId: undefined,
  //         attempts: 1,
  //         totalRetryDelay: 0
  // },
  //     createdAt: 2023-09-22T14:49:26.427Z,
  //     datastoreId: 'xxxxxxxxxxxxxxx',
  //     imageSetArn: 'arn:aws:medical-imaging:us-east-1:xxxxxxxxxx:datastore/xxxxxxxxxxxxxxxxxxxx/imageset/xxxxxxxxxxxxxxxxxxxx',
  //     imageSetId: 'xxxxxxxxxxxxxxx',
  //     imageSetState: 'ACTIVE',
  //     imageSetWorkflowStatus: 'CREATED',
  //     updatedAt: 2023-09-22T14:49:26.427Z,
  //     versionId: '1'
  // }

  return response;
};
```
+  Untuk detail API, lihat [GetImageSet](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageSetCommand)di *Referensi AWS SDK untuk JavaScript API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples). 

------
#### [ Python ]

**SDK untuk Python (Boto3)**  

```
class MedicalImagingWrapper:
    def __init__(self, health_imaging_client):
        self.health_imaging_client = health_imaging_client


    def get_image_set(self, datastore_id, image_set_id, version_id=None):
        """
        Get the properties of an image set.

        :param datastore_id: The ID of the data store.
        :param image_set_id: The ID of the image set.
        :param version_id: The optional version of the image set.
        :return: The image set properties.
        """
        try:
            if version_id:
                image_set = self.health_imaging_client.get_image_set(
                    imageSetId=image_set_id,
                    datastoreId=datastore_id,
                    versionId=version_id,
                )
            else:
                image_set = self.health_imaging_client.get_image_set(
                    imageSetId=image_set_id, datastoreId=datastore_id
                )
        except ClientError as err:
            logger.error(
                "Couldn't get image set. Here's why: %s: %s",
                err.response["Error"]["Code"],
                err.response["Error"]["Message"],
            )
            raise
        else:
            return image_set
```
Kode berikut membuat instance objek. MedicalImagingWrapper   

```
    client = boto3.client("medical-imaging")
    medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+  Untuk detail API, lihat [GetImageSet](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageSet)di *AWS SDK for Python (Boto3) Referensi* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples). 

------
#### [ SAP ABAP ]

**SDK for SAP ABAP**  

```
    TRY.
        " iv_datastore_id = '1234567890123456789012345678901234567890'
        " iv_image_set_id = '1234567890123456789012345678901234567890'
        " iv_version_id = '1' (optional)
        IF iv_version_id IS NOT INITIAL.
          oo_result = lo_mig->getimageset(
            iv_datastoreid = iv_datastore_id
            iv_imagesetid = iv_image_set_id
            iv_versionid = iv_version_id ).
        ELSE.
          oo_result = lo_mig->getimageset(
            iv_datastoreid = iv_datastore_id
            iv_imagesetid = iv_image_set_id ).
        ENDIF.
        DATA(lv_state) = oo_result->get_imagesetstate( ).
        MESSAGE |Image set retrieved with state: { lv_state }.| TYPE 'I'.
      CATCH /aws1/cx_migaccessdeniedex.
        MESSAGE 'Access denied.' TYPE 'I'.
      CATCH /aws1/cx_migconflictexception.
        MESSAGE 'Conflict error.' TYPE 'I'.
      CATCH /aws1/cx_miginternalserverex.
        MESSAGE 'Internal server error.' TYPE 'I'.
      CATCH /aws1/cx_migresourcenotfoundex.
        MESSAGE 'Image set not found.' TYPE 'I'.
      CATCH /aws1/cx_migthrottlingex.
        MESSAGE 'Request throttled.' TYPE 'I'.
      CATCH /aws1/cx_migvalidationex.
        MESSAGE 'Validation error.' TYPE 'I'.
    ENDTRY.
```
+  Untuk detail API, lihat [GetImageSet](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)di *AWS SDK untuk referensi SAP ABAP* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples). 

------

**Ketersediaan contoh**  
Tidak dapat menemukan apa yang Anda butuhkan? Minta contoh kode menggunakan tautan **Berikan umpan balik** di bilah sisi kanan halaman ini.

# Mendapatkan metadata set gambar
<a name="get-image-set-metadata"></a>

Gunakan `GetImageSetMetadata` tindakan untuk mengambil [metadata](getting-started-concepts.md#concept-metadata) untuk [gambar](getting-started-concepts.md#concept-image-set) tertentu yang disetel. HealthImaging Menu berikut memberikan prosedur untuk contoh Konsol Manajemen AWS dan kode untuk AWS CLI dan AWS SDKs. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageSetMetadata.html)di *AWS HealthImaging API Referensi*.

**catatan**  
Secara default, HealthImaging mengembalikan atribut metadata untuk versi terbaru dari kumpulan gambar. Untuk melihat metadata untuk versi yang lebih lama dari kumpulan gambar, berikan permintaan `versionId` Anda.  
Metadata set gambar dikompresi dengan `gzip` dan dikembalikan sebagai objek JSON. Oleh karena itu, Anda harus mendekompresi objek JSON sebelum melihat metadata yang dinormalisasi. Untuk informasi selengkapnya, lihat [Normalisasi metadata](metadata-normalization.md).  
Jika metadata set gambar besar masih diproses setelah impor, 409 `ConflictException` dapat dikembalikan. Coba lagi permintaan setelah beberapa detik setelah pemrosesan selesai.  
Gunakan`GetDICOMInstanceMetadata`, HealthImaging representasi DICOMweb layanan, untuk mengembalikan metadata instance DICOM (`.json`file). Untuk informasi selengkapnya, lihat [Mendapatkan metadata instans DICOM dari HealthImaging](dicomweb-retrieve-instance-metadata.md).

**Untuk mendapatkan metadata set gambar**  
Pilih menu berdasarkan preferensi akses Anda ke AWS HealthImaging.

## AWS Konsol
<a name="code-example-console-image-set-get-metadata"></a>

1. Buka [halaman penyimpanan data HealthImaging ](https://console.aws.amazon.com/medical-imaging/home#/dataStores) konsol.

1. Pilih penyimpanan data.

   Halaman **detail penyimpanan data** terbuka dan tab **Image sets** dipilih secara default.

1. Pilih satu set gambar.

   Halaman **detail set Gambar** terbuka dan metadata set gambar ditampilkan di bawah bagian Penampil **metadata set gambar**.

## AWS CLI dan SDKs
<a name="code-example-cli-sdk-image-set-get-metadata"></a>

------
#### [ C\$1\$1 ]

**SDK untuk C\$1\$1**  
Fungsi utilitas untuk mendapatkan metadata set gambar.  

```
//! Routine which gets a HealthImaging image set's metadata.
/*!
  \param dataStoreID: The HealthImaging data store ID.
  \param imageSetID: The HealthImaging image set ID.
  \param versionID: The HealthImaging image set version ID, ignored if empty.
  \param outputFilePath: The path where the metadata will be stored as gzipped json.
  \param clientConfig: Aws client configuration.
  \\return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::getImageSetMetadata(const Aws::String &dataStoreID,
                                                  const Aws::String &imageSetID,
                                                  const Aws::String &versionID,
                                                  const Aws::String &outputFilePath,
                                                  const Aws::Client::ClientConfiguration &clientConfig) {
    Aws::MedicalImaging::Model::GetImageSetMetadataRequest request;
    request.SetDatastoreId(dataStoreID);
    request.SetImageSetId(imageSetID);
    if (!versionID.empty()) {
        request.SetVersionId(versionID);
    }
    Aws::MedicalImaging::MedicalImagingClient client(clientConfig);
    Aws::MedicalImaging::Model::GetImageSetMetadataOutcome outcome = client.GetImageSetMetadata(
            request);
    if (outcome.IsSuccess()) {
        std::ofstream file(outputFilePath, std::ios::binary);
        auto &metadata = outcome.GetResult().GetImageSetMetadataBlob();
        file << metadata.rdbuf();
    }
    else {
        std::cerr << "Failed to get image set metadata: "
                  << outcome.GetError().GetMessage() << std::endl;
    }

    return outcome.IsSuccess();
}
```
Dapatkan metadata set gambar tanpa versi.  

```
        if (AwsDoc::Medical_Imaging::getImageSetMetadata(dataStoreID, imageSetID, "", outputFilePath, clientConfig))
        {
            std::cout << "Successfully retrieved image set metadata." << std::endl;
            std::cout << "Metadata stored in: " << outputFilePath << std::endl;
        }
```
Dapatkan metadata set gambar dengan versi.  

```
        if (AwsDoc::Medical_Imaging::getImageSetMetadata(dataStoreID, imageSetID, versionID, outputFilePath, clientConfig))
        {
            std::cout << "Successfully retrieved image set metadata." << std::endl;
            std::cout << "Metadata stored in: " << outputFilePath << std::endl;
        }
```
+  Untuk detail API, lihat [GetImageSetMetadata](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/GetImageSetMetadata)di *Referensi AWS SDK untuk C\$1\$1 API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples). 

------
#### [ CLI ]

**AWS CLI**  
**Contoh 1: Untuk mendapatkan metadata set gambar tanpa versi**  
Contoh `get-image-set-metadata` kode berikut mendapatkan metadata untuk kumpulan gambar tanpa menentukan versi.  
Catatan: `outfile` adalah parameter yang diperlukan  

```
aws medical-imaging get-image-set-metadata \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    studymetadata.json.gz
```
Metadata yang dikembalikan dikompresi dengan gzip dan disimpan dalam file studymetadata.json.gz. Untuk melihat isi objek JSON yang dikembalikan, Anda harus terlebih dahulu mendekompresnya.  
Output:  

```
{
    "contentType": "application/json",
    "contentEncoding": "gzip"
}
```
**Contoh 2: Untuk mendapatkan metadata set gambar dengan versi**  
Contoh `get-image-set-metadata` kode berikut mendapatkan metadata untuk set gambar dengan versi tertentu.  
Catatan: `outfile` adalah parameter yang diperlukan  

```
aws medical-imaging get-image-set-metadata \
    --datastore-id 12345678901234567890123456789012 \
    --image-set-id ea92b0d8838c72a3f25d00d13616f87e \
    --version-id 1 \
    studymetadata.json.gz
```
Metadata yang dikembalikan dikompresi dengan gzip dan disimpan dalam file studymetadata.json.gz. Untuk melihat isi objek JSON yang dikembalikan, Anda harus terlebih dahulu mendekompresnya.  
Output:  

```
{
    "contentType": "application/json",
    "contentEncoding": "gzip"
}
```
Untuk informasi selengkapnya, lihat [Mendapatkan metadata set gambar](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-set-metadata.html) di Panduan *AWS HealthImaging Pengembang*.  
+  Untuk detail API, lihat [GetImageSetMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-set-metadata.html)di *Referensi AWS CLI Perintah*. 

------
#### [ Java ]

**SDK untuk Java 2.x**  

```
    public static void getMedicalImageSetMetadata(MedicalImagingClient medicalImagingClient,
            String destinationPath,
            String datastoreId,
            String imagesetId,
            String versionId) {

        try {
            GetImageSetMetadataRequest.Builder getImageSetMetadataRequestBuilder = GetImageSetMetadataRequest.builder()
                    .datastoreId(datastoreId)
                    .imageSetId(imagesetId);

            if (versionId != null) {
                getImageSetMetadataRequestBuilder = getImageSetMetadataRequestBuilder.versionId(versionId);
            }

            medicalImagingClient.getImageSetMetadata(getImageSetMetadataRequestBuilder.build(),
                    FileSystems.getDefault().getPath(destinationPath));

            System.out.println("Metadata downloaded to " + destinationPath);
        } catch (MedicalImagingException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }
```
+  Untuk detail API, lihat [GetImageSetMetadata](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageSetMetadata)di *Referensi AWS SDK for Java 2.x API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples). 

------
#### [ JavaScript ]

**SDK untuk JavaScript (v3)**  
Fungsi utilitas untuk mendapatkan metadata set gambar.  

```
import { GetImageSetMetadataCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";
import { writeFileSync } from "node:fs";

/**
 * @param {string} metadataFileName - The name of the file for the gzipped metadata.
 * @param {string} datastoreId - The ID of the data store.
 * @param {string} imagesetId - The ID of the image set.
 * @param {string} versionID - The optional version ID of the image set.
 */
export const getImageSetMetadata = async (
  metadataFileName = "metadata.json.gzip",
  datastoreId = "xxxxxxxxxxxxxx",
  imagesetId = "xxxxxxxxxxxxxx",
  versionID = "",
) => {
  const params = { datastoreId: datastoreId, imageSetId: imagesetId };

  if (versionID) {
    params.versionID = versionID;
  }

  const response = await medicalImagingClient.send(
    new GetImageSetMetadataCommand(params),
  );
  const buffer = await response.imageSetMetadataBlob.transformToByteArray();
  writeFileSync(metadataFileName, buffer);

  console.log(response);
  // {
  //     '$metadata': {
  //     httpStatusCode: 200,
  //         requestId: '5219b274-30ff-4986-8cab-48753de3a599',
  //         extendedRequestId: undefined,
  //         cfId: undefined,
  //         attempts: 1,
  //         totalRetryDelay: 0
  // },
  //     contentType: 'application/json',
  //     contentEncoding: 'gzip',
  //     imageSetMetadataBlob: <ref *1> IncomingMessage {}
  // }

  return response;
};
```
Dapatkan metadata set gambar tanpa versi.  

```
  try {
    await getImageSetMetadata(
      "metadata.json.gzip",
      "12345678901234567890123456789012",
      "12345678901234567890123456789012",
    );
  } catch (err) {
    console.log("Error", err);
  }
```
Dapatkan metadata set gambar dengan versi.  

```
  try {
    await getImageSetMetadata(
      "metadata2.json.gzip",
      "12345678901234567890123456789012",
      "12345678901234567890123456789012",
      "1",
    );
  } catch (err) {
    console.log("Error", err);
  }
```
+  Untuk detail API, lihat [GetImageSetMetadata](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageSetMetadataCommand)di *Referensi AWS SDK untuk JavaScript API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples). 

------
#### [ Python ]

**SDK untuk Python (Boto3)**  
Fungsi utilitas untuk mendapatkan metadata set gambar.  

```
class MedicalImagingWrapper:
    def __init__(self, health_imaging_client):
        self.health_imaging_client = health_imaging_client


    def get_image_set_metadata(
        self, metadata_file, datastore_id, image_set_id, version_id=None
    ):
        """
        Get the metadata of an image set.

        :param metadata_file: The file to store the JSON gzipped metadata.
        :param datastore_id: The ID of the data store.
        :param image_set_id: The ID of the image set.
        :param version_id: The version of the image set.
        """
        try:
            if version_id:
                image_set_metadata = self.health_imaging_client.get_image_set_metadata(
                    imageSetId=image_set_id,
                    datastoreId=datastore_id,
                    versionId=version_id,
                )
            else:

                image_set_metadata = self.health_imaging_client.get_image_set_metadata(
                    imageSetId=image_set_id, datastoreId=datastore_id
                )
            print(image_set_metadata)
            with open(metadata_file, "wb") as f:
                for chunk in image_set_metadata["imageSetMetadataBlob"].iter_chunks():
                    if chunk:
                        f.write(chunk)

        except ClientError as err:
            logger.error(
                "Couldn't get image metadata. Here's why: %s: %s",
                err.response["Error"]["Code"],
                err.response["Error"]["Message"],
            )
            raise
```
Dapatkan metadata set gambar tanpa versi.  

```
                image_set_metadata = self.health_imaging_client.get_image_set_metadata(
                    imageSetId=image_set_id, datastoreId=datastore_id
                )
```
Dapatkan metadata set gambar dengan versi.  

```
                image_set_metadata = self.health_imaging_client.get_image_set_metadata(
                    imageSetId=image_set_id,
                    datastoreId=datastore_id,
                    versionId=version_id,
                )
```
Kode berikut membuat instance objek. MedicalImagingWrapper   

```
    client = boto3.client("medical-imaging")
    medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+  Untuk detail API, lihat [GetImageSetMetadata](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageSetMetadata)di *AWS SDK for Python (Boto3) Referensi* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples). 

------
#### [ SAP ABAP ]

**SDK for SAP ABAP**  

```
    TRY.
        " iv_datastore_id = '1234567890123456789012345678901234567890'
        " iv_image_set_id = '1234567890123456789012345678901234567890'
        " iv_version_id = '1' (optional)
        IF iv_version_id IS NOT INITIAL.
          oo_result = lo_mig->getimagesetmetadata(
            iv_datastoreid = iv_datastore_id
            iv_imagesetid = iv_image_set_id
            iv_versionid = iv_version_id ).
        ELSE.
          oo_result = lo_mig->getimagesetmetadata(
            iv_datastoreid = iv_datastore_id
            iv_imagesetid = iv_image_set_id ).
        ENDIF.
        DATA(lv_metadata_blob) = oo_result->get_imagesetmetadatablob( ).
        MESSAGE 'Image set metadata retrieved.' TYPE 'I'.
      CATCH /aws1/cx_migaccessdeniedex.
        MESSAGE 'Access denied.' TYPE 'I'.
      CATCH /aws1/cx_migconflictexception.
        MESSAGE 'Conflict error.' TYPE 'I'.
      CATCH /aws1/cx_miginternalserverex.
        MESSAGE 'Internal server error.' TYPE 'I'.
      CATCH /aws1/cx_migresourcenotfoundex.
        MESSAGE 'Image set not found.' TYPE 'I'.
      CATCH /aws1/cx_migthrottlingex.
        MESSAGE 'Request throttled.' TYPE 'I'.
      CATCH /aws1/cx_migvalidationex.
        MESSAGE 'Validation error.' TYPE 'I'.
    ENDTRY.
```
+  Untuk detail API, lihat [GetImageSetMetadata](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)di *AWS SDK untuk referensi SAP ABAP* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples). 

------

**Ketersediaan contoh**  
Tidak dapat menemukan apa yang Anda butuhkan? Minta contoh kode menggunakan tautan **Berikan umpan balik** di bilah sisi kanan halaman ini.

**Transfer Sintaks Metadata**  
Saat mengimpor data DICOM, HealthImaging simpan nilai asli untuk atribut sintaks transfer dalam metadata kumpulan gambar. Sintaks transfer data DICOM asli yang diimpor disimpan sebagai. `TransferSyntaxUID` HealthImaging digunakan `StoredTransferSyntaxUID` untuk menunjukkan format yang digunakan untuk menyandikan data bingkai gambar di penyimpanan data: `1.2.840.10008.1.2.4.202` untuk penyimpanan data berkemampuan HTJ2 K (default) dan `1.2.840.10008.1.2.4.90` untuk penyimpanan data yang diaktifkan JPEG 2000 Lossless.

# Mendapatkan data piksel set gambar
<a name="get-image-frame"></a>

[Bingkai gambar](getting-started-concepts.md#concept-image-frame) adalah data piksel yang ada dalam gambar yang diatur untuk membuat gambar medis 2D. [Gunakan `GetImageFrame` tindakan untuk mengambil bingkai gambar lossless JPEG 2000 HTJ2 yang disandikan K atau asli untuk gambar tertentu yang disetel.](getting-started-concepts.md#concept-image-set) HealthImaging Menu berikut memberikan contoh kode untuk AWS CLI dan AWS SDKs. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html)di *AWS HealthImaging API Referensi*.

**catatan**  
Ingatlah poin-poin berikut saat menggunakan `GetImageFrame` tindakan:  
Selama [impor](importing-imaging-data.md), HealthImaging mempertahankan pengkodean untuk beberapa sintaks transfer, dan mentranskode yang lain ke HTJ2 K lossless (default) atau JPEG 2000 Lossless. `GetImageFrame`Tindakan mengembalikan bingkai gambar dalam sintaks transfer tersimpan dari instance. Tidak ada transcoding yang dilakukan selama pengambilan untuk memastikan latensi pengambilan minimal. Bingkai gambar mungkin perlu diterjemahkan sebelum dilihat di penampil gambar, tergantung pada sintaks transfer. Untuk informasi selengkapnya, lihat [Sintaks transfer yang didukung](supported-transfer-syntaxes.md) dan [Pustaka decoding bingkai gambar](reference-libraries.md).
[Untuk contoh yang disimpan HealthImaging dengan satu atau lebih bingkai gambar yang dikodekan dalam keluarga MPEG Transfer Syntax (yang mencakup MPEG2, MPEG-4 AVC/H.264 and HEVC/H .265) `GetImageFrame` tindakan akan mengembalikan objek video dalam sintaks transfer yang disimpan.](supported-transfer-syntaxes.md)
Sintaks transfer frame gambar ditentukan dalam elemen respon `Content-Type HTTP` header. Misalnya, bingkai gambar yang dikodekan dalam HTJ2 K akan memiliki. `Content-Type: image/jph header` Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_GetImageFrame.html)di *AWS HealthImaging API Referensi*.
Anda juga dapat menggunakan representasi DICOMweb layanan`GetDICOMInstanceFrames`, HealthImaging untuk mengambil frame (`multipart`permintaan) instans DICOM untuk pemirsa dan aplikasi DICOMweb yang kompatibel. Untuk informasi selengkapnya, lihat [Mendapatkan bingkai instans DICOM dari HealthImaging](dicomweb-retrieve-instance-frames.md).

**Untuk mendapatkan data piksel set gambar**  
Pilih menu berdasarkan preferensi akses Anda ke AWS HealthImaging.

## AWS Konsol
<a name="code-example-console-image-set-get-pixel-data"></a>

**catatan**  
Bingkai gambar harus diakses dan diterjemahkan secara terprogram, karena penampil gambar tidak tersedia di file. Konsol Manajemen AWS  
Untuk informasi selengkapnya tentang decoding dan melihat bingkai gambar, lihat. [Pustaka decoding bingkai gambar](reference-libraries.md)

## AWS CLI dan SDKs
<a name="code-example-cli-sdk-image-set-get-pixel-data"></a>

------
#### [ C\$1\$1 ]

**SDK untuk C\$1\$1**  

```
//! Routine which downloads an AWS HealthImaging image frame.
/*!
  \param dataStoreID: The HealthImaging data store ID.
  \param imageSetID: The image set ID.
  \param frameID: The image frame ID.
  \param jphFile: File to store the downloaded frame.
  \param clientConfig: Aws client configuration.
  \return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::getImageFrame(const Aws::String &dataStoreID,
                                            const Aws::String &imageSetID,
                                            const Aws::String &frameID,
                                            const Aws::String &jphFile,
                                            const Aws::Client::ClientConfiguration &clientConfig) {
    Aws::MedicalImaging::MedicalImagingClient client(clientConfig);

    Aws::MedicalImaging::Model::GetImageFrameRequest request;
    request.SetDatastoreId(dataStoreID);
    request.SetImageSetId(imageSetID);

    Aws::MedicalImaging::Model::ImageFrameInformation imageFrameInformation;
    imageFrameInformation.SetImageFrameId(frameID);
    request.SetImageFrameInformation(imageFrameInformation);

    Aws::MedicalImaging::Model::GetImageFrameOutcome outcome = client.GetImageFrame(
            request);

    if (outcome.IsSuccess()) {
        std::cout << "Successfully retrieved image frame." << std::endl;
        auto &buffer = outcome.GetResult().GetImageFrameBlob();

        std::ofstream outfile(jphFile, std::ios::binary);
        outfile << buffer.rdbuf();
    }
    else {
        std::cout << "Error retrieving image frame." << outcome.GetError().GetMessage()
                  << std::endl;

    }

    return outcome.IsSuccess();
}
```
+  Untuk detail API, lihat [GetImageFrame](https://docs.aws.amazon.com/goto/SdkForCpp/medical-imaging-2023-07-19/GetImageFrame)di *Referensi AWS SDK untuk C\$1\$1 API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/medical-imaging/#code-examples). 

------
#### [ CLI ]

**AWS CLI**  
**Untuk mendapatkan data piksel set gambar**  
Contoh `get-image-frame` kode berikut mendapat bingkai gambar.  

```
aws medical-imaging get-image-frame \
    --datastore-id "12345678901234567890123456789012" \
    --image-set-id "98765412345612345678907890789012" \
    --image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \
    imageframe.jph
```
Catatan: Contoh kode ini tidak menyertakan output karena GetImageFrame tindakan mengembalikan aliran data piksel ke file imageframe.jph. Untuk informasi tentang decoding dan melihat bingkai gambar, lihat HTJ2 K decoding library.  
Untuk informasi selengkapnya, lihat [Mendapatkan data piksel yang disetel gambar](https://docs.aws.amazon.com/healthimaging/latest/devguide/get-image-frame.html) di *Panduan AWS HealthImaging Pengembang*.  
+  Untuk detail API, lihat [GetImageFrame](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/medical-imaging/get-image-frame.html)di *Referensi AWS CLI Perintah*. 

------
#### [ Java ]

**SDK untuk Java 2.x**  

```
        public static void getMedicalImageSetFrame(MedicalImagingClient medicalImagingClient,
                        String destinationPath,
                        String datastoreId,
                        String imagesetId,
                        String imageFrameId) {

                try {
                        GetImageFrameRequest getImageSetMetadataRequest = GetImageFrameRequest.builder()
                                        .datastoreId(datastoreId)
                                        .imageSetId(imagesetId)
                                        .imageFrameInformation(ImageFrameInformation.builder()
                                                        .imageFrameId(imageFrameId)
                                                        .build())
                                        .build();
                        medicalImagingClient.getImageFrame(getImageSetMetadataRequest,
                                        FileSystems.getDefault().getPath(destinationPath));

                        System.out.println("Image frame downloaded to " + destinationPath);
                } catch (MedicalImagingException e) {
                        System.err.println(e.awsErrorDetails().errorMessage());
                        System.exit(1);
                }
        }
```
+  Untuk detail API, lihat [GetImageFrame](https://docs.aws.amazon.com/goto/SdkForJavaV2/medical-imaging-2023-07-19/GetImageFrame)di *Referensi AWS SDK for Java 2.x API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/medicalimaging#code-examples). 

------
#### [ JavaScript ]

**SDK untuk JavaScript (v3)**  

```
import { GetImageFrameCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";

/**
 * @param {string} imageFrameFileName - The name of the file for the HTJ2K-encoded image frame.
 * @param {string} datastoreID - The data store's ID.
 * @param {string} imageSetID - The image set's ID.
 * @param {string} imageFrameID - The image frame's ID.
 */
export const getImageFrame = async (
  imageFrameFileName = "image.jph",
  datastoreID = "DATASTORE_ID",
  imageSetID = "IMAGE_SET_ID",
  imageFrameID = "IMAGE_FRAME_ID",
) => {
  const response = await medicalImagingClient.send(
    new GetImageFrameCommand({
      datastoreId: datastoreID,
      imageSetId: imageSetID,
      imageFrameInformation: { imageFrameId: imageFrameID },
    }),
  );
  const buffer = await response.imageFrameBlob.transformToByteArray();
  writeFileSync(imageFrameFileName, buffer);

  console.log(response);
  // {
  //     '$metadata': {
  //         httpStatusCode: 200,
  //         requestId: 'e4ab42a5-25a3-4377-873f-374ecf4380e1',
  //         extendedRequestId: undefined,
  //         cfId: undefined,
  //         attempts: 1,
  //         totalRetryDelay: 0
  //     },
  //     contentType: 'application/octet-stream',
  //     imageFrameBlob: <ref *1> IncomingMessage {}
  // }
  return response;
};
```
+  Untuk detail API, lihat [GetImageFrame](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/medical-imaging/command/GetImageFrameCommand)di *Referensi AWS SDK untuk JavaScript API*. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/medical-imaging#code-examples). 

------
#### [ Python ]

**SDK untuk Python (Boto3)**  

```
class MedicalImagingWrapper:
    def __init__(self, health_imaging_client):
        self.health_imaging_client = health_imaging_client


    def get_pixel_data(
        self, file_path_to_write, datastore_id, image_set_id, image_frame_id
    ):
        """
        Get an image frame's pixel data.

        :param file_path_to_write: The path to write the image frame's HTJ2K encoded pixel data.
        :param datastore_id: The ID of the data store.
        :param image_set_id: The ID of the image set.
        :param image_frame_id: The ID of the image frame.
        """
        try:
            image_frame = self.health_imaging_client.get_image_frame(
                datastoreId=datastore_id,
                imageSetId=image_set_id,
                imageFrameInformation={"imageFrameId": image_frame_id},
            )
            with open(file_path_to_write, "wb") as f:
                for chunk in image_frame["imageFrameBlob"].iter_chunks():
                    if chunk:
                        f.write(chunk)
        except ClientError as err:
            logger.error(
                "Couldn't get image frame. Here's why: %s: %s",
                err.response["Error"]["Code"],
                err.response["Error"]["Message"],
            )
            raise
```
Kode berikut membuat instance objek. MedicalImagingWrapper   

```
    client = boto3.client("medical-imaging")
    medical_imaging_wrapper = MedicalImagingWrapper(client)
```
+  Untuk detail API, lihat [GetImageFrame](https://docs.aws.amazon.com/goto/boto3/medical-imaging-2023-07-19/GetImageFrame)di *AWS SDK for Python (Boto3) Referensi* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/medical-imaging#code-examples). 

------
#### [ SAP ABAP ]

**SDK for SAP ABAP**  

```
    TRY.
        " iv_datastore_id = '1234567890123456789012345678901234567890'
        " iv_image_set_id = '1234567890123456789012345678901234567890'
        " iv_image_frame_id = '1234567890123456789012345678901234567890'
        oo_result = lo_mig->getimageframe(
          iv_datastoreid = iv_datastore_id
          iv_imagesetid = iv_image_set_id
          io_imageframeinformation = NEW /aws1/cl_migimageframeinfmtion(
            iv_imageframeid = iv_image_frame_id ) ).
        DATA(lv_frame_blob) = oo_result->get_imageframeblob( ).
        MESSAGE 'Image frame retrieved.' TYPE 'I'.
      CATCH /aws1/cx_migaccessdeniedex.
        MESSAGE 'Access denied.' TYPE 'I'.
      CATCH /aws1/cx_migconflictexception.
        MESSAGE 'Conflict error.' TYPE 'I'.
      CATCH /aws1/cx_miginternalserverex.
        MESSAGE 'Internal server error.' TYPE 'I'.
      CATCH /aws1/cx_migresourcenotfoundex.
        MESSAGE 'Image frame not found.' TYPE 'I'.
      CATCH /aws1/cx_migthrottlingex.
        MESSAGE 'Request throttled.' TYPE 'I'.
      CATCH /aws1/cx_migvalidationex.
        MESSAGE 'Validation error.' TYPE 'I'.
    ENDTRY.
```
+  Untuk detail API, lihat [GetImageFrame](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)di *AWS SDK untuk referensi SAP ABAP* API. 
 Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/mig#code-examples). 

------

**Ketersediaan contoh**  
Tidak dapat menemukan apa yang Anda butuhkan? Minta contoh kode menggunakan tautan **Berikan umpan balik** di bilah sisi kanan halaman ini.