共用方式為


版本設定原則和歷程記錄管理

Azure 健康資料服務服務 FHIR 服務中的版本設定原則是一種設定,可決定每個資源類型的歷程記錄儲存方式,以及資源特定設定的選項。 此原則與管理 FHIR 資源的歷程記錄概念直接相關。

FHIR 中的歷程記錄

FHIR 中的歷程記錄可讓您查看所有過去的資源。 可以在資源層級、類型層級或系統層級查詢 FHIR 中的歷程記錄。 HL7 FHIR 文件有更多有關 歷程記錄互動 的詳細資訊。 歷程記錄適用於您想要查看 FHIR 中資源演進的案例,或如果您想要在特定時間點查看資源的資訊。

所有過去的資源版本都會被視為過時,且目前版本的資源應該用於一般商務工作流程作業。 不過,將資源的狀態視為過去決策的時間點可能會很有用。

版本控制原則

FHIR 服務中的版本設定原則可讓您決定記錄儲存在 FHIR 服務層級或特定資源層級的方式。

版本控制原則有三個不同的層級:

  • versioned:記錄會儲存在資源上的作業。 資源版本會遞增。 這是預設值。
  • version-update:記錄會儲存在資源上的作業。 資源版本會遞增。 更新需要有效的 If-Match 標頭。 如需詳細資訊,請參閱 VersionedUpdateExample.http
  • no-version:不會為資源建立歷程記錄。 資源版本會遞增。

可用來設定為全系統設、亦可以在資源層級覆寫的版本控制原則。 除非已新增特定的資源層級版本控制原則,否則全系統設定會用於 FHIR 服務中的所有資源。

版本控制原則比較

原則值 歷程記錄行為 meta.versionId 更新行為 預設
versioned 歷程記錄已儲存 不需要 If-Match Yes
version-update 歷程記錄已儲存 需要 If-Match No
no-version 尚未儲存歷程記錄 不需要 If-Match No

注意

將版本控制原則變更為 no-version 不會影響現有的資源歷程記錄。 如果需要針對資源移除歷程記錄,請使用 $purge-history 作業。

設定版本控制原則

若要設定版本控制原則,請選取 FHIR 服務內的 [版本設定原則設定] 刀鋒視窗。

Screenshot of the Azure portal Versioning Policy Configuration.

瀏覽至 [版本控制原則設定] 之後,您將能夠在系統層級和資源層級配置設定 (作為系統層級的覆寫)。 系統層級設定 (標註為 1) 將套用至 FHIR 服務中的每個資源,除非已設定資源特定的覆寫 (標註為 2)。

Screenshot of Azure portal versioning policy configuration showing system level vs resource level configuration.

設定資源層級設定時,您將能夠選取 FHIR 資源類型 (標註為 1),以及此特定資源的特定版本控制原則 (標註為 2)。 請務必選取 [新增] 按鈕 (標註為 3),以將此設定排入佇列以儲存。

Screenshot of Azure portal versioning policy configuration showing resource level configuration.

完成版本設定原則之後,請確定 選取 [儲存]

Screenshot of Azure portal versioning policy configuration configuration showing save button.

歷程記錄管理

FHIR 中的歷程記錄對於終端使用者而言很重要,以了解資源在一段時間內如何變更。 它也有助於與稽核記錄協調,以查看使用者修改資源之前和之後的狀態。 一般而言,除非您知道不需要歷程記錄,否則建議保留資源的歷程記錄。 資源的頻繁更新可能會導致大量資料儲存,而有大量資料的 FHIR 服務不會歡迎此儲存。

在系統層級或資源層級變更版本控制原則並不會移除 FHIR 服務中任何資源的現有歷程記錄。 如果您想要減少 FHIR 服務中的歷程記錄資料大小,您必須使用 $purge 歷程記錄 作業。

下一步

在本文中,您已了解如何清除 FHIR 服務中資源的歷程記錄。 如需如何停用歷程記錄的詳細資訊,以及有關歷程記錄管理的某些概念,請參閱

FHIR® 是 HL7 的註冊商標,可與 HL7 的權限搭配使用。