Recupero dei dettagli concettuali con $lookup - 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à.

Recupero dei dettagli concettuali con $lookup

AWS HealthLake ora supporta l'$lookupoperazione per CodeSystem le risorse, consentendoti di recuperare dettagli su un concetto specifico in un sistema di codice fornendo informazioni identificative come il codice. Questa operazione è particolarmente utile quando è necessario:

  • Recuperare informazioni dettagliate su codici medici specifici

  • Convalida i significati e le proprietà dei codici

  • Accedi alle definizioni e alle relazioni dei concetti

  • Supporta il processo decisionale clinico con dati terminologici accurati

Utilizzo

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

Operazioni supportate

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

Parametri supportati

HealthLake supporta un sottoinsieme di parametri FHIR R4: $lookup

Parametro Tipo Campo obbligatorio Descrizione
code code Sì Il codice concettuale che stai cercando (ad esempio, «71620000" in SNOMED CT)
system uri Sì L'URL canonico del sistema di codici (ad esempio, "http://snomed.info/sct «)
version string No Versione specifica del sistema di codice

Esempi

Richiesta GET

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

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"
    }
  ]
}
Risposta di esempio

L'operazione restituisce una risorsa Parameters contenente i dettagli del concetto:

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

Parametri di risposta

La risposta include i seguenti parametri, se disponibili:

Parametro Tipo Descrizione
name stringa Nome del sistema di codici
version string Versione del sistema di codici
display string Visualizza il nome del concetto
designation BackboneElement Rappresentazioni aggiuntive per questo concetto.
property BackboneElement Proprietà aggiuntive del concetto (definizione, relazioni, ecc.)

Comportamento

L'$lookupoperazione:

  1. Convalida i parametri richiesti (codeesystem)

  2. Cerca il concetto all'interno del sistema di codice specificato memorizzato nel datastore

  3. Restituisce informazioni dettagliate sul concetto, tra cui nome visualizzato, designazioni e proprietà.

  4. Supporta ricerche specifiche per versione quando viene fornito il parametro version

  5. Funziona solo su sistemi di codice archiviati in modo esplicito nel datastore HealthLake

Gestione errori

L'operazione gestisce le seguenti condizioni di errore:

  • 400 Bad Request: $lookup operazione non valida (richiesta non conforme o parametri obbligatori mancanti)

  • 404 Not Found: Sistema di codice non trovato o codice non trovato nel sistema di codice specificato

Avvertenze

In questa versione, non sono supportati:

  • $lookupoperazione mediante chiamata a server terminologici esterni

  • $lookupoperazione su CodeSystems gestita da HealthLake ma non archiviata in modo esplicito nel datastore

Per ulteriori informazioni sulle specifiche $lookup operative, consultate la documentazione di FHIR R4. CodeSystem $lookup