FHIR Bulk Data

• 벌크 데이터 클라이언트를 구축하여 FHIR 서버에서 내보내기를 시작하고, 상태를 폴링하며, NDJSON 파일을 다운로드해야 합니다.
• 서버 측 $export 지원을 구현 중이며, 적합성 요구사항, 매니페스트 구조, 또는 CapabilityStatement 선언을 이해해야 합니다.
• _type, _since, 또는 _typeFilter와 같은 매개변수를 사용하여 리소스 유형, 날짜 범위, 또는 FHIR 검색 기준으로 대규모 내보내기를 필터링해야 합니다.
• 안전한 서버 간 벌크 액세스를 위해 SMART Backend Services(OAuth 2.0 클라이언트 자격 증명 + JWT)를 통합하고 있습니다.

• 표준 REST를 통해 개별 FHIR 리소스만 검색하면 되는 경우 — 대신 일반 FHIR 스킬을 사용하세요.
• 사용 사례가 일괄 내보내기가 아닌 실시간 또는 준실시간 데이터 스트리밍을 포함하는 경우.
• HL7 Bulk Data Access IG를 따르지 않는 독점적인 대량 내보내기 형식으로 작업하는 경우.

벌크 내보내기 라이프사이클의 모든 단계를 안내합니다: 킥오프 요청, 202 Accepted 처리, Retry-After 및 X-Progress를 활용한 상태 폴링, 매니페스트 파싱, 파일 다운로드, 그리고 DELETE 정리 작업.

Patient/$export(모든 환자), Group/[id]/$export(코호트 범위), [base]/$export(시스템 수준)를 다루며, 각각을 언제 사용해야 하는지와 범위 지정이 출력에 미치는 영향을 포함합니다.

지원되는 모든 매개변수에 대한 자세한 안내: _outputFormat, _since, _until, _type, _elements, _typeFilter, includeAssociatedData, organizeOutputBy, allowPartialManifests.

Newline Delimited JSON 생성 및 소비를 위한 정확한 규칙: 한 줄에 하나의 리소스, UTF-8 인코딩, 올바른 줄 종료, 내장된 줄 바꿈 없음, 그리고 올바른 미디어 유형(application/fhir+ndjson).

벌크 서버 간 액세스에 필요한 JWT 어설션을 포함한 OAuth 2.0 클라이언트 자격 증명 흐름을 설명하며, 토큰 요청 구조 및 베어러 토큰 사용법을 포함합니다.

OperationOutcome 해석, 속도 제한(429 Too Many Requests), 토큰 만료(401), 누락된 작업(404), 그리고 탄력적인 폴링 클라이언트를 위한 전략을 다룹니다.

내보내기를 시작하고, 지수 백오프(exponential backoff)를 사용하여 상태 URL을 폴링하며, 완전한 매니페스트를 파싱하고, 다운스트림 처리를 위해 NDJSON 파일을 스트리밍하는 클라이언트를 구현합니다.

FHIR 서버가 $export를 지원하도록 구성하고, 각 워크플로 단계에서 올바른 HTTP 응답을 반환하며, CapabilityStatement를 통해 적합성을 선언합니다.

Group/$export를 _type, _since, _typeFilter 매개변수와 함께 사용하여 특정 분석 또는 연구 사용 사례에 필요한 리소스 유형과 날짜 범위만 내보냅니다.

OperationOutcome 응답을 해석하고, HTTP 상태 의미를 이해하며, 부분 매니페스트 및 페이지 분할 출력과 같은 엣지 케이스를 처리하여 FHIR Bulk Data 대량 내보내기 오류를 진단하고 해결합니다.