FHIR 번들 설명: 9가지 번들 유형과 사용 시기

간단한 답변: Bundle은 다른 리소스들을 그룹화하는 FHIR 리소스입니다. 검색 결과, 한 번의 요청으로 전송되는 쓰기 작업 세트, 환자 요약과 같은 임상 문서 또는 메시지 등이 여기에 해당합니다. type은 그룹의 의미와 서버가 어떻게 처리해야 하는지를 나타냅니다.

FHIR R4의 아홉 가지 타입

• searchset: 검색 결과이며, 페이징 링크가 포함됩니다.
• transaction: 모든 작업이 성공하거나 아무것도 적용되지 않는 "all-or-nothing" 방식으로 처리되는 쓰기 작업입니다. 하나라도 실패하면 아무것도 적용되지 않습니다.
• batch: 각 항목이 독립적으로 성공하거나 실패하는 방식으로 처리되는 쓰기 작업입니다.
• transaction-response / batch-response: 서버가 각 작업에 대해 반환하는 응답입니다.
• document: 국제 환자 요약과 같은 임상 문서입니다. (첫 번째 항목은 Composition입니다.) 전체가 서명되거나 저장됩니다.
• message: 메시지이며, 첫 번째 항목은 MessageHeader입니다.
• history: 리소스의 버전들입니다.
• collection: 추가적인 의미가 없는 리소스들의 집합입니다.

Transaction vs Batch

리소스들이 서로 의존적인 경우, 예를 들어 Patient와 해당 리소스를 참조하는 Observations의 경우 transaction을 사용합니다. 번들 내의 참조는 임시 urn:uuid: 식별자를 사용하여 서버가 이를 해석하도록 할 수 있습니다. 부분적인 성공이 허용되는 독립적인 작업의 경우 batch를 사용합니다.

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {"fullUrl": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a",
     "resource": {"resourceType": "Patient", "name": [{"family": "Example"}]},
     "request": {"method": "POST", "url": "Patient"}},
    {"resource": {"resourceType": "Observation", "status": "final",
       "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]},
       "subject": {"reference": "urn:uuid:61ebe359-bfdc-4613-8bf2-c5e300945f0a"},
       "valueQuantity": {"value": 72, "unit": "/min", "system": "http://unitsofmeasure.org", "code": "/min"}},
     "request": {"method": "POST", "url": "Observation"}}
  ]
}

Anpheros에서의 사용

Anpheros Platform은 transaction 및 batch 번들을 수락하고 페이징이 포함된 searchset 번들을 반환합니다. 국제 환자 요약은 document 번들로 반환됩니다. FHIR 샌드박스에서 직접 사용해 보거나, FHIR의 국제 환자 요약에 대해 알아보세요.

관련 페이지

• FHIR 검색 설명
• FHIR R4 vs R5

출처

• HL7 FHIR R4: Bundle
• HL7 FHIR R4: Bundle types

자주 묻는 질문

FHIR 트랜잭션과 배치 간의 차이점은 무엇인가요?

트랜잭션은 "all-or-nothing" 방식이며, 배치는 각 항목을 독립적으로 처리합니다.

같은 번들에서 생성된 리소스를 어떻게 참조하나요?

urn:uuid:...와 같은 fullUrl을 부여하고 이를 참조로 사용합니다. 트랜잭션의 경우 서버가 실제 ID로 대체합니다.

환자 요약의 타입은 무엇인가요?

첫 번째 항목이 Composition인 document 번들입니다.

검색 결과가 Bundle로 나오는 이유는 무엇인가요?

검색 결과는 항상 다음 페이지로 연결되는 링크가 포함된 searchset 번들로 반환됩니다.

Anpheros Platform

샌드박스에서 무료로 사용해 보세요

5분 만에 첫 FHIR 호출. 환자의 동의가 내장된 HL7 FHIR R4 API: 샌드박스에서 먼저 사용해보고, 자체 앱 또는 병원 시스템을 연결하세요.

무료 샌드박스 만들기개발자 가이드 읽기 →

무료 · 합성 환자 30명 · 카드 불필요

작성자

Anpheros 팀

Anpheros는 환자가 직접 관리하고 어떤 병원과도 공유할 수 있는 의료 기록을 EU 기반의 HL7 FHIR R4 플랫폼에서 구축합니다. 이 가이드들은 건강 정보를 이해하고 정리하는 데 도움을 드리며, 의사의 진료를 대체하지 않습니다.

Anpheros 소개 →