バージョン管理ポリシーと履歴管理

[アーティクル]
06/01/2023

Azure Health Data Services FHIR サービスのバージョン管理ポリシーは構成であり、リソース固有の構成のオプションを使用して、リソースの種類ごとに履歴を格納する方法を決定します。このポリシーは、FHIR リソースの履歴管理の概念に直接関連しています。

FHIR の履歴

FHIR の履歴を使用すると、以前のすべてのバージョンのリソースを表示できます。 FHIR の履歴は、リソースレベル、種類レベル、またはシステムレベルで照会できます。 HL7 FHIR のドキュメントには、履歴の相互作用に関する詳細が記載されています。履歴は、FHIR でリソースの進化を確認する場合や、特定の時点でリソースの情報を表示する場合に便利です。

リソースの過去のバージョンはすべて古いと見なされ、リソースの現在のバージョンは通常のビジネスワークフロー操作に使用する必要があります。ただし、リソースの状態を、過去の決定が行われた時点として確認すると便利な場合があります。

バージョン管理ポリシー

FHIR サービスのバージョン管理ポリシーを使用すると、FHIR サービスレベルまたは特定のリソースレベルで履歴を格納する方法を決定できます。

バージョン管理ポリシーには、次の 3 つの異なるレベルがあります。

versioned: リソースに対する操作の履歴が格納されます。リソースのバージョンがインクリメントされます。既定値です。
version-update: リソースに対する操作の履歴が格納されます。リソースのバージョンがインクリメントされます。更新有効なヘッダーが必要ですIf-Match。詳細については、「 VersionedUpdateExample.http」を参照してください。
no-version: リソースの履歴は作成されません。リソースのバージョンがインクリメントされます。

システム全体の設定としてを構成したり、リソースレベルでオーバーライドしたりするために使用できるバージョン管理ポリシー。システム全体の設定は、特定のリソースレベルのバージョン管理ポリシーが追加されていない限り、FHIR サービス内のすべてのリソースに使用されます。

バージョン管理ポリシーの比較

ポリシー値	履歴の動作	`meta.versionId` 更新の動作	Default
`versioned`	履歴が保存される	If-Matchは必要ありません	はい
`version-update`	履歴が保存される	If-Matchが必要です	いいえ
`no-version`	履歴が保存されない	If-Matchは必要ありません	いいえ

注意

バージョン管理ポリシーをに no-version 変更しても、既存のリソース履歴には影響しません。リソースの履歴を削除する必要がある場合は、 $purge履歴操作を使用します。

バージョン管理ポリシーの構成

バージョン管理ポリシーを構成するには、FHIR サービス内の [ バージョン管理ポリシーの構成] ブレードを選択します。

[バージョン管理ポリシーの構成] を参照すると、(システムレベルのオーバーライドとして) システムレベルとリソースレベルの両方で設定を構成できるようになります。システムレベルの構成 (1 として注釈付き) は、リソース固有のオーバーライド (2 で注釈付き) が構成されていない限り、FHIR サービス内のすべてのリソースに適用されます。

リソースレベル構成を構成するときに、FHIR リソースの種類 (1 として注釈付き) と、この特定のリソースの特定のバージョン管理ポリシー (2 として注釈付き) を選択できます。必ず [ 追加 ] ボタン (3 として注釈付き) を選択して、この設定を保存用にキューに登録してください。

バージョン管理ポリシーの構成が完了したら、必ず[保存] を選択してください。

履歴管理

FHIR の履歴は、エンドユーザーが時間の経過と同時にリソースがどのように変化したかを確認するために重要です。また、監査ログと連携して、ユーザーがリソースを変更する前と後にリソースの状態を確認する場合にも役立ちます。一般に、履歴が必要ないことがわかっている場合を除き、リソースの履歴を保持することをお勧めします。リソースを頻繁に更新すると大量のデータストレージが発生する可能性があり、大量のデータを含む FHIR サービスでは望ましくない可能性があります。

システムレベルまたはリソースレベルでバージョン管理ポリシーを変更しても、FHIR サービス内のリソースの既存の履歴は削除されません。 FHIR サービスの履歴データサイズを小さくする場合は、 $purge履歴操作を使用する必要があります。

次のステップ

この記事では、FHIR サービスのリソースの履歴を消去する方法について説明しました。履歴を無効にする方法と履歴管理に関するいくつかの概念の詳細については、次を参照してください。

消去履歴操作

FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。

次の方法で共有