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.

Entender los informes de derivas

Cuando la detección de desviaciones está habilitada, el trabajo masivo escribe un informe agregado jobLevelDriftResult.json con el nombre de su ubicación de salida. El informe indica qué cantidad de datos de origen capturó realmente el perfil y qué pasó por alto, para que sepa dónde mejorar sus mapeos.

La estructura del informe depende del formato de origen: los C-CDA informes se organizan en torno a secciones y entradas del documento (identificadas mediante OID), mientras que los informes en formato CSV se organizan en tablas, columnas y filas. Ambos comparten el mismo concepto de tasa de cobertura (una fracción de 0.0 a 1.0, donde más alta significa que se ha capturado una mayor cantidad de la fuente).

C-CDA informe de deriva

{
  "jobId": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "profileId": "0f1e2d3c4b5a69788796a5b4c3d2e1f0",
  "profileVersion": 3,
  "timestamp": "2026-07-14T18:30:00Z",
  "filesProcessed": 500,
  "totalFilesFailed": 2,
  "avgSectionCoverageRate": 0.92,
  "avgEntryCoverageRate": 0.85,
  "avgOverallCoverageRate": 0.88,
  "avgResourceAccuracy": 0.97,
  "totalUnknownSections": 14,
  "totalUnknownEntries": 63,
  "documentOids": { 
    "2.16.840.1.113883.10.20.22.1.2": 480 
    },
  "unknownSectionOidCount": 2,
  "unknownSections": { 
    "2.16.840.1.113883.10.20.22.2.14": 12 
    },
  "unknownEntryOidCount": 5,
  "unknownEntries": { 
    "2.16.840.1.113883.10.20.22.4.13": 40 
    },
  "missingResources": { 
    "2.16.840.1.113883.10.20.22.2.6.1": { 
      "AllergyIntolerance": 8 
      } 
    },
  "perFileDrift": { 
    "patient-001.xml": 0.95, 
    "patient-002.xml": 0.61 
    }
}

Cómo leerlo

Comience con las tasas de cobertura. Se trata de los promedios de todos los archivos procesados, expresados como una fracción de 0.0 a 1.0 (multiplica por 100 para obtener un porcentaje). Cuanto más, mejor: una velocidad más alta significa que una mayor cantidad de los datos de origen se incluyen en la salida del FHIR.

Luego encuentra lo que se perdió. Estos campos indican las asignaciones específicas que se deben agregar:

Prioriza por frecuencia. Los recuentos son unknownSectionsunknownEntries, y missingResources le indican qué brechas afectan a la mayoría de los registros. Un OID que aparezca 40 veces es más rentable para el mapa que uno que aparezca dos veces.

Profundice en archivos específicos. perFileDriftasigna cada archivo fuente a su tasa de cobertura general. Ordene por los valores más bajos para encontrar los archivos que el perfil manejó peor: por ejemplo, patient-002.xml vale la pena inspeccionar un valor de 0.61. Para ver un desglose completo por archivo (qué OID específicos omitió cada archivo), consulta los informes individuales en la carpeta. driftDetectionPerFileResults/

Mejorar la cobertura

Informe de desviaciones en CSV

En el caso de los trabajos en formato CSV, el informe se organiza en tablas (cada archivo CSV es una tabla), columnas y filas, no en secciones ni OID.

{
  "jobId": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "profileId": "0f1e2d3c4b5a69788796a5b4c3d2e1f0",
  "profileVersion": 3,
  "summary": {
    "totalTablesInProfile": 4,
    "totalTablesInInput": 5,
    "tablesProcessed": 4,
    "tablesUnmapped": 1,
    "totalColumnsInInput": 42,
    "columnsMapped": 35,
    "columnsUnmapped": 7,
    "totalRowsScanned": 120000,
    "rowsConvertedSuccessfully": 119850,
    "rowsFailedCustomerError": 140,
    "rowsFailedServerError": 10,
    "totalResourcesGenerated": 245000,
    "tablesCoverageRate": 0.80,
    "columnsCoverageRate": 0.83,
    "overallCoverageRate": 0.83
  },
  "unmappedTables": [
    {
      "tableName": "billing",
      "fileName": "billing.csv",
      "reason": "No matching table declared in the mapping profile",
      "columns": ["invoice_id", "amount", "payer"]
    }
  ],
  "unmappedColumns": [
    {
      "tableName": "patients",
      "columns": ["preferred_language", "ethnicity_detail"],
      "reason": "Present in CSV but not referenced by any field mapping"
    }
  ]
}

Cómo leerlo

Empieza con el resumen. Las tasas de cobertura son fracciones de 0.0 a 1.0 (cuanto más alto, mejor):

A continuación, compruebe los recuentos para comprender los resultados de la conversión:

Luego encuentra lo que se perdió:

Sincronice el informe de derivaciones en

Cómo leerlodescribe el formato masivo (asincrónico) que un trabajo de transformación escribe en Amazon S3. Cuando ejecuta la detección de desviaciones de forma sincrónica, la respuesta de la API incluye el informe de desviaciones de valores separados por comas (CSV) en línea. Para habilitarlo, configúralo en una solicitudenableDriftDetection. true TransformData Como una solicitud de sincronización procesa una sola entrada en lugar de un conjunto de datos completo, su informe tiene una estructura más simple.

{
  "sourceFormat": "CSV",
  "summary": {
    "totalTablesInProfile": 1,
    "totalTablesInInput": 1,
    "tablesProcessed": 1,
    "tablesUnmapped": 0,
    "totalColumnsInInput": 10,
    "columnsMapped": 7,
    "columnsUnmapped": 3,
    "totalRowsProcessed": 2,
    "totalResourcesGenerated": 2,
    "tablesCoverageRate": 1.0,
    "columnsCoverageRate": 0.7,
    "perTableRowCounts": { "patients": 2 }
  },
  "unmappedTables": [],
  "unmappedColumns": [
    {
      "tableName": "patients",
      "columns": ["ETHNICITY", "LANGUAGE", "NICKNAME"],
      "reason": "Columns present in CSV but not referenced in any field mapping"
    }
  ],
  "warnings": []
}

Los unmappedColumns campos summaryunmappedTables, y tienen el mismo significado que en el informe masivo. El informe de sincronización difiere del informe CSV masivo en los siguientes aspectos:

Mejorar la cobertura (ambos formatos)