Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Generazione di documenti clinici con $document
AWS HealthLake ora supporta il $document funzionamento delle risorse di Composizione, consentendovi di generare un documento clinico completo raggruppando la Composizione con tutte le sue risorse di riferimento in un unico pacchetto coeso. Questa operazione è essenziale per le applicazioni sanitarie che devono:
-
Creare documenti clinici standardizzati
-
Scambia le cartelle cliniche complete dei pazienti
-
Archivia una documentazione clinica completa
-
Genera report che includano tutto il contesto pertinente
Utilizzo
L'$documentoperazione può essere richiamata sulle risorse di composizione utilizzando i metodi GET e POST:
Operazioni supportate
GET/POST [base]/Composition/[id]/$document
Parametri supportati
HealthLake supporta il seguente parametro FHIR$document:
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|
persist |
booleano | No | false | Booleano che indica se il server deve archiviare il pacchetto di documenti generato |
Esempi
Richiesta GET
GET [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document?persist=true
Richiesta POST con parametri
POST [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document
Content-Type: application/fhir+json
{
"resourceType": "Parameters",
"parameter": [
{
"name": "persist",
"valueBoolean": true
}
]
}
Risposta di esempio
L'operazione restituisce una risorsa Bundle di tipo «documento» contenente la composizione e tutte le risorse di riferimento:
{
"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"
}
]
}
}
}
]
}
Comportamento
L'$documentoperazione:
-
Prende la risorsa Composition specificata come base per il documento
-
Identifica e recupera tutte le risorse a cui fa riferimento direttamente la composizione
-
Raggruppa la composizione e tutte le risorse referenziate in un pacchetto di tipo «documento»
-
Memorizza il pacchetto di documenti generato nel datastore quando il parametro persist è impostato su true
-
Identifica e recupera le risorse a cui fa riferimento indirettamente la Composizione per una generazione completa di documenti
L'$documentoperazione attualmente supporta il recupero dei riferimenti alle risorse nel seguente formato:
-
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id -
Risorsa/ID
I riferimenti alle risorse non supportati all'interno della risorsa Composition verranno filtrati dal documento generato.
Gestione errori
L'operazione gestisce le seguenti condizioni di errore:
-
400 Richiesta non valida:
$documentoperazione non valida (richiesta non conforme) o se il documento risultante non supera la convalida FHIR a causa di riferimenti filtrati quando persist è impostato su true -
404 Not Found: Risorsa di composizione non trovata
Per ulteriori informazioni sulle specifiche $document operative, consultate la documentazione sulla composizione $document FHIR R4