

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Introducción a los trabajos de importación
<a name="understanding-import-jobs"></a>

Tras crear un [almacén de datos](getting-started-concepts.md#concept-data-store) en AWS HealthImaging, debe importar los datos de imágenes médicas de su depósito de entrada de Amazon S3 a su almacén de datos para crear [conjuntos de imágenes](getting-started-concepts.md#concept-image-set). Puede usar los campos Consola de administración de AWS AWS CLI, y AWS SDKs para iniciar, describir y enumerar los trabajos de importación.

[Al importar los datos de DICOM P10 a un almacén de datos de AWS HealthImaging , el servicio intenta organizar automáticamente las instancias según la jerarquía DICOM de UID de estudio, UID de serie y UID de instancia, en función de los elementos de metadatos.](understanding-image-sets.md) Los datos importados pasarán a ser principales si los [elementos de metadatos de los](understanding-image-sets.md) datos importados no entran en conflicto con los conjuntos de [imágenes](getting-started-concepts.md#concept-image-set) principales existentes en el almacén de datos. [Si los elementos de metadatos de los datos del DICOM P10 recién importados entran en conflicto con los [conjuntos de imágenes](getting-started-concepts.md#concept-image-set) principales existentes, los nuevos datos se añadirán a los conjuntos de imágenes no principales.](getting-started-concepts.md#concept-image-set) Cuando las importaciones de datos crean [conjuntos de imágenes](getting-started-concepts.md#concept-image-set) no principales, AWS HealthImaging emite un EventBridge evento con `isPrimary: False` el objeto y el registro escrito en él también `success.ndjson` estará `isPrimary: False` dentro del `importResponse` objeto.

Al importar datos, HealthImaging hace lo siguiente:
+ Si las instancias que componen una serie DICOM se importan en un trabajo de importación y las instancias no entran en conflicto con las que ya se encuentran en el banco de datos, todas las instancias se organizan en un [conjunto de imágenes](getting-started-concepts.md#concept-image-set) principal.
+ Si las instancias que componen una serie DICOM se importan en dos o más trabajos de importación y las instancias no entran en conflicto con las que ya se encuentran en el banco de datos, todas las instancias se organizan como un conjunto de [imágenes](getting-started-concepts.md#concept-image-set) principal.
+ Si una instancia se importa más de una vez, la última versión sobrescribirá cualquier versión anterior almacenada en un [conjunto de imágenes](getting-started-concepts.md#concept-image-set) principal y se incrementará el número de versión del [conjunto de imágenes](getting-started-concepts.md#concept-image-set) principal.

Puedes actualizar las instancias de la instancia principal siguiendo los pasos que se describen en [Actualización de los metadatos del conjunto de imágenes](update-image-set-metadata.md).

Durante la importación, los valores binarios de las etiquetas privadas (con los tipos VR OB, OD, OF, OL, OV, OW, UN) que superen el tamaño de 1 MB se almacenan por separado de los metadatos. Al recuperar los metadatos de estas instancias mediante `GetDICOMInstanceMetadata` o`GetDICOMSeriesMetadata`, estos valores binarios grandes se sustituyen por BulkDataURIs, y los datos binarios reales se pueden recuperar mediante la `GetDICOMBulkdata` API.

Tenga en cuenta los siguientes puntos al importar sus archivos de imágenes médicas de Amazon S3 a un almacén de HealthImaging datos:
+ Las instancias correspondientes a una serie DICOM se combinarán automáticamente en un único conjunto de imágenes, denominado primario.
+ Puede importar los datos del DICOM P10 en un trabajo de importación o en varios trabajos de importación, y el servicio organizará las instancias en conjuntos de imágenes principales que correspondan a la serie DICOM
+ Durante la importación, se aplican restricciones de longitud a elementos DICOM específicos. Para que la importación sea correcta, asegúrese de que sus datos de imágenes médicas no superen las restricciones de longitud máxima. Para obtener más información, consulte [Restricciones de los elementos DICOM](dicom-element-constraints.md).
+ Al principio de los trabajos de importación, se comprueba la verificación de los datos en píxeles. Para obtener más información, consulte [Verificación de datos de píxeles](pixel-data-verification.md).
+ Hay puntos finales, cuotas y límites de limitación asociados a las acciones de importación. HealthImaging Para obtener más información, consulte [Cuotas y puntos de conexión](endpoints-quotas.md) y [Límites de limitación](throttling-limits.md).
+ Para cada trabajo de importación, los resultados del procesamiento se almacenan en la ubicación `outputS3Uri`. Los resultados del procesamiento se organizan en un archivo `job-output-manifest.json` y en las carpetas `SUCCESS` y `FAILURE`.
**nota**  
Puede incluir hasta 10 000 carpetas anidadas para un solo trabajo de importación.
  + El archivo `job-output-manifest.json` contiene el resultado de salida `jobSummary` e información adicional sobre los datos procesados. El ejemplo siguiente muestra la salida de un archivo `job-output-manifest.json`.

    ```
    {
    "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 carpeta `SUCCESS` contiene el archivo `success.ndjson` con los resultados de todos los archivos de imágenes que se importaron correctamente. El ejemplo siguiente muestra la salida de un archivo `success.ndjson`.

    ```
    {"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 carpeta `FAILURE` contiene el archivo `failure.ndjson` con los resultados de todos los archivos de imágenes que no se importaron correctamente. El ejemplo siguiente muestra la salida de un archivo `failure.ndjson`.

    ```
    {"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` carpeta contiene el `warning.ndjson` archivo que contiene los resultados de todos los archivos de imágenes que se importaron correctamente pero con advertencias. El ejemplo siguiente muestra la salida de un archivo `warning.ndjson`.

    ```
    {"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."}]}}
    ```
+ Los trabajos de importación se conservan en la lista de trabajos durante 90 días y, a continuación, se archivan.