Konzeptdetails abrufen mit $lookup - AWS HealthLake
VerwendungUnterstü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.

Konzeptdetails abrufen mit $lookup

AWS HealthLake unterstützt jetzt den $lookup Vorgang für CodeSystem Ressourcen, sodass Sie Details zu einem bestimmten Konzept in einem Codesystem abrufen können, indem Sie identifizierende Informationen wie den zugehörigen Code angeben. Diese Operation ist besonders nützlich, wenn Sie:

  • Rufen Sie detaillierte Informationen zu bestimmten medizinischen Codes ab

  • Überprüfen Sie die Bedeutungen und Eigenschaften von Codes

  • Greifen Sie auf Konzeptdefinitionen und Beziehungen zu

  • Support Sie klinische Entscheidungen mit genauen Terminologiedaten

Verwendung

Der $lookup Vorgang kann für CodeSystem Ressourcen sowohl mit der GET- als auch mit der POST-Methode aufgerufen werden:

Unterstützte Vorgänge

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup

Unterstützte Parameter

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

Parameter Typ Erforderlich Beschreibung
code Code Ja Der Konzeptcode, nach dem Sie suchen (z. B. „71620000" in SNOMED CT)
system uri Ja Die kanonische URL des Codesystems (z. B. "http://snomed.info/sct „)
version Zeichenfolge Nein Spezifische Version des Codesystems

Beispiele

GET-Anfrage

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
POST-Anfrage

POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
Beispielantwort

Die Operation gibt eine Parameter-Ressource zurück, die die Konzeptdetails enthält:

{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}

Antwortparameter

Die Antwort enthält, sofern verfügbar, die folgenden Parameter:

Parameter Typ Beschreibung
name Zeichenfolge Name des Codesystems
version Zeichenfolge Version des Codesystems
display Zeichenfolge Anzeigename des Konzepts
designation BackboneElement Zusätzliche Darstellungen für dieses Konzept.
property BackboneElement Zusätzliche Eigenschaften des Konzepts (Definition, Beziehungen usw.)

Behavior

Die $lookup Operation:

  1. Validiert die erforderlichen Parameter (codeundsystem)

  2. Sucht innerhalb des angegebenen Codesystems, das im Datenspeicher gespeichert ist, nach dem Konzept

  3. Gibt detaillierte Konzeptinformationen zurück, einschließlich Anzeigenamen, Bezeichnungen und Eigenschaften.

  4. Unterstützt versionsspezifische Suchvorgänge, wenn der Parameter angegeben wird version

  5. Funktioniert nur auf Codesystemen, die explizit im Datenspeicher gespeichert sind HealthLake

Fehlerbehandlung

Der Vorgang behandelt die folgenden Fehlerbedingungen:

  • 400 Schlechte Anfrage: Ungültiger $lookup Vorgang (fehlerhafte Anfrage oder fehlende erforderliche Parameter)

  • 404 Nicht gefunden: Das Codesystem wurde nicht gefunden oder der Code wurde im angegebenen Codesystem nicht gefunden

Einschränkungen

In dieser Version wird Folgendes nicht unterstützt:

  • $lookupBetrieb durch Aufrufen externer Terminologieserver

  • $lookupVorgang wird vom Datenspeicher CodeSystems verwaltet HealthLake , aber nicht explizit im Datenspeicher gespeichert

Weitere Informationen zur $lookup Operationsspezifikation finden Sie in der FHIR R4-Dokumentation. CodeSystem $lookup