As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Entendendo os relatórios de deriva

Quando a detecção de desvio está ativada, o trabalho em massa grava um relatório agregado com o nome do seu jobLevelDriftResult.json local de saída. O relatório informa a quantidade de dados de origem que o perfil realmente capturou e o que ele perdeu: para que você saiba onde melhorar seus mapeamentos.

A estrutura do relatório depende do formato de origem: os C-CDA relatórios são organizados em torno de seções e entradas do documento (identificadas por OIDs), enquanto os relatórios CSV são organizados em torno de tabelas, colunas e linhas. Ambos compartilham o mesmo conceito de taxa de cobertura (uma fração de 0,0 a 1,0, em que mais significa que mais de sua fonte foi capturada).

C-CDA relatório 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 
    }
}

Como interpretar o gráfico

Comece com as taxas de cobertura. Essas são as médias de todos os arquivos processados, expressas como uma fração de 0,0 a 1,0 (multiplique por 100 para obter uma porcentagem). Quanto maior, melhor: uma taxa mais alta significa que mais dados de origem chegaram à saída FHIR.

Em seguida, descubra o que foi perdido. Esses campos indicam os mapeamentos específicos a serem adicionados:

Priorize por frequência. As contagens unknownSections entramunknownEntries, e missingResources indicam quais lacunas afetam a maioria dos registros. Um OID que aparece 40 vezes é uma vitória maior para mapear do que um que aparece duas vezes.

Analise arquivos específicos. perFileDriftmapeia cada arquivo de origem para sua taxa de cobertura geral. Classifique pelos valores mais baixos para encontrar os arquivos que o perfil tratou pior: por exemplo, vale a pena patient-002.xml inspecionar 0,61. Para uma análise completa por arquivo (quais OIDs específicos cada arquivo perdeu), consulte os relatórios individuais na driftDetectionPerFileResults/ pasta.

Melhorando a cobertura

Relatório de deriva em CSV

Para trabalhos CSV, o relatório é organizado em torno de tabelas (cada arquivo CSV é uma tabela), colunas e linhas, não seções e 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"
    }
  ]
}

Como interpretar o gráfico

Comece com o resumo. As taxas de cobertura são frações de 0,0 a 1,0 (quanto maior, melhor):

Em seguida, verifique as contagens para entender os resultados da conversão:

Em seguida, descubra o que foi perdido:

Relatório de desvio de sincronização de CSV

Como interpretar o gráficodescreve o formato em massa (assíncrono) que um trabalho de transformação grava no Amazon S3. Quando você executa a detecção de desvio de forma síncrona, a resposta da API inclui o relatório de desvio de valores separados por vírgula (CSV) em linha. Para ativar isso, enableDriftDetection defina como true em uma TransformData solicitação. Como uma solicitação de sincronização processa uma única entrada em vez de um conjunto de dados inteiro, seu relatório tem uma estrutura mais simples.

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

Os unmappedColumns campos summaryunmappedTables,, e têm o mesmo significado que no relatório em massa. O relatório de sincronização difere do relatório CSV em massa das seguintes maneiras:

Melhorando a cobertura (ambos os formatos)