Generazione di documenti clinici con $document - AWS HealthLake

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:

  1. Prende la risorsa Composition specificata come base per il documento

  2. Identifica e recupera tutte le risorse a cui fa riferimento direttamente la composizione

  3. Raggruppa la composizione e tutte le risorse referenziate in un pacchetto di tipo «documento»

  4. Memorizza il pacchetto di documenti generato nel datastore quando il parametro persist è impostato su true

  5. 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:

  1. GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id
  2. 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: $document operazione 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.