Recuperación de ValueSet códigos con $expand - AWS HealthLake
UsoParámetros admitidosEjemplos

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

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

Uso

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

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

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

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 R4. ValueSet $expand