Azure API for FHIR을 위한 Da Vinci Plan Net
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의 진화된 버전입니다.
이 자습서에서는 Da Vinci PDEX Payer Network(Plan-Net) 구현 가이드(IG)에 대한 Touchstone 테스트를 통과하기 위해 Azure API for FHIR에서 FHIR® 서비스를 설정하는 과정을 안내합니다.
Touchstone 기능 문
중점을 둘 첫 번째 테스트에서는 Da Vinci Plan-Net 기능 문서를 바탕으로 Azure API for FHIR을 테스트합니다. 업데이트 없이 이 테스트를 실행하면 검색 매개 변수 및 프로필 누락으로 인해 테스트가 실패합니다.
검색 매개 변수 정의
Da Vinci Plan-Net IG의 일부로 의료 서비스, 보험 플랜, 의료진 역할, 조직 및 조직 제휴 리소스에 대한 6개의 새 검색 매개 변수를 정의해야 합니다. 이 여섯 가지 매개 변수는 모두 기능 문서에서 테스트됩니다.
- Healthcare Service Coverage Area
- Insurance Plan Coverage Area
- Insurance Plan Plan Type
- Organization Coverage Area
- Organization Affiliation Network
- Practitioner Role Network
참고 항목
이러한 검색 매개 변수에 대한 원시 JSON에서 이름은 Plannet_sp_<Resource Name>_<SearchParameter Name>
으로 설정됩니다. Touchstone 테스트에서는 이러한 이름만 SearchParameter Name
(검사 영역, 플랜 유형 또는 네트워크)이 될 것으로 예상합니다.
Da Vinci Plan-Net IG에 필요한 나머지 검색 매개 변수는 기본 사양에 정의되어 있으며 추가 업데이트 없이도 Azure API for FHIR에서 이미 사용할 수 있습니다.
프로필 저장
검색 매개 변수를 정의하는 것 외에는 이 테스트를 통과하기 위해 필요한 프로필 및 확장을 로드해야 합니다. Da Vinci Plan-Net IG의 일부로 사용되는 아홉 가지 프로필이 있습니다.
- Plan-Net Endpoint
- Plan-Net Healthcare Service
- Plan-Net InsurancePlan
- Plan-Net Location
- Plan-Net Network
- Plan-Net Organization
- Plan-Net OrganizationAffiliation
- Plan-Net Practitioner
- Plan-Net PractitionerRole
샘플 나머지 파일
이러한 검색 매개 변수 및 프로필 생성을 지원하기 위해 오픈 소스 사이트에 앞에서 설명한 모든 단계가 단일 파일에 포함된 샘플 http 파일이 있습니다. 필요한 프로필과 검색 매개 변수를 모두 업로드한 후에는 Touchstone에서 기능 문 테스트를 실행할 수 있습니다.
Touchstone 오류 처리 테스트
살펴볼 두 번째 테스트는 오류 처리 테스트입니다. 수행해야 하는 유일한 단계는 데이터베이스에서 HealthcareService 리소스를 삭제하고 테스트에서 삭제된 HealthcareService 리소스의 ID를 사용하는 것입니다. 오픈 소스 사이트의 샘플 DaVinci_PlanNet.http 파일은 이 단계에 대해 게시하고 삭제하는 예제 HealthcareService를 제공합니다.
Touchstone 쿼리 테스트
살펴볼 다음 테스트는 쿼리 기능 테스트입니다. 이 테스트는 첫 번째 테스트에서 로드한 프로필에 대한 부합성을 테스트합니다. 프로필에 부합하는 리소스를 로드해야 합니다. 데이터베이스에 이미 있는 리소스에 대해 테스트하는 것이 좋습니다. IG의 예제에서 가져온 샘플 리소스가 있는 DaVinci_PlanNet_Sample_Resources.http 파일도 있어 이를 사용하여 리소스를 생성하고 테스트할 수 있습니다.
참고 항목
샘플 리소스를 제공하면 쿼리 테스트의 성공률이 98%에 해당합니다. 이러한 테스트 중 하나가 실패하는 FHIR 서버에 대해 열린 GitHub 문제가 있습니다.
리소스는 기본 조건과 _include
조건을 모두 충족하는 경우 여러 번 반환됩니다. 자세한 내용은 이슈 #2037을 참조하세요.
다음 단계
이 자습서에서는 Azure API for FHIR을 설정하여 Da Vinci PDEX Payer Network(Plan-Net) 구현 가이드에 대한 Touchstone 테스트를 통과하는 방법을 안내했습니다. Azure API for FHIR에서 지원되는 기능에 대한 자세한 내용은 다음을 참조하세요.
참고 항목
FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.