Azure API for FHIR용 Blue Button®용 CARIN 구현 가이드

Important

Azure API for FHIR은 2026년 9월 30일에 사용 중지됩니다. 해당 날짜까지 마이그레이션 전략에 따라 Azure Health Data Services FHIR® 서비스로 전환합니다. Azure API for FHIR의 사용 중지로 인해 2025년 4월 1일부터 신규 배포가 허용되지 않습니다. Azure Health Data Services FHIR 서비스는 고객이 다른 Azure 서비스에 통합하여 FHIR, DICOM 및 MedTech 서비스를 관리할 수 있도록 하는 Azure API for FHIR의 진화된 버전입니다.

이 자습서에서는 Blue Button용 CARIN 구현 가이드(C4BB IG)에 대한 Touchstone 테스트를 통과하도록 Azure API for FHIR®를 설정하는 방법을 안내합니다.

Touchstone 기능 문

첫 번째 테스트는 C4BB IG 기능 문에 대해 Azure API for FHIR을 테스트하는 것입니다. 업데이트 없이 Azure API for FHIR에 대해 이 테스트를 실행하면 검색 매개 변수 및 프로필이 누락되어 테스트가 실패합니다.

검색 매개 변수 정의

C4BB IG의 일부로 ExplanationOfBenefit 리소스에 대한 세 가지 새로운 검색 매개 변수를 정의해야 합니다. 이 중 두 가지는 기능 문(type 및 service-date)에서 테스트되며 하나는 _include 검색(insurer)에 필요합니다.

참고 항목

이러한 검색 매개 변수에 대한 원시 JSON에서 이름은 ExplanationOfBenefit_<SearchParameter Name>으로 설정됩니다. Touchstone 테스트는 이러한 이름이 type, service-dateinsurer일 것으로 예상합니다.

C4BB IG에 필요한 나머지 검색 매개 변수는 기본 사양에 따라 정의되며 추가 업데이트 없이 이미 Azure API for FHIR에서 사용할 수 있습니다.

프로필 저장

검색 매개 변수 정의 외에 이 테스트를 통과하기 위해 수행해야 하는 업데이트는 필수 프로필을 로드하는 것입니다. C4BB IG 내에 정의된 8개의 프로필이 있습니다.

샘플 나머지 파일

이러한 검색 매개 변수 및 프로필 생성을 지원하기 위해 이 자습서에서 설명하는 모든 단계를 하나의 파일에 담은 샘플 http 파일이 준비되어 있습니다. 필요한 프로필과 검색 매개 변수를 모두 업로드한 후에는 Touchstone에서 기능 문 테스트를 실행할 수 있습니다.

기능 테스트 스크립트 실행 결과입니다.

Touchstone 읽기 테스트

기능 문을 테스트한 후 C4BB IG에 대해 Azure API for FHIR의 읽기 기능을 테스트합니다. 이는 첫 번째 테스트에서 로드한 8개 프로필에 대한 적합성 테스트입니다. 프로필에 맞는 리소스를 로드해야 합니다. 데이터베이스에 이미 있는 리소스에 대해 테스트하는 것이 좋지만, IG의 예에서 끌어온 샘플 리소스가 있는 http 파일도 있으므로 이를 사용하여 리소스를 만들고 테스트할 수 있습니다.

Touchstone 읽기 테스트 실행 결과입니다.

Touchstone EOB 쿼리 테스트

다음으로 검토할 테스트는 EOB 쿼리 테스트입니다. 읽기 테스트를 이미 완료한 경우 필요한 모든 데이터가 로드됩니다. 이 테스트는 다양한 매개 변수를 사용하여 특정 PatientExplanationOfBenefit 리소스를 검색할 수 있는지 유효성을 검사합니다.

Touchstone EOB 쿼리 실행 결과입니다.

Touchstone 오류 처리 테스트

마지막 테스트는 오류 처리 테스트입니다. 수행해야 하는 유일한 단계는 데이터베이스에서 ExplanationOfBenefit 리소스를 삭제하고 테스트에서 삭제된 ExplanationOfBenefit 리소스의 ID를 사용하는 것입니다.

Touchstone EOB 오류 처리 결과입니다.

다음 단계

이 자습서에서는 Touchstone에서 Blue Button용 CARIN IG 테스트를 통과하는 방법을 안내했습니다. 다음으로 Da Vinci 수식 테스트를 테스트하는 방법을 검토할 수 있습니다.

참고 항목

FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.