다음을 통해 공유


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개의 새 검색 매개 변수를 정의해야 합니다. 이 여섯 가지 매개 변수는 모두 기능 문서에서 테스트됩니다.

참고 항목

이러한 검색 매개 변수에 대한 원시 JSON에서 이름은 Plannet_sp_<Resource Name>_<SearchParameter Name>으로 설정됩니다. Touchstone 테스트에서는 이러한 이름만 SearchParameter Name(검사 영역, 플랜 유형 또는 네트워크)이 될 것으로 예상합니다.

Da Vinci Plan-Net IG에 필요한 나머지 검색 매개 변수는 기본 사양에 정의되어 있으며 추가 업데이트 없이도 Azure API for FHIR에서 이미 사용할 수 있습니다.

프로필 저장

검색 매개 변수를 정의하는 것 외에는 이 테스트를 통과하기 위해 필요한 프로필 및 확장을 로드해야 합니다. Da Vinci Plan-Net IG의 일부로 사용되는 아홉 가지 프로필이 있습니다.

샘플 나머지 파일

이러한 검색 매개 변수 및 프로필 생성을 지원하기 위해 오픈 소스 사이트에 앞에서 설명한 모든 단계가 단일 파일에 포함된 샘플 http 파일이 있습니다. 필요한 프로필과 검색 매개 변수를 모두 업로드한 후에는 Touchstone에서 기능 문 테스트를 실행할 수 있습니다.

Da Vinci plan net 샘플 REST 테스트 실행 스크립트 통과

Touchstone 오류 처리 테스트

살펴볼 두 번째 테스트는 오류 처리 테스트입니다. 수행해야 하는 유일한 단계는 데이터베이스에서 HealthcareService 리소스를 삭제하고 테스트에서 삭제된 HealthcareService 리소스의 ID를 사용하는 것입니다. 오픈 소스 사이트의 샘플 DaVinci_PlanNet.http 파일은 이 단계에 대해 게시하고 삭제하는 예제 HealthcareService를 제공합니다.

Da Vinci plan net touchstone 오류 테스트 실행 스크립트 통과

Touchstone 쿼리 테스트

살펴볼 다음 테스트는 쿼리 기능 테스트입니다. 이 테스트는 첫 번째 테스트에서 로드한 프로필에 대한 부합성을 테스트합니다. 프로필에 부합하는 리소스를 로드해야 합니다. 데이터베이스에 이미 있는 리소스에 대해 테스트하는 것이 좋습니다. IG의 예제에서 가져온 샘플 리소스가 있는 DaVinci_PlanNet_Sample_Resources.http 파일도 있어 이를 사용하여 리소스를 생성하고 테스트할 수 있습니다.

Da Vinci plan net 쿼리 테스트 실패

참고 항목

샘플 리소스를 제공하면 쿼리 테스트의 성공률이 98%에 해당합니다. 이러한 테스트 중 하나가 실패하는 FHIR 서버에 대해 열린 GitHub 문제가 있습니다.

리소스는 기본 조건과 _include 조건을 모두 충족하는 경우 여러 번 반환됩니다. 자세한 내용은 이슈 #2037을 참조하세요.

다음 단계

이 자습서에서는 Azure API for FHIR을 설정하여 Da Vinci PDEX Payer Network(Plan-Net) 구현 가이드에 대한 Touchstone 테스트를 통과하는 방법을 안내했습니다. Azure API for FHIR에서 지원되는 기능에 대한 자세한 내용은 다음을 참조하세요.

참고 항목

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