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 report di deriva

Quando il rilevamento della deriva è abilitato, il job in blocco scrive un report aggregato con il nome della posizione jobLevelDriftResult.json di output. Il rapporto indica quanti dati di origine sono stati effettivamente acquisiti dal profilo e quali sono gli elementi mancanti: in questo modo saprai dove migliorare le tue mappature.

La struttura del rapporto dipende dal formato di origine: i C-CDA report sono organizzati in sezioni e voci del documento (identificate da OID), mentre i report CSV sono organizzati in tabelle, colonne e righe. Entrambi condividono lo stesso concetto di tasso di copertura (una frazione da 0,0 a 1,0, dove più alto significa che è stata acquisita una parte maggiore della fonte).

C-CDA rapporto di 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 
    }
}

Come leggere i dati

Inizia con i tassi di copertura. Si tratta delle medie di tutti i file elaborati, espresse come frazione da 0,0 a 1,0 (moltiplicate per 100 per una percentuale). Maggiore è meglio: una velocità più alta significa che una quantità maggiore di dati di origine è stata inserita nell'output FHIR.

Quindi trova ciò che è mancato. Questi campi indicano le mappature specifiche da aggiungere:

Assegna priorità in base alla frequenza. Conta e missingResources indica quali sono unknownEntries le lacune che influiscono maggiormente sui record. unknownSections Un OID che appare 40 volte equivale a una vincita maggiore da mappare rispetto a uno che appare due volte.

Analizza file specifici. perFileDriftmappa ogni file sorgente in base al suo tasso di copertura complessivo. Ordina in base ai valori più bassi per trovare i file gestiti peggio dal profilo: ad esempio, vale la pena controllarli con un valore pari patient-002.xml a 0,61. Per un'analisi completa dei singoli file (quali OID specifici non sono stati rilevati da ciascun file), consulta i singoli report contenuti nella cartella. driftDetectionPerFileResults/

Miglioramento della copertura

Rapporto sulla deriva in formato CSV

Per i lavori CSV, il report è organizzato in tabelle (ogni file CSV è una tabella), colonne e righe: non sezioni e 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"
    }
  ]
}

Come leggere i dati

Inizia con il riepilogo. I tassi di copertura sono frazioni da 0,0 a 1,0 (più alto è meglio):

Quindi controlla i conteggi per comprendere i risultati della conversione:

Quindi trova ciò che è mancato:

Sincronizza il rapporto di deriva in formato CSV

Come leggere i datidescrive il formato di massa (asincrono) che un processo di trasformazione scrive su Amazon S3. Quando esegui il rilevamento della deriva in modo sincrono, la risposta dell'API include il rapporto di deriva con valori separati da virgole (CSV) in linea. Per abilitarlo, imposta su su richiesta. enableDriftDetection true TransformData Poiché una richiesta di sincronizzazione elabora un singolo input anziché un intero set di dati, il relativo report ha una struttura più semplice.

{
  "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": []
}

I unmappedColumns campi summaryunmappedTables, e hanno lo stesso significato del rapporto collettivo. Il rapporto di sincronizzazione differisce dal rapporto CSV in blocco nei seguenti modi:

Miglioramento della copertura (entrambi i formati)