View a markdown version of this page

Zuordnen von Codes zwischen Terminologien mit $translate - AWS HealthLake
UsageUnterstützte ParameterBeispieleAntwortparameterBehaviorFehlerbehandlungEinschränkungen

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.

Zuordnen von Codes zwischen Terminologien mit $translate

AWS HealthLake unterstützt die $translate Operation für ConceptMap Ressourcen und ermöglicht es Ihnen, einen Code von einem Codesystem einem entsprechenden Code in einem anderen zuzuordnen, indem ConceptMaps Sie ihn in Ihren Datenspeicher aufgenommen haben. Diese Operation ist besonders nützlich, wenn Sie:

  • Ordnen Sie Codes zwischen Terminologien ICD-10-CM zu (z. B. SNOMED CT)

  • Normalisieren Sie eingehende Daten auf ein kanonisches Codesystem

  • Unterstützen Sie die Interoperabilität zwischen Systemen, die unterschiedliche Terminologien verwenden

  • Führen Sie klinische Datenanalysen durch, indem Sie heterogene Quellterminologien standardisieren

Usage

Die $translate Operation kann mit den Methoden GET und POST ConceptMap für Ressourcen aufgerufen werden:

Unterstützte Vorgänge

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

Unterstützte Parameter

HealthLake unterstützt eine Teilmenge von FHIR R4-Parametern: $translate

Parameter Typ Erforderlich Description
code Code Ja Der zu übersetzende Quellcode
system uri Ja Das Codesystem, zu dem der Code gehört
url uri Nein Kanonische URL einer bestimmten Person, gegen die übersetzt werden ConceptMap soll
source uri Nein Beschränkt auf Maps, deren Quellwertsatz diesem URI entspricht
target uri Nein Beschränkt sich auf Maps, deren Zielwertsatz diesem URI entspricht
targetsystem uri Nein Schränkt Übereinstimmungen auf Zielcodes in diesem Codesystem ein
Anmerkung

Die target Parameter urlsource, und sind Bereichsfilter, die nur für den Aufruf auf Typebene gelten (). [base]/ConceptMap/$translate Beim Instanzaufruf (ConceptMap/[id]/$translate) werden sie als einzige code ignoriert und targetsystem werden system wirksam.

Beispiele

GET-Anfrage (nach ConceptMap ID)

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
GET-Anfrage (anhand einer kanonischen URL)

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

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

Die Operation gibt eine Parameters Ressource zurück. Der result Parameter gibt an, ob eine Übereinstimmung gefunden wurde. Jeder match enthält das Ziel concept und einequivalence:

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

Antwortparameter

Die Antwort umfasst die folgenden Parameter:

Parameter Typ Beschreibung
result boolesch Ob eine Übereinstimmung gefunden wurde
match BackboneElement Eine Übereinstimmung wurde in der gefunden ConceptMap
match.equivalence Code Der Grad der Äquivalenz zwischen dem Quell- und dem Zielkonzept
match.concept Codierung Das Zielkonzept (umfasst System, Code und Display)

Behavior

Die $translate Operation:

  1. Validiert die erforderlichen Parameter (codeundsystem).

  2. Löst den Wert ConceptMap by instance [id] oder by canonical auf. url

  3. Übersetzt den Quellcode und filtert optional Treffer heraus, sofern vorhanden. targetsystem

  4. Gibt result: true einen match pro äquivalenten Zielcode zurück oder result: false wenn keine Zuordnung vorhanden ist.

Fehlerbehandlung

Der Vorgang behandelt die folgenden Fehlerbedingungen:

  • 400 Bad Request: Ungültige $translate Anfrage (nicht konforme Anfrage oder fehlende erforderliche Parameter)

  • 404 Nicht gefunden: wurde ConceptMap nicht im Datenspeicher gefunden

Einschränkungen

In dieser Version wird Folgendes nicht unterstützt:

  • reverseParameter (umgekehrte Übersetzung vom Ziel zur Quelle)

  • Verkettete Übersetzungen über mehrere ConceptMaps

  • Da mehr als 10 ConceptMap Ressourcen mit der $translate Abfrage übereinstimmen können, ConceptMaps werden nur Treffer aus den ersten 10 zurückgegeben, sortiert nach dem date Feld „ ConceptMaps“ (die neuesten zuerst).

Weitere Informationen zur $translate Betriebsspezifikation finden Sie in der FHIR R4-Dokumentation ConceptMap $translate.