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

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
<a name="lookup-usage"></a>

`$lookup`Operasi 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
<a name="lookup-parameters"></a>

HealthLake mendukung subset parameter FHIR `$lookup` R4:


| Parameter | Tipe | 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](http://snomed.info/sct) “) | 
| version | string | Tidak | Versi spesifik dari sistem kode | 

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

**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
<a name="lookup-response-parameters"></a>

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

`$lookup`Operasi:

1. Memvalidasi parameter yang diperlukan (`code`dan`system`)

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

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

1. Mendukung pencarian khusus versi saat parameter disediakan `version`

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

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

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
<a name="lookup-caveats"></a>

Untuk rilis ini, berikut ini tidak didukung:
+ `$lookup`operasi dengan memanggil server terminologi eksternal
+ `$lookup`operasi 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`](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html).