기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 를 사용하여 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` 파라미터의 하위 집합을 지원합니다.


| 파라미터 | Type | 필수 | 설명 | 
| --- | --- | --- | --- | 
| url | uri | 아니요 | 확장할 ValueSet의 정식 URL | 
| id | id | 아니요 | 확장할 ValueSet 리소스 ID(GET 또는 POST 작업의 경우) | 
| filter | 문자열 | No | 코드 확장 결과 필터링 | 
| count | 정수 | 아니요 | 반환할 코드 수 | 
| offset | 정수 | 아니요 | 반환하기 전에 건너뛸 일치하는 코드 수입니다. 필터링 후 일치 코드에만 적용되며 원래 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) 설명서를 참조하세요.