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:
-
Toma el recurso de composición especificado como base del documento
-
Identifica y recupera todos los recursos a los que hace referencia directamente la composición
-
Empaqueta la composición y todos los recursos a los que se hace referencia en un paquete del tipo «documento»
-
Almacena el paquete de documentos generado en el almacén de datos cuando el parámetro de persistencia se establece en true
-
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:
-
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id -
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:
$documentoperació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