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`
<a name="reference-fhir-operations-document"></a>

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

## Usage
<a name="document-usage"></a>

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
<a name="document-parameters"></a>

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


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

## Beispiele
<a name="document-examples"></a>

**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
<a name="document-behavior"></a>

Die `$document` Operation:

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

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

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

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

1. 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
   ```

1. Ressource/ID

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

## Fehlerbehandlung
<a name="document-error-handling"></a>

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](https://www.hl7.org/fhir/R4/composition-operation-document.html).