Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Recuperación de ValueSet códigos con `$expand`
<a name="reference-fhir-operations-expand"></a>

AWS HealthLake ahora es compatible con la `$expand` operación ValueSets que usted haya introducido como cliente, lo que le permite recuperar la lista completa de códigos contenidos en esos ValueSet recursos. Esta operación resulta especialmente útil cuando se necesita:
+ Recupere todos los códigos posibles con fines de validación
+ Muestra las opciones disponibles en las interfaces de usuario
+ Realice búsquedas de código exhaustivas dentro de un contexto terminológico específico

## De uso
<a name="expand-usage"></a>

La `$expand` operación se puede invocar en ValueSet los recursos mediante los métodos GET y POST:

**Operaciones admitidas**  


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

## Parámetros admitidos
<a name="expand-parameters"></a>

HealthLake admite un subconjunto de parámetros del FHIR `$expand` R4:


| Parámetro | Tipo | Obligatorio | Description (Descripción) | 
| --- | --- | --- | --- | 
| url | uri | No | URL canónica del que se va a expandir ValueSet  | 
| id | id | No | ValueSet identificador del recurso que se va a expandir (para operaciones GET o POST) | 
| filter | cadena | No | Filtra el resultado de la expansión del código | 
| count | entero | No | Número de códigos a devolver | 
| offset | entero | No | Número de códigos coincidentes que se deben omitir antes de la devolución. Se aplica después del filtrado y solo a los códigos coincidentes, no a todo el contenido del original sin filtrar ValueSet | 

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

**Solicitud GET por ID**  


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

**OBTENGA la solicitud por URL con filtro**  


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

**Solicitud POST con parámetros (por ID)**  


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

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

**Solicitud POST con parámetros (por 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
    }
  ]
}
```

**Respuesta de ejemplo**  
La operación devuelve un ValueSet recurso con un `expansion` elemento que contiene los códigos expandidos:

```
{
  "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 respuesta incluye:
+ expansion.total: número total de códigos en el expandido ValueSet
+ expansion.contains: matriz de códigos expandidos con su sistema, código y valores de visualización
+ expansion.parameter: parámetros utilizados en la solicitud de expansión

Para obtener más información sobre la especificación de `$expand` operación, consulte la documentación del [FHIR](https://build.fhir.org/valueset-operation-expand.html) R4. ValueSet `$expand`