Mengambil Detail Konsep dengan $lookup - AWS HealthLake
PenggunaanParameter yang DidukungContohParameter ResponsPerilakuPenanganan KesalahanPeringatan

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

Mengambil Detail Konsep dengan $lookup

AWS HealthLake sekarang mendukung $lookup operasi untuk CodeSystem sumber daya, memungkinkan Anda untuk mengambil rincian tentang konsep tertentu dalam sistem kode dengan memberikan informasi identifikasi seperti kodenya. Operasi ini sangat berguna ketika Anda perlu:

  • Ambil informasi rinci tentang kode medis tertentu

  • Validasi arti dan properti kode

  • Akses definisi dan hubungan konsep

  • Support pengambilan keputusan klinis dengan data terminologi yang akurat

Penggunaan

$lookupOperasi dapat dipanggil pada CodeSystem sumber daya menggunakan metode GET dan POST:

Operasi yang Didukung

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup

Parameter yang Didukung

HealthLake mendukung subset parameter FHIR $lookup R4:

Parameter Jenis Diperlukan Deskripsi
code code Ya Kode konsep yang Anda cari (misalnya, “71620000" di SNOMED CT)
system uri Ya URL kanonik dari sistem kode (misalnya, "http://snomed.info/sct “)
version string Tidak Versi spesifik dari sistem kode

Contoh

DAPATKAN Permintaan

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
Permintaan POST

POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
Contoh Respons

Operasi mengembalikan sumber daya Parameter yang berisi rincian konsep:

{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}

Parameter Respons

Respons mencakup parameter berikut bila tersedia:

Parameter Jenis Deskripsi
name string Nama sistem kode
version string Versi sistem kode
display string Nama tampilan konsep
designation BackboneElement Representasi tambahan untuk konsep ini.
property BackboneElement Properti tambahan dari konsep (definisi, hubungan, dll.)

Perilaku

$lookupOperasi:

  1. Memvalidasi parameter yang diperlukan (codedansystem)

  2. Mencari konsep dalam sistem kode tertentu yang disimpan dalam datastore

  3. Mengembalikan informasi konsep rinci termasuk nama tampilan, sebutan, dan properti.

  4. Mendukung pencarian khusus versi saat parameter disediakan version

  5. Beroperasi hanya pada sistem kode yang disimpan secara eksplisit di datastore HealthLake

Penanganan Kesalahan

Operasi menangani kondisi kesalahan berikut:

  • 400 Permintaan Buruk: $lookup Operasi tidak valid (permintaan tidak sesuai atau parameter yang diperlukan tidak ada)

  • 404 Tidak Ditemukan: Sistem kode tidak ditemukan atau kode tidak ditemukan dalam sistem kode yang ditentukan

Peringatan

Untuk rilis ini, berikut ini tidak didukung:

  • $lookupoperasi dengan memanggil server terminologi eksternal

  • $lookupoperasi pada CodeSystems dikelola oleh HealthLake tetapi tidak secara eksplisit disimpan di datastore

Untuk informasi lebih lanjut tentang spesifikasi $lookup operasi, lihat dokumentasi FHIR R4 CodeSystem $lookup.