

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Comprendere i lavori di importazione
<a name="understanding-import-jobs"></a>

[Dopo aver creato un [data store](getting-started-concepts.md#concept-data-store) in AWS HealthImaging, devi importare i dati di imaging medicale dal bucket di input Amazon S3 nel tuo data store per creare set di immagini.](getting-started-concepts.md#concept-image-set) Puoi usare, e AWS SDKs per iniziare Console di gestione AWS AWS CLI, descrivere ed elencare i lavori di importazione.

[Quando importi i dati DICOM P10 in un data store HealthImaging AWS, il servizio tenta di organizzare automaticamente le istanze in base alla gerarchia DICOM di Study UID, Series UID, Instance UID, in base agli elementi di metadati.](understanding-image-sets.md) [I dati importati verranno resi primari se [gli elementi di metadati dei](understanding-image-sets.md) dati importati non sono in conflitto con i set di immagini primarie esistenti nell'archivio dati.](getting-started-concepts.md#concept-image-set) [Se gli elementi di metadati dei dati DICOM P10 appena importati sono in conflitto con i set di [immagini primarie esistenti, i nuovi dati verranno aggiunti ai set](getting-started-concepts.md#concept-image-set) di immagini non primari.](getting-started-concepts.md#concept-image-set) Quando le importazioni di dati creano [set di immagini](getting-started-concepts.md#concept-image-set) non primari, AWS HealthImaging emette un EventBridge evento con `isPrimary: False` e il record scritto su `success.ndjson` sarà presente anche `isPrimary: False` all'interno dell'`importResponse`oggetto.

Quando importi dati, HealthImaging effettua le seguenti operazioni:
+ [Se le istanze che comprendono una serie DICOM vengono importate in un processo di importazione e non sono in conflitto con le istanze già presenti nell'archivio dati, tutte le istanze vengono organizzate in un unico set di immagini primario.](getting-started-concepts.md#concept-image-set)
+ [Se le istanze che comprendono una serie DICOM vengono importate in due o più processi di importazione e non sono in conflitto con le istanze già presenti nell'archivio dati, tutte le istanze sono organizzate come un unico set di immagini primario.](getting-started-concepts.md#concept-image-set)
+ [Se un'istanza viene importata più di una volta, la versione più recente sovrascriverà qualsiasi versione precedente memorizzata in un set di [immagini primario e il numero di versione del set di immagini](getting-started-concepts.md#concept-image-set) primario verrà incrementato.](getting-started-concepts.md#concept-image-set)

È possibile aggiornare le istanze del set di immagini principale seguendo i passaggi descritti in [Aggiornamento dei metadati del set di immagini](update-image-set-metadata.md).

Durante l'importazione, i valori binari nei tag privati (con i tipi VR OB, OD, OF, OL, OV, OW, UN) che superano 1 MB di dimensione vengono memorizzati separatamente dai metadati. Quando si recuperano i metadati per queste istanze utilizzando `GetDICOMInstanceMetadata` or`GetDICOMSeriesMetadata`, questi valori binari di grandi dimensioni vengono sostituiti con BulkData URIs e i dati binari effettivi possono essere recuperati utilizzando l'API. `GetDICOMBulkdata`

Tieni a mente i seguenti punti quando importi i tuoi file di immagini mediche da Amazon S3 in HealthImaging un data store:
+ Le istanze corrispondenti a una serie DICOM verranno automaticamente combinate in un unico set di immagini, denominato principale.
+ È possibile importare i dati DICOM P10 in uno o più processi di importazione e il servizio organizzerà le istanze in set di immagini principali che corrispondono alla serie DICOM
+ I vincoli di lunghezza si applicano a elementi DICOM specifici durante l'importazione. Per garantire una corretta operazione di importazione, verificate che i dati di imaging medicale non superino i limiti di lunghezza. Per ulteriori informazioni, consulta [Vincoli degli elementi DICOM](dicom-element-constraints.md).
+ All'inizio dei processi di importazione viene eseguito un controllo di verifica dei dati relativi ai pixel. Per ulteriori informazioni, consulta [Verifica dei dati relativi ai pixel](pixel-data-verification.md).
+ Esistono endpoint, quote e limiti di limitazione associati alle azioni di importazione. HealthImaging Per ulteriori informazioni, consultare [Endpoint e quote](endpoints-quotas.md) e [Limiti di limitazione](throttling-limits.md).
+ Per ogni processo di importazione, i risultati di elaborazione vengono archiviati nella posizione. `outputS3Uri` I risultati dell'elaborazione sono organizzati in `job-output-manifest.json` file `SUCCESS` e `FAILURE` cartelle.
**Nota**  
È possibile includere fino a 10.000 cartelle annidate per un singolo processo di importazione.
  + Il `job-output-manifest.json` file contiene `jobSummary` output e dettagli aggiuntivi sui dati elaborati. L'esempio seguente mostra l'output di un `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
                }
            ]
        }
    }
    ```
  + La `SUCCESS` cartella contiene il `success.ndjson` file contenente i risultati di tutti i file di immagine importati correttamente. L'esempio seguente mostra l'output di un `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}}
    ```
  + La `FAILURE` cartella contiene il `failure.ndjson` file contenente i risultati di tutti i file di immagine che non sono stati importati correttamente. L'esempio seguente mostra l'output di un `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"}}
    ```
  + La `WARNING` cartella contiene il `warning.ndjson` file contenente i risultati di tutti i file di immagine importati correttamente ma con avvertenze. L'esempio seguente mostra l'output di un `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."}]}}
    ```
+ I lavori di importazione vengono conservati nell'elenco dei lavori per 90 giorni e quindi archiviati.