Generierung klinischer Dokumente mit $document - AWS HealthLake

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Generierung klinischer Dokumente mit $document

AWS HealthLake unterstützt jetzt den $document Vorgang für Zusammenstellungsressourcen, sodass Sie ein vollständiges klinisches Dokument erstellen können, indem Sie die Zusammenstellung mit all ihren referenzierten Ressourcen in einem einzigen zusammenhängenden Paket bündeln. Dieser Vorgang ist unverzichtbar für Anwendungen im Gesundheitswesen, die:

  • Erstellen Sie standardisierte klinische Dokumente

  • Tauschen Sie komplette Patientenakten aus

  • Bewahren Sie umfassende klinische Unterlagen auf

  • Generieren Sie Berichte, die den gesamten relevanten Kontext enthalten

Verwendung

Der $document Vorgang kann für Composition-Ressourcen mit den Methoden GET und POST aufgerufen werden:

Unterstützte Vorgänge

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

Unterstützte Parameter

HealthLake unterstützt den folgenden FHIR-Parameter$document:

Parameter Typ Erforderlich Standard Beschreibung
persist Boolean Nein false Boolescher Wert, der angibt, ob der Server das generierte Dokumentenpaket speichern soll

Beispiele

GET-Anfrage

GET [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document?persist=true
POST-Anfrage mit Parametern

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

Die Operation gibt eine Bundle-Ressource vom Typ „Dokument“ zurück, die die Komposition und alle referenzierten Ressourcen enthält:

{ "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" } ] } } } ] }

Behavior

Die $document Operation:

  1. Nimmt die angegebene Kompositionsressource als Grundlage für das Dokument

  2. Identifiziert alle Ressourcen, auf die in der Komposition direkt verwiesen wird, und ruft sie ab

  3. Verpackt die Komposition und alle Ressourcen, auf die verwiesen wird, in ein Paket vom Typ „Dokument“

  4. Speichert das generierte Dokumentpaket im Datenspeicher, wenn der Parameter persist auf true gesetzt ist

  5. Identifiziert Ressourcen, auf die in der Zusammensetzung indirekt verwiesen wird, und ruft sie ab, um eine umfassende Dokumentgenerierung zu ermöglichen

Der $document Vorgang unterstützt derzeit das Abrufen von Ressourcenreferenzen im folgenden Format:

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

Nicht unterstützte Ressourcenverweise innerhalb der Kompositionsressource werden aus dem generierten Dokument herausgefiltert.

Fehlerbehandlung

Der Vorgang behandelt die folgenden Fehlerbedingungen:

  • 400 Bad Request: Ungültiger $document Vorgang (nicht konforme Anfrage) oder wenn das resultierende Dokument die FHIR-Validierung aufgrund herausgefilterter Verweise nicht besteht, wenn persist auf true gesetzt ist

  • 404 Nicht gefunden: Die Kompositionsressource wurde nicht gefunden

Weitere Informationen zur $document Operationsspezifikation finden Sie in der FHIR $document R4-Kompositionsdokumentation.