Recuperación de detalles conceptuales con $lookup - AWS HealthLake
UsoParámetros admitidosEjemplosParámetros de respuestaComportamientoGestión de erroresAdvertencias

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

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

Uso

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

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

Parámetro Tipo Obligatorio 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 «)
version cadena No Versión específica del sistema de códigos

Ejemplos

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

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

Parámetro Tipo 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

La $lookup operación:

  1. Valida los parámetros necesarios (codeysystem)

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

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

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

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

Gestión de errores

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

En esta versión, no se admite lo siguiente:

  • $lookupoperación mediante la llamada a servidores terminológicos externos

  • $lookupoperació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. CodeSystem $lookup