Delen via

Versiebeheer en geschiedenisbeheer

  • Artikel

Het versiebeleid in de Azure Health Data Services FHIR-service is een configuratie die bepaalt hoe geschiedenis wordt opgeslagen voor elk resourcetype met de optie voor resourcespecifieke configuratie. Dit beleid is rechtstreeks gerelateerd aan het concept van het beheren van geschiedenis voor FHIR-resources.

Geschiedenis in FHIR

Geschiedenis in FHIR biedt u de mogelijkheid om alle vorige versies van een resource te bekijken. Geschiedenis in FHIR kan worden opgevraagd op resourceniveau, typeniveau of systeemniveau. De HL7 FHIR-documentatie bevat meer informatie over de interactie met de geschiedenis. Geschiedenis is handig in scenario's waarin u de ontwikkeling van een resource in FHIR wilt zien of als u de informatie van een resource op een bepaald tijdstip wilt zien.

Alle eerdere versies van een resource worden als verouderd beschouwd en de huidige versie van een resource moet worden gebruikt voor normale bedrijfswerkstroombewerkingen. Het kan echter handig zijn om de status van een resource te zien als een tijdstip waarop een eerdere beslissing is genomen.

Versiebeleid

Met versiebeleid in de FHIR-service kunt u bepalen hoe geschiedenis wordt opgeslagen op het niveau van een FHIR-service of op een specifiek resourceniveau.

Er zijn drie verschillende niveaus voor versiebeheerbeleid:

  • versioned: Geschiedenis wordt opgeslagen voor bewerking op resources. De resourceversie wordt verhoogd. Dit is de standaardinstelling.
  • version-update: Geschiedenis wordt opgeslagen voor bewerking op resources. De resourceversie wordt verhoogd. Updates hebt u een geldige If-Match header nodig. Zie VersionedUpdateExample.http voor meer informatie.
  • no-version: Geschiedenis wordt niet gemaakt voor resources. De resourceversie wordt verhoogd.

Versiebeleid beschikbaar om te configureren op als een systeembrede instelling en ook om op resourceniveau te overschrijven. De systeembrede instelling wordt gebruikt voor alle resources in uw FHIR-service, tenzij er een specifiek versiebeheerbeleid op resourceniveau is toegevoegd.

Vergelijking van versiebeleid

Beleidswaarde Geschiedenisgedrag meta.versionId Updategedrag Standaard
versioned Geschiedenis wordt opgeslagen If-Match niet vereist Yes
version-update Geschiedenis wordt opgeslagen If-Match vereist No
no-version Geschiedenis wordt niet opgeslagen If-Match niet vereist No

Notitie

Het wijzigen van het versiebeleid in no-version heeft geen effect op de bestaande resourcegeschiedenis. Als de geschiedenis moet worden verwijderd voor resources, gebruikt u de bewerking $purge geschiedenis .

Versiebeheerbeleid configureren

Als u versiebeleid wilt configureren, selecteert u de blade Configuratie van versiebeheerbeleid in uw FHIR-service.

Schermopname van de configuratie van versiebeheerbeleid Azure Portal.

Nadat u naar Configuratie van versiebeheerbeleid hebt gekeken, kunt u de instelling op zowel systeemniveau als resourceniveau configureren (als overschrijving van het systeemniveau). De configuratie op systeemniveau (geannoteerd als 1) is van toepassing op elke resource in uw FHIR-service, tenzij een resourcespecifieke onderdrukking (met aantekeningen bij 2) is geconfigureerd.

Schermopname van Azure Portal configuratie van versiebeheerbeleid met configuratie op systeemniveau versus resourceniveau.

Wanneer u de configuratie op resourceniveau configureert, kunt u het FHIR-resourcetype (geannoteerd als 1) en het specifieke versiebeleid voor deze specifieke resource (geannoteerd als 2) selecteren. Zorg ervoor dat u de knop Toevoegen (met aantekeningen 3) selecteert om deze instelling in de wachtrij te plaatsen voor opslaan.

Schermopname van Azure Portal configuratie van versiebeheerbeleid met configuratie op resourceniveau.

Zorg ervoor dat u Opslaan selecteert nadat u de configuratie van het versiebeleid hebt voltooid.

Schermopname van de configuratieconfiguratie van Azure Portal versiebeheerbeleid met de knop Opslaan.

Geschiedenisbeheer

De geschiedenis in FHIR is belangrijk voor eindgebruikers om te zien hoe een resource in de loop van de tijd is gewijzigd. Het is ook handig bij de coördinatie met auditlogboeken om de status van een resource te bekijken voor en nadat een gebruiker deze heeft gewijzigd. Over het algemeen is het raadzaam om de geschiedenis van een resource te bewaren, tenzij u weet dat de geschiedenis niet nodig is. Regelmatige updates van resources kunnen leiden tot een grote hoeveelheid gegevensopslag, wat ongewenst kan zijn in FHIR-services met een grote hoeveelheid gegevens.

Als u het versiebeleid wijzigt op systeem- of resourceniveau, wordt de bestaande geschiedenis voor resources in uw FHIR-service niet verwijderd. Als u de grootte van geschiedenisgegevens in uw FHIR-service wilt verkleinen, moet u de bewerking $purge-history gebruiken.

Volgende stappen

In dit artikel hebt u geleerd hoe u de geschiedenis van resources in de FHIR-service kunt opschonen. Zie voor meer informatie over het uitschakelen van geschiedenis en enkele concepten over geschiedenisbeheer

Bewerking geschiedenis opschonen

FHIR® is een gedeponeerd handelsmerk van HL7 en wordt gebruikt met toestemming van HL7.