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 de ValueSet codes avec `$expand`
<a name="reference-fhir-operations-expand"></a>

AWS HealthLake prend désormais en charge les `$expand` opérations ValueSets que vous avez ingérées en tant que client, ce qui vous permet de récupérer la liste complète des codes contenus dans ces ValueSet ressources. Cette opération est particulièrement utile lorsque vous devez :
+ Récupérez tous les codes possibles à des fins de validation
+ Afficher les options disponibles dans les interfaces utilisateur
+ Effectuez des recherches de code complètes dans un contexte terminologique spécifique

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

L'`$expand`opération peut être invoquée sur les ValueSet ressources à l'aide des méthodes GET et POST :

**Opérations prises en charge**  


```
GET/POST [base]/ValueSet/[id]/$expand
GET [base]/ValueSet/$expand?url=http://example.com
POST [base]/ValueSet/$expand
```

## Paramètres pris en charge
<a name="expand-parameters"></a>

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


| Paramètre | Type | Obligatoire | Description | 
| --- | --- | --- | --- | 
| url | uri | Non | URL canonique du ValueSet à développer | 
| id | id | Non | ValueSet identifiant de ressource à étendre (pour les opérations GET ou POST) | 
| filter | chaîne | Non | Filtrer le résultat de l'extension du code | 
| count | entier | Non | Nombre de codes à retourner | 
| offset | entier | Non | Nombre de codes correspondants à ignorer avant de retourner. S'applique après le filtrage et uniquement aux codes correspondants, et non à l'intégralité du contenu non filtré de l'original ValueSet | 

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

**Demande GET par identifiant**  


```
GET [base]/ValueSet/example-valueset/$expand
```

**Requête GET par URL avec filtre**  


```
GET [base]/ValueSet/$expand?url=http://example.com/ValueSet/my-valueset&filter=male&count=5
```

**Requête POST avec paramètres (par ID)**  


```
POST [base]/ValueSet/example-valueset/$expand
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "count",
      "valueInteger": 10
    },
    {
      "name": "filter",
      "valueString": "admin"
    }
  ]
}
```

**Requête POST avec paramètres (par URL)**  


```
POST [base]/ValueSet/$expand
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "url",
      "valueUri": "http://hl7.org/fhir/ValueSet/administrative-gender"
    },
    {
      "name": "count",
      "valueInteger": 10
    }
  ]
}
```

**Exemple de réponse**  
L'opération renvoie une ValueSet ressource avec un `expansion` élément contenant les codes développés :

```
{
  "resourceType": "ValueSet",
  "id": "administrative-gender",
  "status": "active",
  "expansion": {
    "identifier": "urn:uuid:12345678-1234-1234-1234-123456789abc",
    "timestamp": "2024-01-15T10:30:00Z",
    "total": 4,
    "parameter": [
      {
        "name": "count",
        "valueInteger": 10
      }
    ],
    "contains": [
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "male",
        "display": "Male"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "female",
        "display": "Female"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "other",
        "display": "Other"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "unknown",
        "display": "Unknown"
      }
    ]
  }
}
```

La réponse inclut :
+ expansion.total : nombre total de codes dans l'extension ValueSet
+ expansion.contains : tableau de codes étendus avec leur système, leur code et leurs valeurs d'affichage
+ expansion.parameter : paramètres utilisés dans la demande d'extension

Pour plus d'informations sur les spécifications de `$expand` fonctionnement, consultez la documentation du [FHIR R4 ValueSet `$expand`](https://build.fhir.org/valueset-operation-expand.html).