本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 擷取概念詳細資訊 `$lookup`
<a name="reference-fhir-operations-lookup"></a>

AWS HealthLake 現在支援 CodeSystem 資源的 `$lookup`操作，可讓您透過提供程式碼等識別資訊，擷取程式碼系統中特定概念的詳細資訊。當您需要：
+ 擷取特定醫療代碼的詳細資訊
+ 驗證程式碼意義和屬性
+ 存取概念定義和關係
+ 使用準確的術語資料支援臨床決策

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

您可以使用 GET 和 POST 方法在 CodeSystem 資源上叫用 `$lookup`操作：

**受支援的 操作**  


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

## 支援的參數
<a name="lookup-parameters"></a>

HealthLake 支援 FHIR R4 `$lookup` 參數的子集：


| 參數 | Type | 必要 | Description | 
| --- | --- | --- | --- | 
| code | code | 是 | 您要查詢的概念代碼 （例如 SNOMED CT 中的 "71620000") | 
| system | uri | 是 | 程式碼系統的正式 URL （例如 "[http://snomed.info/sct](http://snomed.info/sct)") | 
| version | string | 否 | 特定版本的程式碼系統 | 

## 範例
<a name="lookup-examples"></a>

**GET 請求**  


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

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

**回應範例**  
操作會傳回參數資源，其中包含概念詳細資訊：

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

## 回應參數
<a name="lookup-response-parameters"></a>

回應會在可用時包含下列參數：


| 參數 | 類型 | Description | 
| --- | --- | --- | 
| name | string | 程式碼系統的名稱 | 
| version | string | 程式碼系統的版本 | 
| display | string | 顯示概念的名稱 | 
| designation | BackboneElement | 此概念的其他表示法。 | 
| property | BackboneElement | 概念的其他屬性 （定義、關係等） | 

## Behavior (行為)
<a name="lookup-behavior"></a>

`$lookup` 操作：

1. 驗證所需的參數 (`code` 和 `system`)

1. 在存放在資料存放區的指定程式碼系統中搜尋概念

1. 傳回詳細的概念資訊，包括顯示名稱、指定項目和屬性。

1. 提供 `version` 參數時支援版本特定的查詢

1. 僅在明確存放在 HealthLake 資料存放區的程式碼系統上操作

## 錯誤處理
<a name="lookup-error-handling"></a>

操作會處理下列錯誤條件：
+ 400 錯誤的請求：無效的`$lookup`操作 （不符合的請求或缺少必要的參數）
+ 找不到 404：找不到程式碼系統，或在指定的程式碼系統中找不到程式碼

## 警告
<a name="lookup-caveats"></a>

在此版本中，不支援下列項目：
+ `$lookup` 透過呼叫外部術語伺服器進行 操作
+ `$lookup` CodeSystems 上的 操作由 HealthLake 管理，但未明確存放在資料存放區中

如需 `$lookup`操作規格的詳細資訊，請參閱 [FHIR R4 CodeSystem `$lookup`](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html) 文件。