Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Drift-Berichte verstehen

Wenn die Drift-Erkennung aktiviert ist, schreibt der Bulk-Job einen Aggregatbericht, der jobLevelDriftResult.json nach Ihrem Ausgabespeicherort benannt ist. Der Bericht informiert Sie darüber, wie viele Ihrer Quelldaten das Profil tatsächlich erfasst hat und was dabei übersehen wurde. So wissen Sie, wo Sie Ihre Zuordnungen verbessern können.

Die Struktur des Berichts hängt vom Quellformat ab: C-CDA Berichte sind nach Dokumentabschnitten und -einträgen (gekennzeichnet durch OIDs) organisiert, während CSV-Berichte nach Tabellen, Spalten und Zeilen organisiert sind. Beide verwenden das gleiche Konzept für die Deckungsrate (ein Bruchteil von 0,0 bis 1,0, wobei höher bedeutet, dass mehr von Ihrer Quelle erfasst wurde).

C-CDA Drift-Bericht

{
  "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 
    }
}

So wird es interpretiert

Beginnen Sie mit den Deckungsraten. Dabei handelt es sich um Durchschnittswerte aller verarbeiteten Dateien, ausgedrückt als Bruchteil von 0,0 bis 1,0 (multipliziert mit 100 für einen Prozentsatz). Höher ist besser: Eine höhere Rate bedeutet, dass mehr Ihrer Quelldaten in die FHIR-Ausgabe eingegangen sind.

Finden Sie dann heraus, was verpasst wurde. Diese Felder verweisen Sie auf die spezifischen Zuordnungen, die Sie hinzufügen müssen:

Priorisieren Sie nach Häufigkeit. Die Zahlen werden eingegeben unknownSections und unknownEntries geben missingResources Aufschluss darüber, welche Lücken die meisten Datensätze betreffen. Eine OID, die 40-mal erscheint, ist ein größerer Gewinn für die Map als eine, die zweimal erscheint.

Untersuchen Sie bestimmte Dateien. perFileDriftordnet jede Quelldatei ihrer Gesamtabdeckungsrate zu. Sortieren Sie nach den niedrigsten Werten, um die Dateien zu finden, die das Profil patient-002.xml am schlechtesten verarbeitet hat. Ein Wert von 0,61 ist beispielsweise eine Überprüfung wert. Eine vollständige Aufschlüsselung pro Datei (welche spezifischen OIDs in jeder Datei übersehen wurden) finden Sie in den einzelnen Berichten unter dem Ordner. driftDetectionPerFileResults/

Verbesserung der Reichweite

CSV-Driftbericht

Bei CSV-Aufträgen besteht der Bericht aus Tabellen (jede CSV-Datei ist eine Tabelle), Spalten und Zeilen, nicht aus Abschnitten und OIDs.

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

So wird es interpretiert

Beginnen Sie mit der Zusammenfassung. Die Deckungsraten sind Bruchteile von 0,0 bis 1,0 (höher ist besser):

Überprüfen Sie dann die Anzahl, um die Konvertierungsergebnisse zu verstehen:

Dann finde heraus, was verpasst wurde:

CSV-Drift-Bericht synchronisieren

So wird es interpretiertbeschreibt das Massenformat (asynchron), das ein Transformationsauftrag in Amazon S3 schreibt. Wenn Sie die Drift-Erkennung synchron ausführen, enthält die API-Antwort den Drift-Bericht mit kommagetrennten Werten (CSV) als Inline. Um dies zu aktivieren, setzen Sie in enableDriftDetection einer Anfrage true auf. TransformData Da eine Synchronisierungsanforderung eine einzelne Eingabe und nicht einen ganzen Datensatz verarbeitet, hat der Bericht eine einfachere Struktur.

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

Die unmappedColumns Felder summaryunmappedTables, und haben dieselbe Bedeutung wie im Massenbericht. Der Synchronisierungsbericht unterscheidet sich in den folgenden Punkten vom CSV-Massenbericht:

Verbesserung der Abdeckung (beide Formate)