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`
<a name="reference-fhir-operations-lookup"></a>

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

## Usage
<a name="lookup-usage"></a>

L'`$lookup`opé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
<a name="lookup-parameters"></a>

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](http://snomed.info/sct) «) | 
| version | chaîne | Non | Version spécifique du système de code | 

## Exemples
<a name="lookup-examples"></a>

**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
<a name="lookup-response-parameters"></a>

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

## Comportement
<a name="lookup-behavior"></a>

L'`$lookup`opération :

1. Valide les paramètres requis (`code`et`system`)

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

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

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

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

## Gestion des erreurs
<a name="lookup-error-handling"></a>

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
<a name="lookup-caveats"></a>

Dans cette version, les éléments suivants ne sont pas pris en charge :
+ `$lookup`opération en appelant des serveurs terminologiques externes
+ `$lookup`opé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`](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html).