Menghasilkan Dokumen Klinis dengan $document - AWS HealthLake
PenggunaanParameter yang DidukungContohPerilakuPenanganan Kesalahan

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

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

$documentOperasi dapat dipanggil pada sumber daya Komposisi menggunakan metode GET dan POST:

Operasi yang Didukung

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

Parameter yang Didukung

HealthLake mendukung $document parameter FHIR berikut:

Parameter Jenis Wajib Default Deskripsi
persist boolean Tidak false Boolean menunjukkan apakah server harus menyimpan bundel dokumen yang dihasilkan

Contoh

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

$documentOperasi:

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

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

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

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

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

$documentOperasi saat ini mendukung pengambilan referensi sumber daya dalam format berikut:

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

  2. Sumber daya/ID

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

Penanganan Kesalahan

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.