를 사용하여 ValueSet 코드 검색 $expand - AWS HealthLake
사용량지원되는 파라미터예시

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

를 사용하여 ValueSet 코드 검색 $expand

AWS HealthLake 는 이제 고객이 수집한 ValueSets에 대한 $expand 작업을 지원하므로 해당 ValueSet 리소스(들)에 포함된 코드의 전체 목록을 검색할 수 있습니다. 이 작업은 다음이 필요한 경우에 특히 유용합니다.

  • 검증을 위해 가능한 모든 코드 검색

  • 사용자 인터페이스에 사용 가능한 옵션 표시

  • 특정 용어 컨텍스트 내에서 포괄적인 코드 조회 수행

사용량

$expand 작업은 GET 및 POST 메서드를 모두 사용하여 ValueSet 리소스에서 호출할 수 있습니다.

지원되는 작업

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

지원되는 파라미터

HealthLake는 FHIR R4 $expand 파라미터의 하위 집합을 지원합니다.

파라미터 Type 필수 설명
url uri 아니요 확장할 ValueSet의 정식 URL
id id 아니요 확장할 ValueSet 리소스 ID(GET 또는 POST 작업의 경우)
filter 문자열 No 코드 확장 결과 필터링
count 정수 아니요 반환할 코드 수
offset 정수 아니요 반환하기 전에 건너뛸 일치하는 코드 수입니다. 필터링 후 일치 코드에만 적용되며 원래 ValueSet의 필터링되지 않은 전체 콘텐츠에는 적용되지 않습니다.

예시

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 설명서를 참조하세요.