翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用した概念の詳細の取得 `$lookup`
<a name="reference-fhir-operations-lookup"></a>

AWS HealthLake は CodeSystem リソースの `$lookup`オペレーションをサポートするようになりました。これにより、コードなどの識別情報を提供することで、コードシステム内の特定の概念に関する詳細を取得できます。このオペレーションは、以下が必要な場合に特に役立ちます。
+ 特定の医療コードに関する詳細情報を取得する
+ コードの意味とプロパティを検証する
+ アクセス概念の定義と関係
+ 正確な用語データで臨床上の意思決定をサポートする

## 使用方法
<a name="lookup-usage"></a>

`$lookup` オペレーションは、GET メソッドと POST メソッドの両方を使用して CodeSystem リソースで呼び出すことができます。

**サポートされているオペレーション**  


```
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`パラメータのサブセットをサポートしています。


| パラメータ | タイプ | 必須 | 説明 | 
| --- | --- | --- | --- | 
| 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"
    }
  ]
}
```

**レスポンス例**  
オペレーションは、概念の詳細を含む Parameters リソースを返します。

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

レスポンスには、使用可能な場合、次のパラメータが含まれます。


| パラメータ | Type | 説明 | 
| --- | --- | --- | 
| name | string | コードシステムの名前 | 
| version | string | コードシステムのバージョン | 
| display | string | 概念の表示名 | 
| designation | BackboneElement | この概念の追加表現。 | 
| property | BackboneElement | 概念の追加プロパティ (定義、関係など) | 

## 行動
<a name="lookup-behavior"></a>

`$lookup` オペレーション:

1. 必要なパラメータを検証します (`code` および `system`)

1. データストアに保存されている指定されたコードシステム内の概念を検索します。

1. 表示名、指定、プロパティなど、詳細な概念情報を返します。

1. `version` パラメータが指定されている場合のバージョン固有のルックアップをサポート

1. HealthLake データストアに明示的に保存されているコードシステムでのみ動作します

## エラー処理
<a name="lookup-error-handling"></a>

オペレーションは、次のエラー条件を処理します。
+ 400 不正なリクエスト: 無効な`$lookup`オペレーション (非準拠のリクエストまたは必須パラメータの欠落)
+ 404 Not Found: コードシステムが見つからないか、指定されたコードシステムでコードが見つかりません

## 注意
<a name="lookup-caveats"></a>

このリリースでは、以下はサポートされていません。
+ `$lookup` 外部用語サーバーを呼び出して オペレーションを実行する
+ `$lookup` HealthLake によって管理されているが、データストアに明示的に保存されていない CodeSystems での オペレーション

`$lookup` オペレーション仕様の詳細については、[FHIR R4 CodeSystem `$lookup`](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html) ドキュメントを参照してください。