Generación de documentos clínicos con $document - AWS HealthLake

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.

Generación de documentos clínicos con $document

AWS HealthLake ahora es compatible con el $document funcionamiento de los recursos de Composition, lo que le permite generar un documento clínico completo agrupando la composición con todos sus recursos de referencia en un único paquete cohesivo. Esta operación es esencial para las aplicaciones de atención médica que necesitan:

  • Cree documentos clínicos estandarizados

  • Intercambie los registros completos de los pacientes

  • Almacene documentación clínica completa

  • Genere informes que incluyan todo el contexto relevante

Uso

La $document operación se puede invocar en los recursos de Composition mediante los métodos GET y POST:

Operaciones admitidas

GET/POST [base]/Composition/[id]/$document

Parámetros admitidos

HealthLake admite el siguiente $document parámetro FHIR:

Parámetro Tipo Obligatorio/a Valor predeterminado Descripción
persist booleano No false Booleano que indica si el servidor debe almacenar el paquete de documentos generado

Ejemplos

Solicitud GET

GET [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document?persist=true
Solicitud POST con parámetros

POST [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document Content-Type: application/fhir+json { "resourceType": "Parameters", "parameter": [ { "name": "persist", "valueBoolean": true } ] }
Respuesta de ejemplo

La operación devuelve un recurso de paquete del tipo «documento» que contiene la composición y todos los recursos a los que se hace referencia:

{ "resourceType": "Bundle", "id": "180f219f-97a8-486d-99d9-ed631fe4fc57", "type": "document", "identifier": { "system": "urn:ietf:rfc:3986", "value": "urn:uuid:0c3151bd-1cbf-4d64-b04d-cd9187a4c6e0" }, "timestamp": "2024-06-21T15:30:00Z", "entry": [ { "fullUrl": "http://example.org/fhir/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57", "resource": { "resourceType": "Composition", "id": "180f219f-97a8-486d-99d9-ed631fe4fc57", "status": "final", "type": { "coding": [ { "system": "http://loinc.org", "code": "34133-9", "display": "Summary of Episode Note" } ] }, "subject": { "reference": "Patient/example" }, "section": [ { "title": "Allergies", "entry": [ { "reference": "AllergyIntolerance/123" } ] } ] } }, { "fullUrl": "http://example.org/fhir/Patient/example", "resource": { "resourceType": "Patient", "id": "example", "name": [ { "family": "Smith", "given": ["John"] } ] } }, { "fullUrl": "http://example.org/fhir/AllergyIntolerance/123", "resource": { "resourceType": "AllergyIntolerance", "id": "123", "patient": { "reference": "Patient/example" }, "code": { "coding": [ { "system": "http://snomed.info/sct", "code": "418689008", "display": "Allergy to penicillin" } ] } } } ] }

Comportamiento

La $document operación:

  1. Toma el recurso de composición especificado como base del documento

  2. Identifica y recupera todos los recursos a los que hace referencia directamente la composición

  3. Empaqueta la composición y todos los recursos a los que se hace referencia en un paquete del tipo «documento»

  4. Almacena el paquete de documentos generado en el almacén de datos cuando el parámetro de persistencia se establece en true

  5. Identifica y recupera los recursos a los que hace referencia indirectamente la composición para una generación completa de documentos

Actualmente, la $document operación admite la recuperación de referencias a recursos en el siguiente formato:

  1. GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id
  2. Recurso/ID

Las referencias a recursos no admitidas en el recurso de composición se eliminarán del documento generado.

Gestión de errores

La operación gestiona las siguientes condiciones de error:

  • 400 Solicitud errónea: $document operación no válida (solicitud no conforme) o si el documento resultante no pasa la validación del FHIR debido a que se filtraron las referencias cuando persisten está establecido en true

  • 404 No encontrado: no se ha encontrado el recurso de composición

Para obtener más información sobre la especificación de la $document operación, consulte la documentación de composición $document del FHIR R4.