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

# を使用した ValueSet コードの取得 `$expand`
<a name="reference-fhir-operations-expand"></a>

AWS HealthLake は、顧客として取り込まれた ValueSets の `$expand`オペレーションをサポートするようになりました。これにより、それらの ValueSet リソースに含まれるコードの完全なリストを取得できます (複数可）。このオペレーションは、以下が必要な場合に特に役立ちます。
+ 検証目的で可能なすべてのコードを取得する
+ ユーザーインターフェイスで使用可能なオプションを表示する
+ 特定の用語コンテキスト内で包括的なコード検索を実行する

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

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

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


```
GET/POST [base]/ValueSet/[id]/$expand
GET [base]/ValueSet/$expand?url=http://example.com
POST [base]/ValueSet/$expand
```

## サポートされているパラメータ
<a name="expand-parameters"></a>

HealthLake は、FHIR R4 `$expand`パラメータのサブセットをサポートしています。


| パラメータ | タイプ | 必須 | 説明 | 
| --- | --- | --- | --- | 
| url | uri | 不可 | 拡張する ValueSet の正規 URL | 
| id | id | 不可 | 拡張する ValueSet リソース ID (GET または POST オペレーションの場合) | 
| filter | string | 不可 | コード拡張結果をフィルタリングする | 
| count | integer | 不可 | 返されるコードの数 | 
| offset | integer | 不可 | 戻る前にスキップする一致するコードの数。フィルタリング後、元の ValueSet の完全なフィルタリングされていないコンテンツではなく、一致するコードにのみ適用されます。 | 

## 例
<a name="expand-examples"></a>

**ID による GET リクエスト**  


```
GET [base]/ValueSet/example-valueset/$expand
```

**フィルターを使用した URL による GET リクエスト**  


```
GET [base]/ValueSet/$expand?url=http://example.com/ValueSet/my-valueset&filter=male&count=5
```

**パラメータを含む POST リクエスト (ID 別)**  


```
POST [base]/ValueSet/example-valueset/$expand
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "count",
      "valueInteger": 10
    },
    {
      "name": "filter",
      "valueString": "admin"
    }
  ]
}
```

**パラメータを含む POST リクエスト (URL による)**  


```
POST [base]/ValueSet/$expand
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "url",
      "valueUri": "http://hl7.org/fhir/ValueSet/administrative-gender"
    },
    {
      "name": "count",
      "valueInteger": 10
    }
  ]
}
```

**レスポンス例**  
オペレーションは、展開されたコードを含む `expansion`要素を持つ ValueSet リソースを返します。

```
{
  "resourceType": "ValueSet",
  "id": "administrative-gender",
  "status": "active",
  "expansion": {
    "identifier": "urn:uuid:12345678-1234-1234-1234-123456789abc",
    "timestamp": "2024-01-15T10:30:00Z",
    "total": 4,
    "parameter": [
      {
        "name": "count",
        "valueInteger": 10
      }
    ],
    "contains": [
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "male",
        "display": "Male"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "female",
        "display": "Female"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "other",
        "display": "Other"
      },
      {
        "system": "http://hl7.org/fhir/administrative-gender",
        "code": "unknown",
        "display": "Unknown"
      }
    ]
  }
}
```

レスポンスは以下のとおりです。
+ expansion.total: 展開された ValueSet のコードの合計数
+ expansion.contains: システム、コード、および表示値を含む拡張コードの配列
+ expansion.parameter: 拡張リクエストで使用されるパラメータ

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