Récupération des détails du concept avec $lookup - AWS HealthLake
UtilisationParamètres pris en chargeExemplesParamètres de réponseAttitudeGestion des erreursMises en garde

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Récupération des détails du concept avec $lookup

AWS HealthLake prend désormais en charge les $lookup opérations relatives aux CodeSystem ressources, ce qui vous permet de récupérer les détails d'un concept spécifique dans un système de code en fournissant des informations d'identification telles que son code. Cette opération est particulièrement utile lorsque vous devez :

  • Récupérez des informations détaillées sur des codes médicaux spécifiques

  • Valider la signification et les propriétés du code

  • Définitions et relations des concepts d'accès

  • Support à la prise de décisions cliniques grâce à des données terminologiques précises

Utilisation

L'$lookupopération peut être invoquée sur les CodeSystem ressources à l'aide des méthodes GET et POST :

Opérations prises en charge

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

Paramètres pris en charge

HealthLake prend en charge un sous-ensemble de paramètres FHIR $lookup R4 :

Paramètre Type Obligatoire Description
code code Oui Le code conceptuel que vous recherchez (par exemple, « 71620000 » dans SNOMED CT)
system uri Oui L'URL canonique du système de code (par exemple, "http://snomed.info/sct «)
version chaîne Non Version spécifique du système de code

Exemples

Demande GET

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
Demande 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"
    }
  ]
}
Exemple de réponse

L'opération renvoie une ressource Parameters contenant les détails du concept :

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

Paramètres de réponse

La réponse inclut les paramètres suivants lorsqu'ils sont disponibles :

Paramètre Type Description
name chaîne Nom du système de code
version chaîne Version du système de code
display chaîne Afficher le nom du concept
designation BackboneElement Des représentations supplémentaires pour ce concept.
property BackboneElement Propriétés supplémentaires du concept (définition, relations, etc.)

Attitude

L'$lookupopération :

  1. Valide les paramètres requis (codeetsystem)

  2. Recherche le concept dans le système de code spécifié stocké dans la banque de données

  3. Renvoie des informations détaillées sur le concept, notamment le nom d'affichage, les désignations et les propriétés.

  4. Prend en charge les recherches spécifiques à la version lorsque le paramètre est fourni version

  5. Fonctionne uniquement sur les systèmes de code explicitement stockés dans la HealthLake banque de données

Gestion des erreurs

L'opération gère les conditions d'erreur suivantes :

  • 400 Mauvaise demande : $lookup opération non valide (demande non conforme ou paramètres requis manquants)

  • 404 Introuvable : système de code introuvable ou code introuvable dans le système de code spécifié

Mises en garde

Dans cette version, les éléments suivants ne sont pas pris en charge :

  • $lookupopération en appelant des serveurs terminologiques externes

  • $lookupopération sur CodeSystems gérée par HealthLake mais non explicitement stockée dans la banque de données

Pour plus d'informations sur les spécifications de $lookup fonctionnement, consultez la documentation du FHIR R4 CodeSystem $lookup.