View a markdown version of this page

Mappatura dei codici tra terminologie con $translate - AWS HealthLake
UtilizzoParametri supportatiEsempiParametri di rispostaComportamentoGestione erroriAvvertenze

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à.

Mappatura dei codici tra terminologie con $translate

AWS HealthLake supporta il $translate funzionamento ConceptMap delle risorse, consentendoti di mappare un codice da un sistema di codice a un codice equivalente in un altro utilizzando i dati ConceptMaps che hai inserito nel tuo datastore. Questa operazione è particolarmente utile quando è necessario:

  • Mappare i codici tra le terminologie (ad esempio, ICD-10-CM su SNOMED CT)

  • Normalizza i dati in entrata in un sistema di codice canonico

  • Supporta l'interoperabilità tra sistemi che utilizzano terminologie diverse

  • Esegui l'analisi dei dati clinici standardizzando terminologie di origine eterogenee

Utilizzo

L'$translateoperazione può essere richiamata sulle ConceptMap risorse utilizzando i metodi GET e POST:

Operazioni supportate

GET  [base]/ConceptMap/$translate?url={...}&system={...}&code={...}
GET  [base]/ConceptMap/[id]/$translate?system={...}&code={...}
POST [base]/ConceptMap/$translate
POST [base]/ConceptMap/[id]/$translate

Parametri supportati

HealthLake supporta un sottoinsieme di parametri FHIR R4: $translate

Parametro Tipo Campo obbligatorio Description
code code Sì Il codice sorgente da tradurre
system uri Sì Il sistema di codice a cui appartiene il codice
url uri No URL canonico di uno specifico in base ConceptMap al quale tradurre
source uri No Si limita alle mappe il cui valore di origine impostato è uguale a questo URI
target uri No Si limita alle mappe il cui valore di destinazione impostato è uguale a questo URI
targetsystem uri No Limita le corrispondenze ai codici di destinazione in questo sistema di codice
Nota

I target parametri urlsource, e sono filtri di ambito che si applicano solo all'invocazione a livello di tipo (). [base]/ConceptMap/$translate Nell'istanza invocation (ConceptMap/[id]/$translate) vengono ignorati, solo come, e hanno effetto. code system targetsystem

Esempi

Richiesta GET (per ID) ConceptMap

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
Richiesta GET (tramite URL canonico)

GET [base]/ConceptMap/$translate?url=http://example.com/ConceptMap/sct-to-icd10&system=http://snomed.info/sct&code=44054006
Richiesta POST

POST [base]/ConceptMap/$translate
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "url",
      "valueUri": "http://example.com/ConceptMap/sct-to-icd10"
    },
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "44054006"
    },
    {
      "name": "targetsystem",
      "valueUri": "http://hl7.org/fhir/sid/icd-10-cm"
    }
  ]
}
Risposta di esempio

L'operazione restituisce una Parameters risorsa. Il result parametro indica se è stata trovata una corrispondenza. Ciascuno match contiene l'obiettivo concept e unequivalence:

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "match",
      "part": [
        {
          "name": "equivalence",
          "valueCode": "equivalent"
        },
        {
          "name": "concept",
          "valueCoding": {
            "system": "http://hl7.org/fhir/sid/icd-10-cm",
            "code": "E11.9",
            "display": "Type 2 diabetes mellitus without complications"
          }
        }
      ]
    }
  ]
}

Parametri di risposta

La risposta include i seguenti parametri:

Parametro Tipo Descrizione
result booleano Se è stata trovata una corrispondenza
match BackboneElement Una corrispondenza trovata nel ConceptMap
match.equivalence code Il grado di equivalenza tra i concetti di origine e di destinazione
match.concept Codifica Il concetto di destinazione (include sistema, codice e display)

Comportamento

L'$translateoperazione:

  1. Convalida i parametri richiesti (codeesystem).

  2. Risolve il problema per istanza [id] o ConceptMap per canonico. url

  3. Traduce il codice sorgente, filtrando facoltativamente le corrispondenze a quando fornito. targetsystem

  4. Restituisce result: true uno match per codice di destinazione equivalente o result: false quando non esiste alcuna mappatura.

Gestione errori

L'operazione gestisce le seguenti condizioni di errore:

  • 400 Richiesta non valida: richiesta non valida ($translaterichiesta non conforme o parametri obbligatori mancanti)

  • 404 Not Found: ConceptMap non trovato nel datastore

Avvertenze

In questa versione, non sono supportati:

  • reverseparametro (traduzione inversa dalla destinazione all'origine)

  • Traduzioni concatenate tra più ConceptMaps

  • Poiché più di 10 ConceptMap risorse possono corrispondere alla $translate query, ConceptMaps vengono restituite solo le corrispondenze delle prime 10, ordinate in base al date campo ConceptMap's (dalla più recente per prima).

Per ulteriori informazioni sulle specifiche dell'$translateoperazione, consulta la documentazione di FHIR R4 ConceptMap $translate.