Teilen über

Versionsverwaltungsrichtlinien und Verlaufsverwaltung

  • Artikel

Die Versionsverwaltungsrichtlinie im Azure Health Data Services FHIR-Dienst ist eine Konfiguration, die bestimmt, wie der Verlauf für jeden Ressourcentyp mit der Option für die ressourcenspezifische Konfiguration gespeichert wird. Diese Richtlinie steht in direktem Zusammenhang mit dem Konzept der Verwaltung des Verlaufs für FHIR-Ressourcen.

Geschichte in FHIR

Der Verlauf in FHIR bietet Ihnen die Möglichkeit, alle vorherigen Versionen einer Ressource anzuzeigen. Der Verlauf in FHIR kann auf Ressourcenebene, Typebene oder Systemebene abgefragt werden. Die HL7 FHIR-Dokumentation enthält weitere Informationen zur Verlaufsinteraktion. Der Verlauf ist nützlich in Szenarien, in denen Sie die Entwicklung einer Ressource in FHIR sehen möchten oder wenn Sie die Informationen zu einer Ressource zu einem bestimmten Zeitpunkt anzeigen möchten.

Alle früheren Versionen einer Ressource gelten als veraltet, und die aktuelle Version einer Ressource sollte für normale Geschäftsworkflowvorgänge verwendet werden. Es kann jedoch hilfreich sein, den Zustand einer Ressource als Zeitpunkt zu sehen, zu dem eine vergangene Entscheidung getroffen wurde.

Versioning policy (Versionsverwaltungsrichtlinie)

Mit der Versionsverwaltungsrichtlinie im FHIR-Dienst können Sie entscheiden, wie der Verlauf entweder auf einer FHIR-Dienstebene oder auf einer bestimmten Ressourcenebene gespeichert wird.

Es gibt drei verschiedene Ebenen für die Versionsverwaltungsrichtlinie:

  • versioned: Der Verlauf wird für den Vorgang mit Ressourcen gespeichert. Die Ressourcenversion wird erhöht. Dies ist die Standardoption.
  • version-update: Der Verlauf wird für den Vorgang mit Ressourcen gespeichert. Die Ressourcenversion wird erhöht. Aktualisierungen erfordern einen gültigen If-Match Header. Weitere Informationen finden Sie unter VersionedUpdateExample.http.
  • no-version: Der Verlauf wird nicht für Ressourcen erstellt. Die Ressourcenversion wird erhöht.

Versionsverwaltungsrichtlinie, die als systemweite Einstellung konfiguriert und auch auf Ressourcenebene überschrieben werden kann. Die systemweite Einstellung wird für alle Ressourcen in Ihrem FHIR-Dienst verwendet, es sei denn, eine bestimmte Versionsverwaltungsrichtlinie auf Ressourcenebene wurde hinzugefügt.

Versionsverwaltungsrichtlinienvergleich

Richtlinienwert Verlaufsverhalten meta.versionId Updateverhalten Standard
versioned Der Verlauf wird gespeichert. If-Match nicht erforderlich Ja
version-update Der Verlauf wird gespeichert. If-Match erforderlich Nein
no-version Der Verlauf wird nicht gespeichert. If-Match nicht erforderlich Nein

Hinweis

Das Ändern der Versionsverwaltungsrichtlinie in no-version hat keine Auswirkungen auf den vorhandenen Ressourcenverlauf. Wenn der Verlauf für Ressourcen entfernt werden muss, verwenden Sie den Vorgang $purge-history .

Konfigurieren der Versionsverwaltungsrichtlinie

Wählen Sie zum Konfigurieren der Versionsverwaltungsrichtlinie das Blatt Versionsverwaltungsrichtliniekonfiguration in Ihrem FHIR-Dienst aus.

Screenshot der Konfiguration der Azure-Portal-Versionsverwaltungsrichtlinie.

Nachdem Sie die Konfiguration der Versionsverwaltungsrichtlinie durchsucht haben, können Sie die Einstellung sowohl auf System- als auch auf Ressourcenebene (als Außerkraftsetzung der Systemebene) konfigurieren. Die Konfiguration auf Systemebene (kommentiert als 1) gilt für jede Ressource in Ihrem FHIR-Dienst, es sei denn, eine ressourcenspezifische Außerkraftsetzung (mit Anmerkungen 2) wurde konfiguriert.

Screenshot der Konfiguration Azure-Portal Versionsverwaltungsrichtlinie mit der Konfiguration auf Systemebene im Vergleich zur Konfiguration auf Ressourcenebene.

Beim Konfigurieren der Konfiguration auf Ressourcenebene können Sie den FHIR-Ressourcentyp (kommentiert als 1) und die spezifische Versionsverwaltungsrichtlinie für diese bestimmte Ressource (mit Anmerkungen 2) auswählen. Stellen Sie sicher, dass Sie die Schaltfläche Hinzufügen (mit Anmerkungen 3) auswählen, um diese Einstellung zum Speichern in die Warteschlange zu stellen.

Screenshot der Konfiguration Azure-Portal Versionsverwaltungsrichtlinie mit der Konfiguration auf Ressourcenebene.

Stellen Sie sicher, dassSie Speichern auswählen, nachdem Sie die Konfiguration der Versionsverwaltungsrichtlinie abgeschlossen haben.

Screenshot der Konfigurationskonfiguration Azure-Portal Versionsverwaltungsrichtlinie mit der Schaltfläche

Verlaufsverwaltung

Der Verlauf in FHIR ist wichtig für Endbenutzer, um zu sehen, wie sich eine Ressource im Laufe der Zeit geändert hat. Es ist auch hilfreich in Abstimmung mit Überwachungsprotokollen, um den Status einer Ressource vor und nach der Änderung durch einen Benutzer anzuzeigen. Im Allgemeinen wird empfohlen, den Verlauf für eine Ressource zu speichern, es sei denn, Sie wissen, dass der Verlauf nicht benötigt wird. Häufige Aktualisierungen von Ressourcen können zu einer großen Menge an Datenspeicher führen, was in FHIR-Diensten mit einer großen Datenmenge nicht erwünscht sein kann.

Wenn Sie die Versionsverwaltungsrichtlinie entweder auf System- oder Ressourcenebene ändern, wird der vorhandene Verlauf für Ressourcen in Ihrem FHIR-Dienst nicht entfernt. Wenn Sie die Größe der Verlaufsdaten in Ihrem FHIR-Dienst verringern möchten, müssen Sie den Vorgang $purge-history verwenden.

Nächste Schritte

In diesem Artikel haben Sie erfahren, wie Sie den Verlauf für Ressourcen im FHIR-Dienst bereinigen. Weitere Informationen zum Deaktivieren des Verlaufs und zu einigen Konzepten zur Verlaufsverwaltung finden Sie unter

Verlaufslöschvorgang

FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.