Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menghasilkan Dokumen Klinis dengan `$document`
<a name="reference-fhir-operations-document"></a>

AWS HealthLake sekarang mendukung `$document` operasi untuk sumber daya Komposisi, memungkinkan Anda untuk menghasilkan dokumen klinis lengkap dengan menggabungkan Komposisi dengan semua sumber daya yang direferensikan ke dalam satu paket kohesif. Operasi ini sangat penting untuk aplikasi perawatan kesehatan yang perlu:
+ Buat dokumen klinis standar
+ Tukar catatan pasien lengkap
+ Simpan dokumentasi klinis yang komprehensif
+ Hasilkan laporan yang mencakup semua konteks yang relevan

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

`$document`Operasi dapat dipanggil pada sumber daya Komposisi menggunakan metode GET dan POST:

**Operasi yang Didukung**  


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

## Parameter yang Didukung
<a name="document-parameters"></a>

HealthLake mendukung `$document` parameter FHIR berikut:


| Parameter | Tipe | Diperlukan | Default | Deskripsi | 
| --- | --- | --- | --- | --- | 
| persist | boolean | Tidak | false | Boolean menunjukkan apakah server harus menyimpan bundel dokumen yang dihasilkan | 

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

**DAPATKAN Permintaan**  


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

**Permintaan POST dengan Parameter**  


```
POST [base]/Composition/180f219f-97a8-486d-99d9-ed631fe4fc57/$document
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "persist",
      "valueBoolean": true
    }
  ]
}
```

**Contoh Respons**  
Operasi mengembalikan sumber daya Bundle berjenis “dokumen” yang berisi Komposisi dan semua sumber daya yang direferensikan:

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

## Perilaku
<a name="document-behavior"></a>

`$document`Operasi:

1. Mengambil sumber daya Komposisi yang ditentukan sebagai dasar untuk dokumen

1. Mengidentifikasi dan mengambil semua sumber daya yang direferensikan secara langsung oleh Komposisi

1. Mengemas Komposisi dan semua sumber daya yang direferensikan ke dalam Bundel jenis “dokumen”

1. Menyimpan bundel dokumen yang dihasilkan di datastore saat parameter persisten disetel ke true

1. Mengidentifikasi dan mengambil sumber daya yang secara tidak langsung direferensikan oleh Komposisi untuk pembuatan dokumen yang komprehensif

`$document`Operasi saat ini mendukung pengambilan referensi sumber daya dalam format berikut:

1. 

   ```
   GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id
   ```

1. Sumber daya/ID

Referensi sumber daya yang tidak didukung dalam sumber daya Komposisi akan disaring dari dokumen yang dihasilkan.

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

Operasi menangani kondisi kesalahan berikut:
+ 400 Permintaan Buruk: `$document` Operasi tidak valid (permintaan tidak sesuai) atau jika dokumen yang dihasilkan gagal validasi FHIR karena referensi yang disaring saat persisten disetel ke true
+ 404 Tidak Ditemukan: Sumber daya komposisi tidak ditemukan

Untuk informasi lebih lanjut tentang spesifikasi `$document` operasi, lihat dokumentasi [Komposisi `$document` FHIR R4](https://www.hl7.org/fhir/R4/composition-operation-document.html).