Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memahami laporan drift

Saat deteksi penyimpangan diaktifkan, pekerjaan massal menulis laporan agregat yang diberi nama jobLevelDriftResult.json ke lokasi keluaran Anda. Laporan ini memberi tahu Anda berapa banyak data sumber Anda yang sebenarnya diambil profil, dan apa yang terlewatkan: sehingga Anda tahu di mana harus meningkatkan pemetaan Anda.

Struktur laporan tergantung pada format sumber: C-CDA laporan diatur di sekitar bagian dokumen dan entri (diidentifikasi oleh OID), sedangkan laporan CSV diatur di sekitar tabel, kolom, dan baris. Keduanya berbagi konsep tingkat cakupan yang sama (pecahan dari 0,0 hingga 1,0, di mana lebih tinggi berarti lebih banyak sumber Anda ditangkap).

C-CDA laporan drift

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

Cara membacanya

Mulailah dengan tingkat cakupan. Ini adalah rata-rata di semua file yang diproses, dinyatakan sebagai pecahan dari 0,0 hingga 1,0 (kalikan dengan 100 untuk persentase). Lebih tinggi lebih baik: tingkat yang lebih tinggi berarti lebih banyak data sumber Anda yang masuk ke output FHIR.

Kemudian temukan apa yang terlewatkan. Bidang-bidang ini mengarahkan Anda ke pemetaan tertentu untuk ditambahkan:

Prioritaskan berdasarkan frekuensi. TerhitungunknownSections,unknownEntries, dan missingResources memberi tahu Anda celah mana yang mempengaruhi catatan paling banyak. OID yang muncul 40 kali adalah kemenangan yang lebih besar untuk dipetakan daripada yang muncul dua kali.

Bor ke dalam file tertentu. perFileDriftmemetakan setiap file sumber ke tingkat cakupan keseluruhannya. Urutkan berdasarkan nilai terendah untuk menemukan file yang ditangani profil terburuk: misalnya, patient-002.xml pada 0,61 layak diperiksa. Untuk perincian lengkap per file (OID spesifik mana yang dilewatkan setiap file), lihat laporan individual di bawah driftDetectionPerFileResults/ folder.

Meningkatkan cakupan

Laporan penyimpangan CSV

Untuk pekerjaan CSV, laporan diatur di sekitar tabel (setiap file CSV adalah tabel), kolom, dan baris: bukan bagian dan 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"
    }
  ]
}

Cara membacanya

Mulailah dengan ringkasan. Tingkat cakupan adalah pecahan dari 0,0 hingga 1,0 (lebih tinggi lebih baik):

Kemudian periksa hitungannya untuk memahami hasil konversi:

Kemudian temukan apa yang terlewatkan:

Sinkronkan laporan penyimpangan CSV

Cara membacanyamenjelaskan format massal (asinkron) yang ditulis oleh pekerjaan transformasi ke Amazon S3. Saat Anda menjalankan deteksi penyimpangan secara serempak, respons API menyertakan laporan penyimpangan nilai yang dipisahkan koma (CSV) sebaris. Untuk mengaktifkan ini, atur enableDriftDetection ke true atas TransformData permintaan. Karena permintaan sinkronisasi memproses satu input daripada seluruh dataset, laporannya memiliki struktur yang lebih sederhana.

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

Bid summary angunmappedTables,, dan unmappedColumns memiliki arti yang sama seperti dalam laporan massal. Laporan sinkronisasi berbeda dari laporan CSV massal dengan cara berikut:

Meningkatkan cakupan (kedua format)