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

AWS HealthLake ora supporta l'`$expand`operazione relativa ValueSets ai codici acquisiti da te come cliente, consentendoti di recuperare l'elenco completo dei codici contenuti in quelle ValueSet risorse. Questa operazione è particolarmente utile quando è necessario:
+ Recuperare tutti i codici possibili a scopo di convalida
+ Visualizza le opzioni disponibili nelle interfacce utente
+ Esegui ricerche complete di codice all'interno di un contesto terminologico specifico

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

L'`$expand`operazione può essere richiamata sulle ValueSet risorse utilizzando i metodi GET e POST:

**Operazioni supportate**  


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

## Parametri supportati
<a name="expand-parameters"></a>

HealthLake supporta un sottoinsieme di parametri FHIR R4: `$expand`


| Parametro | Tipo | Campo obbligatorio | Description | 
| --- | --- | --- | --- | 
| url | uri | No | URL canonico del file da espandere ValueSet  | 
| id | id | No | ValueSet id della risorsa da espandere (per le operazioni GET o POST) | 
| filter | stringa | No | Filtra il risultato dell'espansione del codice | 
| count | numero intero | No | Numero di codici da restituire | 
| offset | numero intero | No | Numero di codici corrispondenti da saltare prima della restituzione. Si applica dopo il filtraggio e solo ai codici corrispondenti, non al contenuto completo e non filtrato dell'originale ValueSet | 

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

**GET Richiesta per ID**  


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

**Richiesta GET per URL con filtro**  


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

**Richiesta POST con parametri (per ID)**  


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

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

**Richiesta POST con parametri (tramite 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
    }
  ]
}
```

**Risposta di esempio**  
L'operazione restituisce una ValueSet risorsa con un `expansion` elemento contenente i codici espansi:

```
{
  "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 risposta include:
+ expansion.total: numero totale di codici nell'espanso ValueSet
+ expansion.contains: matrice di codici espansi con i relativi valori di sistema, codice e visualizzazione
+ expansion.parameter: parametri utilizzati nella richiesta di espansione

[Per ulteriori informazioni sulle specifiche `$expand` operative, consultate la documentazione FHIR R4. ValueSet `$expand`](https://build.fhir.org/valueset-operation-expand.html)