適用於 Azure API for FHIR 的 Blue Button® 的 CARIN 實作指南

重要

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®,以通過 Blue Button 的 CARIN 實作指南 (C4BB IG) (英文) 的 Touchstone (英文) 測試。

Touchstone 能力聲明

我們關注的第一個測試是根據 C4BB IG 能力聲明 (英文) 測試 Azure API for FHIR。 如果您在沒有任何更新的情況下對 Azure API for FHIR 執行此測試,測試會因為缺少搜尋參數和設定檔而失敗。

定義搜尋參數

在 C4BB IG 中,您必須為 ExplanationOfBenefit 資源定義三個新的搜尋參數。 其中兩個參數會在能力聲明中測試 (type 和 service-date),而 _include 搜尋需要一個參數 (insurer)。

注意

在這些搜尋參數的原始 JSON 中,名稱會設定為 ExplanationOfBenefit_<SearchParameter Name>。 Touchstone 測試預期這些名稱會是 typeservice-dateinsurer

C4BB IG 所需的其餘搜尋參數是由基底規格所定義,且已經可在 Azure API for FHIR 中使用,而沒有其他更新。

Store 設定檔

除了定義搜尋參數之外,您要通過此測試而需要進行的其他更新是載入必要的設定檔。 C4BB IG 內已定義八個設定檔。

範例 rest 檔案

為了協助建立這些搜尋參數和設定檔,我們有範例 http 檔案 (英文),其在單一檔案中包含本教學課程概述的所有步驟。 上傳所有必要的設定檔和搜尋參數之後,您就可以在 Touchstone 中執行能力聲明測試。

功能測試指令碼執行結果。

Touchstone 讀取測試

在測試能力聲明後,針對 C4BB IG 測試 Azure API for FHIR 中的讀取功能 (英文)。 此會測試針對您在第一個測試中載入的八個設定檔的一致性。 您必須載入符合設定檔的資源。 我們建議針對您已在資料庫中擁有的資源進行測試,但我們也提供 http 檔案,內含從實作指南的範例中提取的範例資源,您可用於建立資源並進行測試。

Touchstone 讀取測試執行結果。

Touchstone EOB 查詢測試

我們會檢閱的下一個測試是 EOB 查詢測試。 如果您已完成讀取測試,則會載入您需要的所有資料。 此測試會驗證您可以用各種參數來搜尋特定 PatientExplanationOfBenefit 資源。

Touchstone EOB 查詢執行結果。

Touchstone 錯誤處理測試

我們會逐步解說的最後一個測試是測試錯誤處理。 您唯一需要執行的步驟是從資料庫中刪除 ExplanationOfBenefit 資源,並使用測試中已刪除 ExplanationOfBenefit 資源的識別碼。

Touchstone EOB 錯誤處理結果。

下一步

在本教學課程中,我們逐步解說了如何在 Touchstone 中通過 Blue Button 的 CARIN IG 測試。 接下來,您可以檢閱如何測試 Da Vinci 處方集測試。

注意

FHIR® 是 HL7 的註冊商標,在 HL7 的許可下使用。