

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

# Memahami pekerjaan impor
<a name="understanding-import-jobs"></a>

Setelah membuat [penyimpanan data](getting-started-concepts.md#concept-data-store) di AWS HealthImaging, Anda harus mengimpor data pencitraan medis dari bucket input Amazon S3 ke penyimpanan data untuk membuat kumpulan [gambar](getting-started-concepts.md#concept-image-set). Anda dapat menggunakan Konsol Manajemen AWS, AWS CLI, dan AWS SDKs untuk memulai, mendeskripsikan, dan daftar pekerjaan impor.

[Saat Anda mengimpor data DICOM P10 ke penyimpanan HealthImaging data AWS, layanan akan mencoba mengatur instans secara otomatis sesuai dengan hierarki DICOM Study UID, Series UID, Instance UID, berdasarkan elemen metadata.](understanding-image-sets.md) Data yang diimpor akan dibuat primer jika [elemen metadata](understanding-image-sets.md) dari data yang diimpor tidak bertentangan dengan [kumpulan gambar](getting-started-concepts.md#concept-image-set) primer yang ada di penyimpanan data. [Jika elemen metadata data DICOM P10 yang baru diimpor bertentangan dengan [kumpulan gambar primer yang ada, data baru akan ditambahkan ke kumpulan gambar](getting-started-concepts.md#concept-image-set) non-primer.](getting-started-concepts.md#concept-image-set) Saat data mengimpor membuat [kumpulan gambar](getting-started-concepts.md#concept-image-set) non-primer, AWS HealthImaging memancarkan EventBridge Peristiwa dengan`isPrimary: False`, dan catatan yang ditulis ke dalam objek juga `success.ndjson` akan ada di `isPrimary: False` dalam objek. `importResponse`

Saat Anda mengimpor data, HealthImaging lakukan hal berikut:
+ [Jika instance yang terdiri dari seri DICOM diimpor dalam satu pekerjaan impor dan instance tidak bertentangan dengan instance yang sudah ada di penyimpanan data, maka semua instance diatur ke dalam satu set gambar utama.](getting-started-concepts.md#concept-image-set)
+ [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 diatur sebagai satu set gambar Primer.](getting-started-concepts.md#concept-image-set)
+ Jika instance diimpor lebih dari sekali, versi terbaru akan menimpa versi lama yang disimpan dalam [kumpulan gambar](getting-started-concepts.md#concept-image-set) utama, dan nomor versi [kumpulan gambar](getting-started-concepts.md#concept-image-set) utama akan bertambah.

Anda dapat memperbarui instance di primer dengan langkah-langkah yang dijelaskan dalam [Memperbarui metadata set Gambar](update-image-set-metadata.md).

Selama impor, nilai biner dalam tag pribadi (dengan tipe VR OB, OD, OF, OL, OV, OW, UN) yang melebihi 1MB dalam ukuran disimpan secara terpisah dari metadata. Saat mengambil metadata untuk instance ini menggunakan `GetDICOMInstanceMetadata` or`GetDICOMSeriesMetadata`, nilai biner besar ini diganti dengan BulkDataURIs, dan data biner aktual dapat diambil menggunakan API. `GetDICOMBulkdata`

Ingatlah hal-hal berikut saat mengimpor file pencitraan medis Anda dari Amazon S3 ke HealthImaging penyimpanan data:
+ Instance yang sesuai dengan Seri DICOM akan secara otomatis digabungkan dalam satu set gambar, dilambangkan primer.
+ Anda dapat mengimpor data DICOM P10 dalam satu pekerjaan impor, atau beberapa pekerjaan impor, dan layanan akan mengatur instance ke dalam kumpulan gambar utama yang sesuai dengan Seri DICOM
+ Kendala panjang berlaku untuk elemen DICOM tertentu selama impor. Untuk memastikan pekerjaan impor berhasil, verifikasi bahwa data pencitraan medis Anda tidak melebihi batasan panjang. Untuk informasi selengkapnya, lihat [Kendala elemen DICOM](dicom-element-constraints.md).
+ Pemeriksaan verifikasi data piksel dilakukan di awal pekerjaan impor. Untuk informasi selengkapnya, lihat [Verifikasi data Pixel](pixel-data-verification.md).
+ Ada titik akhir, kuota, dan batas pelambatan yang terkait dengan tindakan impor. HealthImaging Untuk informasi selengkapnya, lihat [Titik akhir dan kuota](endpoints-quotas.md) dan [Batas pelambatan](throttling-limits.md).
+ Untuk setiap pekerjaan impor, hasil pemrosesan disimpan di `outputS3Uri` lokasi. Hasil pemrosesan diatur sebagai `job-output-manifest.json` file `SUCCESS` dan `FAILURE` folder.
**catatan**  
Anda dapat menyertakan hingga 10.000 folder bersarang untuk satu pekerjaan impor.
  + `job-output-manifest.json`File berisi `jobSummary` output dan rincian tambahan tentang data yang diproses. Contoh berikut menunjukkan output dari `job-output-manifest.json` file.

    ```
    {
    "jobSummary": {
    "jobId": "09876543210987654321098765432109",
            "datastoreId": "12345678901234567890123456789012",
            "inputS3Uri": "s3://medical-imaging-dicom-input/dicom_input/",
            "outputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/",
            "successOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/SUCCESS/",
            "failureOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/FAILURE/",
            "warningsOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/WARNING/",
            "numberOfScannedFiles": 5,
            "numberOfImportedFiles": 3,
            "numberOfFilesWithCustomerError": 2,
            "numberOfFilesWithServerError": 0,
            "numberOfGeneratedImageSets": 2,
            "imageSetsSummary": [{
    "imageSetId": "12345612345612345678907890789012",
                    "numberOfMatchedSOPInstances": 2
                },
                {
    "imageSetId": "12345612345612345678917891789012",
                    "numberOfMatchedSOPInstances": 1
                }
            ]
        }
    }
    ```
  + `SUCCESS`Folder menyimpan `success.ndjson` file yang berisi hasil dari semua file pencitraan yang berhasil diimpor. Contoh berikut menunjukkan output dari `success.ndjson` file.

    ```
    {"inputFile":"dicomInputFolder/1.3.51.5145.5142.20010109.1105620.1.0.1.dcm","importResponse":{"imageSetId":"12345612345612345678907890789012", "isPrimary": True}} 
    {"inputFile":"dicomInputFolder/1.3.51.5145.5142.20010109.1105630.1.0.1.dcm","importResponse":{"imageSetId":"12345612345612345678917891789012", "isPrimary": True}}
    ```
  + `FAILURE`Folder menyimpan `failure.ndjson` file yang berisi hasil dari semua file pencitraan yang tidak berhasil diimpor. Contoh berikut menunjukkan output dari `failure.ndjson` file.

    ```
    {"inputFile":"dicom_input/invalidDicomFile1.dcm","exception":{"exceptionType":"ValidationException","message":"DICOM attribute TransferSyntaxUID does not exist"}}
    {"inputFile":"dicom_input/invalidDicomFile2.dcm","exception":{"exceptionType":"ValidationException","message":"DICOM attributes does not exist"}}
    ```
  + `WARNING`Folder menyimpan `warning.ndjson` file yang berisi hasil dari semua file pencitraan yang berhasil diimpor tetapi dengan peringatan. Contoh berikut menunjukkan output dari `warning.ndjson` file.

    ```
    {"inputFile":"dicom_input/warningDicomFile1.dcm","importResponse":{"imageSetId":"12345612345612345678907890789012","imageSetVersion":1,"isPrimary":true,"warnings":[{"warning_reason_code":45330,"type":"InvalidOffsetTable","message":"The file was imported but contains an invalid offset table, may see issues when retrieving certain frames."}]}}
    ```
+ Pekerjaan impor disimpan dalam daftar pekerjaan selama 90 hari dan kemudian diarsipkan.