Da Vinci Plan Net for Azure API for FHIR
重要
Azure API for FHIR 將於 2026 年 9 月 30 日淘汰。 請依照移轉策略，在該日期前轉換至 Azure 健康資料服務 FHIR® 服務。 由於 Azure API for FHIR 已淘汰，因此從 2025 年 4 月 1 日開始，將不允許新的部署。 Azure 健康資料服務 FHIR 服務是 Azure API for FHIR 的進化版本，可讓客戶透過與其他 Azure 服務整合來管理 FHIR、DICOM 和醫療技術服務。
在本教學課程中，我們將逐步說明如何在 Azure API for FHIR 中設定 FHIR® 服務，以通過 Da Vinci PDEX Payer Network (Plan-Net) 實作指南 (IG) 的 Touchstone 測試。
Touchstone 能力聲明
我們關注的第一個測試是根據 Da Vinci Plan-Net 能力聲明測試 Azure API for FHIR。 如果您在沒有任何更新的情況下執行此測試，測試會因為缺少搜尋參數和設定檔而失敗。
定義搜尋參數
作為 Da Vinci Plan-Net 實作指南的一部分，您必須為醫療保健服務、保險計畫、從業者角色、組織和組織聯盟資源定義六個新的搜尋參數。 這六個參數都會在能力聲明中測試。
注意
在這些搜尋參數的原始 JSON 中，名稱會設定為 Plannet_sp_<Resource Name>_<SearchParameter Name>。 Touchstone 測試預期這些參數的名稱只會是 SearchParameter Name (涵蓋區域、計畫類型或網路)。
Da Vinci Plan-Net 實作指南所需的其餘搜尋參數是由基底規格所定義，且已經可在 Azure API for FHIR 中使用，無需任何其他更新。
Store 設定檔
在定義搜尋參數之外，您必須載入必要的設定檔和延伸模組，才能通過此測試。 Da Vinci Plan-Net 實作指南中使用了九個設定檔。
- 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
範例 rest 檔案
為了協助建立這些搜尋參數和設定檔，我們在開放原始碼網站上提供了範例 http 檔案，在單一檔案中包含前述的所有步驟。 上傳所有必要的設定檔和搜尋參數之後，您就可以在 Touchstone 中執行能力聲明測試。
Touchstone 錯誤處理測試
我們逐步解說的第二個測試，是測試錯誤處理。 您必須執行的唯一步驟是從資料庫刪除 HealthcareService 資源，並在測試中使用已刪除之 HealthcareService 資源的識別碼。 開放原始碼網站中的範例 DaVinci_PlanNet.http 檔案提供範例 HealthcareService，以在此步驟中張貼和刪除。
Touchstone 查詢測試
我們逐步解說的下一個測試，是查詢功能測試。 這會測試針對您在第一個測試中載入的設定檔是否一致。 您必須載入符合設定檔的資源。 建議您針對資料庫中已有的資源進行測試。 我們還有 DaVinci_PlanNet_Sample_Resources.http 檔案，其中包含從 IG 中的範例提取的範例資源，可供您用來建立資源並加以測試。
注意
使用提供的範例資源，您應該預期查詢測試的成功率為 98%。 FHIR 伺服器有一個尚未解決的 GitHub 問題，導致其中一個測試失敗。
一項資源若同時符合基底準則和 _include 準則，就會傳回多次。 如需詳細資訊，請參閱問題 #2037。
下一步
在本教學課程中，我們已逐步說明如何設定 Azure API for FHIR，以通過 Da Vinci PDEX Payer Network (Plan-Net) 實作指南的 Touchstone 測試。 如需 Azure API for FHIR 中支援功能的詳細資訊，請參閱
注意
FHIR® 是 HL7 的註冊商標，在 HL7 的許可下使用。