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

AWS HealthLake ahora admite la `$lookup` operación de CodeSystem recursos, lo que le permite recuperar detalles sobre un concepto específico de un sistema de códigos proporcionando información de identificación, como su código. Esta operación resulta especialmente útil cuando se necesita:
+ Recuperar información detallada sobre códigos médicos específicos
+ Valide el significado y las propiedades del código
+ Acceda a las definiciones y relaciones de los conceptos
+ Support la toma de decisiones clínicas con datos terminológicos precisos

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

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

**Operaciones admitidas**  


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

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

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


| Parámetro | Tipo | Obligatorio | Description (Descripción) | 
| --- | --- | --- | --- | 
| code | code | Sí | El código conceptual que está buscando (por ejemplo, «71620000" en SNOMED CT) | 
| system | uri | Sí | [La URL canónica del sistema de códigos (por ejemplo, "http://snomed.info/sct «)](http://snomed.info/sct) | 
| version | cadena | No | Versión específica del sistema de códigos | 

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

**Solicitud GET**  


```
GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
```

**Solicitud 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"
    }
  ]
}
```

**Respuesta de ejemplo**  
La operación devuelve un recurso de parámetros que contiene los detalles del concepto:

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

## Parámetros de respuesta
<a name="lookup-response-parameters"></a>

La respuesta incluye los siguientes parámetros cuando están disponibles:


| Parámetro | Tipo | Description (Descripción) | 
| --- | --- | --- | 
| name | cadena | Nombre del sistema de códigos | 
| version | cadena | Versión del sistema de códigos | 
| display | cadena | Mostrar el nombre del concepto | 
| designation | BackboneElement | Representaciones adicionales para este concepto. | 
| property | BackboneElement | Propiedades adicionales del concepto (definición, relaciones, etc.) | 

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

La `$lookup` operación:

1. Valida los parámetros necesarios (`code`y`system`)

1. Busca el concepto en el sistema de códigos especificado almacenado en el almacén de datos

1. Devuelve información conceptual detallada, incluidos el nombre para mostrar, las designaciones y las propiedades.

1. Admite búsquedas específicas de la versión cuando se proporciona el parámetro `version`

1. Funciona solo en sistemas de código almacenados explícitamente en el almacén de datos HealthLake 

## Gestión de errores
<a name="lookup-error-handling"></a>

La operación gestiona las siguientes condiciones de error:
+ 400 Solicitud errónea: `$lookup` operación no válida (solicitud no conforme o faltan parámetros obligatorios)
+ 404 No encontrado: no se encontró el sistema de códigos o el código no se encontró en el sistema de códigos especificado

## Advertencias
<a name="lookup-caveats"></a>

En esta versión, no se admite lo siguiente:
+ `$lookup`operación mediante la llamada a servidores terminológicos externos
+ `$lookup`operación CodeSystems gestionada por el almacén de datos HealthLake , pero no almacenada explícitamente en él

Para obtener más información sobre la especificación de la `$lookup` operación, consulte la documentación del [FHIR R4](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html). CodeSystem `$lookup`