版本資訊 2025 年前：Azure API for FHIR

發行項
12/06/2024

重要

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® 提供適用於 Azure Microsoft FHIR Server 的完整受控部署。伺服器是 FHIR 標準的實作。本檔提供 Azure API for FHIR 之功能和增強功能的詳細數據。

2024年11月

FHIR 服務

錯誤修正

匯出驗證改進：即使搜尋參數無效，仍發現匯出繼續進行的問題。實作新的變更，以防止在這些情況下導出。此為預設行為。客戶可以使用 lenient 旗標來覆寫它。此變更已於上個月傳達給客戶。
套件組合效能增強：套件組合執行期間的配置檔重新整理程式已簡化。如果套件組合包含、 StructureDefinition和/或 CodeSystem的變更ValueSet，在套件組合完全完成之前，將不會進行任何配置檔重新整理。這項變更可藉由減少處理這些資源類型變更時，多個重新整理所造成的延遲，來改善套件組合的效能。
內容類型標頭剖析：已解決並解決剖 application/x-www-form-urlencoded 析內容類型標頭的相關問題。
重新編製索引增強功能：已藉由移除先前限制處理大型歷程記錄數據集的人工限制，或客戶要求有限查詢大小的案例，來改善重新編製索引作業。此外，使用預設查詢大小處理許多循序歷程記錄或刪除的資源時，重新編製索引程式會錯誤地回報為「已完成」。此問題已解決，以確保重新編製索引程式已正確完成，並報告適當的狀態。

2024 年 10 月

FHIR 服務

錯誤修正

匯出驗證：儘管搜尋參數無效，但已識別匯出繼續進行的問題。我們正在引入一項變更，以防止在這些條件下匯出。這項功能目前落後於嚴格的驗證旗標，並將成為 10 月 30 日或之後的預設行為。
搜尋參數包含：我們已解決其他搜尋參數（例如， _include、 _has）未傳回所有預期結果的問題，有時省略下一個連結。
匯出作業執行：已藉由防止過早結束來解決匯出作業完成期間罕見的情況 System.ObjectDisposedException 。
HTTP 狀態代碼更新：作業建立期間 $reindex 無效參數的 HTTP 狀態代碼現在會更新為 400，以確保更好的錯誤處理。
搜尋參數清除：已實作修正，以確保使用刪除 API 呼叫觸發時，完整清除資料庫中的搜尋參數，解決與不完整刪除相關的問題。

2024 年 8 月

FHIR 服務

錯誤修正 已實作修正修正，以解決大型匯出在子工作仍在處理時，顯示「已完成」狀態的問題。此解決方案包含延遲以減輕這些狀態錯誤的發生，以改善匯出可靠性。

2024 年 7 月

FHIR 服務

Bug 修正

已修正：將數據匯出為SMART使用者將數據匯出為SMART使用者 不再需要寫入範圍。之前，必須將「寫入」許可權授與SMART用戶以匯出數據，這隱含較高的許可權等級。若要以SMART使用者身分起始匯出作業，請確定使用者是 RBAC 中 FHIR 匯出角色的成員，並要求「讀取」SMART 臨床範圍。

已修正：如果在修補作業期間，將狀態代碼從 HTTP 500 更新為 HTTP 400 ，如果承載要求更新參數以外的資源類型，則一開始擲回內部伺服器錯誤（HTTP 500）。這已更新為改為擲回 HTTP 400 錯誤。

2024年5月

FHIR 服務

清除歷程記錄作業 的增強功能清除歷程記錄作業可讓您使用查詢參數『allowPartialSuccess』來執行部分刪除。根據預設，清除歷程記錄作業會在刪除資源之前等候成功完成。不過，如果在執行期間發生錯誤，則會回復刪除資源。藉由使用 'allowPartialSuccess' 查詢參數，您就可以在發生錯誤時防止交易回復。

錯誤修正

已修正：長時間執行要求的 HTTP 狀態代碼。需要超過 100 秒來執行的 FHIR 要求會傳回 HTTP 408 狀態代碼，而不是 HTTP 500。
已修正：套件組合中的歷程記錄要求。在修正之前，套件組合中的歷程記錄要求傳回 HTTP 狀態代碼 404。

2024 年 3 月

批次組合平行處理 Batch 套件組合預設會在 FHIR 服務中以序列方式執行。為了改善套件組合呼叫的輸送量，我們啟用批次配套的平行處理。

深入了解：

批次配套平行處理

Bug 修正

已修正：改善套件組合處理的效能。系統會更新工作執行方法，進而改善處理效能。請參閱 PR#3727。

2024 年 2 月

啟用計算資源 的所有版本（歷程記錄和虛刪除），查詢參數 _summary=count 和 _count=0 可以新增至_history端點，以取得所有版本設定的資源計數。此計數包含虛刪除的資源。如需詳細資訊，請參閱歷程記錄管理。

改善匯出作業 的輸送量：可以將「_isparallel」查詢參數新增至匯出作業，以增強其輸送量。請務必注意，使用此參數可能會導致在導出生命週期內增加要求單位耗用量。如需詳細資訊，請參閱匯出作業查詢參數。

注意

$export作業有一個已知問題，可能會導致狀態成功的匯出不完整。使用is_parallel旗標時發生問題。從 2024 年 2 月 13 日起，使用 _isparallel 查詢參數執行的導出作業會受到此問題的影響。

針對導出的檔名和預設記憶體帳戶 變更名稱名稱，若有這項變更，導出的檔名會遵循格式為『FHIR 資源名稱}-{Number}-{Number}.ndjson』。不保證檔案的順序會對應至資料庫中資源的任何順序。默認記憶體帳戶名稱會更新為『Export-{Number}』。不會變更個別導出檔案中新增的資源數目。

您可以使用 HTTP 標頭「x-ms-query-latency-over-efficiency」來啟用 FHIR 查詢的效能增強 平行優化。此值必須設定為 true，才能在查詢執行期間達到最大並行。如需詳細資訊，請參閱 Batch 配套。

2024 年 1 月

條件式互動 的查詢並行執行可能會相當複雜且效能密集。若要增強涉及條件式互動的查詢延遲，您可以選擇使用要求標頭 x-conditionalquery-processing-logic。如需詳細資訊，請參閱條件式 API 互動的效能考慮。

2023 年 12 月

新增至匯出作業 的其他功能$export作業現在支援匯出已建立版本的資源和虛刪除的資源。如需詳細資訊，請參閱匯出查詢參數。

2023 年 11 月

預覽版『$bulk-delete』中現已提供大量刪除功能，可讓您以異步方式從 FHIR 伺服器刪除資源。大量刪除作業可以在系統層級或針對個別資源類型執行。如需詳細資訊，請參閱大量刪除作業。

大量刪除作業目前為公開預覽狀態。如需詳細資料，請檢閱免責聲明。 [!包含公開預覽免責聲明]

錯誤修正：使用分頁和重新提示的 FHIR 查詢導致使用下一個連結時發生錯誤

問題現已解決，且 FHIR 查詢使用接續令牌搭配 include/ revinclude，不再報告例外狀況。如需修正的詳細資訊，請造訪 #3525。

2023 年 6 月

錯誤修正：功能語句中的元數據端點 URL 是相對 URL Per FHIR 規格，功能語句中的元數據端點 URL 必須是絕對 URL。如需 FHIR 規格的詳細資訊，請流覽 Capability 語句。如需詳細數據，請參閱 3265。

2023 年 5 月

SMART on FHIR ：已修正應用程式的臨床範圍對應

此錯誤修正解決了後端應用程式未正確解譯臨床範圍的問題。如需詳細資訊，請造訪 #3250

2023 年 4 月

已修正與載入自定義搜尋參數 相關聯的暫時性問題：Bug 修正了問題，其中 FHIR 服務不會在失敗時載入最新的 SearchParameter 狀態。如需詳細資訊，請造訪 #3222

2022 年 11 月

已修正使用 if-match 標頭和 PATCH 更新資源時所產生的錯誤

現在已修正 Bug，如果資源符合 Etag 標頭，則會更新它。如需詳細資訊，請參閱 #2877|。

2022 年 5 月

增強

增強功能	相關資訊
如果資源內容未變更，Azure API for FHIR 不會建立新版本的資源。	如果使用者更新現有的資源，而且只有 meta.versionId 或 meta.lastUpdated 已變更，則我們會傳回 OK 與現有的資源資訊，而不更新 VersionId 和 lastUpdated。如需詳細資訊，請參閱 #2519。

2022 年 4 月

增強功能

增強功能	相關資訊
FHIRPath Patch	FHIRPath Patch 已新增為 Azure API for FHIR 的功能。這會實作 HL7 網站上定義的 FHIRPath Patch。
將套件組合通知移至 Core	透過將 Resource.Bundle 命名空間引入 Core，字串資源檔案的資源參考必須更加明確。如需詳細資訊，請參閱 PR#2478。
處理版本更新時無效的標頭	當版本控制原則設定為「versioned-update」時，我們需要在更新時的要求 if-match 標頭中提供最新版本的資源。指定的版本必須是ETag格式。先前，如果版本無效或格式不正確，則會傳回 500。此更新現在會傳回 400 不正確的要求。如需詳細資訊，請參閱 PR #2467。

錯誤修正

錯誤修正	相關資訊
將核心新增至資源路徑	在版本控制原則中意外移除字串資源路徑的一部分。此修正程式會將它新增回去。如需詳細資訊，請參閱 PR#2470。
SQL 逾時傳回 500 錯誤	已修正當 SQL 要求達到逾時且要求傳回 500 時的錯誤。在記錄中，相較於從前端收到 429 錯誤，這是來自 SQL 的逾時。如需詳細資訊，請參閱 PR#2497。

2022 年 3 月

功能

功能	相關資訊
FHIRPath Patch	這項新功能可讓您在 FHIR 資源上使用 FHIRPath 修補作業。如需詳細資訊，請參閱適用於 Azure API for FHIR 的 FHIR REST API 功能。

錯誤修正

錯誤修正	相關資訊
使用搜尋中的重複資源 `_include`	已修正在具有 `_include`的搜尋中可以傳回單一資源兩次的問題。如需詳細資訊，請參閱 PR #2448。
PUT 會在版本更新時建立	已修正問題：當版本控制原則設定為 `versioned-update`時，使用PUT建立會導致錯誤。如需詳細資訊，請參閱 PR #2457。
版本更新上的標頭處理無效	已修正無效 `if-match` 標頭會導致 HTTP 500 錯誤的問題。現在會改為傳回 HTTP 不正確的要求。如需詳細資訊，請參閱 PR #2467。

2022 年 2 月

功能和增強功能

增強功能	相關資訊
已在 BundleHandler 中新增 429 次重試和記錄	處理套件組合時，我們有時會遇到 429 個錯誤。如果 FHIR 服務在 BundleHandler 層收到 429，我們會中止套件組合的處理，並略過其餘資源。我們已新增另一次重試（除了數據存放區層中存在的重試之外），每個遇到 429 的資源都會執行一次。如需這項功能增強的詳細資訊，請參閱 PR#2400。
和的 `$convert-data` 計費 `$de-id`	Azure API for FHIR 的數據轉換和已取消識別的導出功能現已正式推出。 `$convert-data`已啟用 Azure API for FHIR 中的計費和`$de-id`作業。計費計量已於 2022 年 3 月 1 日開啟。

錯誤修正

錯誤修正	相關資訊
更新區間搜尋索引	有一個角落案例，其中區間搜尋索引未在資源上設定。現在，我們會使用與主搜尋區間搜尋相同的索引，以確保傳回所有數據。如需程式代碼修正的詳細資訊，請參閱 PR#2430。

2021 年 12 月

功能和增強功能

增強功能	相關資訊
已將發行者新增至 `CapabilityStatement.name`	您現在可以在功能語句 `CapabilityStatement.name`中找到發行者。 #2319
記錄 `FhirOperation` 連結至要求計量的匿名呼叫	我們並未記錄不需要驗證的作業。我們擴充了取得 `FhirOperation` 匿名呼叫的輸入 `RequestMetrics` 功能。 #2295

錯誤修正

錯誤修正	相關資訊
已修正當 Code 為 null 時 `SearchParameter` 發生 500 錯誤	已修正如果 Code 有 Null 值的問題 `SearchParameter` ，結果會是 500。現在，它會產生類似 `InvalidResourceException` 其他值的。 #2343
當輸入 JSON 本文無效時， `BadRequestException` 傳回有效的訊息	對於無效的 JSON 主體要求，FHIR 伺服器傳回 500 錯誤。現在，我們會傳回 `BadRequestException` 具有有效訊息而非 500 的。 #2239
`_sort` 可能會傳 `ChainedSearch` 回不正確的結果	之前，未清除鏈結搜尋物件中的 `SearchOption` 排序選項，導致排序選項傳遞至鏈結子搜尋，但無效。當應該有結果時，這不會產生任何結果。這個 Bug 現在已修正 #2347。它已解決 GitHub Bug #2344。

2021 年 11 月

功能和增強功能

增強功能	相關資訊
處理病患一切連結	我們已擴充病患一切功能，以處理病患連結 #2305。如需詳細資訊，請參閱 FHIR 檔中的病患所有專案。
已將軟體名稱和版本新增至 capability 語句	在功能語句中，軟體名稱現在會區分您是否使用 Azure API for FHIR 或 Azure Health Data Services。軟體版本現在會指定受控服務 #2294 中的開放原始碼版本套件。位址： #1778 和 #2241
將 500s 記錄到 `RequestMetric`	先前，500 年代或任何未知/未處理的錯誤未登入 `RequestMetric`。他們現在會記錄 #2240。如需詳細資訊，請參閱在 Azure API for FHIR 中啟用診斷設定
壓縮接續令牌	在某些情況下，接續令牌太長，無法追蹤搜尋中的下一個連結，並會導致 404。為了解決此問題，我們壓縮了接續令牌，以確保它保持在大小限制 #2279 以下。解決問題 #2250。

錯誤修正

錯誤修正	相關資訊
解決當日期與時區一起傳遞時發生 500 錯誤。	當具有時區的日期傳遞至 datetime 欄位 #2270 時，這會修正 500 錯誤。
已解決在發佈套件組合時傳回不正確的媒體類型傳回 500 錯誤的問題。	先前使用包含特定字元的索引鍵張貼搜尋時，會傳回 500 錯誤。這會修正此問題 #2264，並解決 #2148。

2021 年 10 月

錯誤修正

無限迴圈 Bug	相關資訊
已修正條件式刪除可能會導致無限循環的問題。	#2269

2021 年 9 月

功能和增強功能

增強功能	相關資訊
已新增條件式修補的支援	條件式修補
條件式修補	#2163
已新增條件式修補程式稽核事件。	#2213

允許套件組合中的 JSON 修補程式	套件組合中的 JSON 修補程式
允許搭配修補程式要求進行搜尋歷程記錄組合。	#2156
使用二進位資源在套件組合中啟用 JSON 修補程式。	#2143

新的稽核事件子類型	相關資訊
已新增稽核 OperationName 子類型。	#2170

重新編製索引改善	相關資訊
已新增重新索引參數的界限。	#2103
更新重新編製參數界限的錯誤訊息。	#2109
已新增最終重新編製索引計數檢查。	#2099

錯誤修正

錯誤修正	相關資訊
套用修補程式時，例外狀況的較寬攔截。	#2192
修正 STU3 中 PATCH 的歷程記錄。	#2177

自定義搜尋錯誤	相關資訊
解決自定義搜尋參數失敗的問題。	#2133
已新增刪除搜尋參數時的重試邏輯。	#2121
在 SearchParameterDefinitionManager 中設定搜尋選項中的項目計數上限。	#2141
如果搜尋參數中有不正確的表達式，則提供更好的例外狀況。	#2157

已解決重試 503 錯誤	相關資訊
從 Azure Cosmos DB 重試 503 錯誤。	#2106
修正從 StoreProcedures 處理 429s。	#2165

GitHub 問題已關閉	相關資訊
無法為 CarePlan 醫療裝置建立自定義搜尋參數。	#2146
沒有標識符之條件式建立的錯誤訊息。	#2168

適用於 FHIR 的 IoT 連接器（預覽）

錯誤修正	相關資訊
已修正中斷的連結。	已更新 Azure API for FHIR 入口網站中 IoT 連接器 Azure 檔的連結。

下一步

如需 Azure Health Data Services 中功能和 Bug 修正的相關信息（FHIR 服務、DICOM 服務和 MedTech 服務），請參閱

版本資訊：Azure Health Data Services

注意

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

共用方式為

版本資訊 2025 年前：Azure API for FHIR

2024年11月

FHIR 服務

2024 年 10 月

FHIR 服務

2024 年 8 月

FHIR 服務

2024 年 7 月

FHIR 服務

2024年5月

FHIR 服務

2024 年 3 月

2024 年 2 月

2024 年 1 月

2023 年 12 月

2023 年 11 月

2023 年 6 月

2023 年 5 月

2023 年 4 月

2022 年 11 月

2022 年 5 月

增強

2022 年 4 月

增強功能

錯誤修正

2022 年 3 月

功能

錯誤修正

2022 年 2 月

功能和增強功能

錯誤修正

2021 年 12 月

功能和增強功能

錯誤修正

2021 年 11 月

功能和增強功能

錯誤修正

2021 年 10 月

錯誤修正

2021 年 9 月

功能和增強功能

錯誤修正

適用於 FHIR 的 IoT 連接器 （預覽）

下一步

意見反應

其他資源

適用於 FHIR 的 IoT 連接器（預覽）