Dela via

Hantering av versionsprinciper och historik

  • Artikel

Versionsprincipen i Azure Health Data Services FHIR-tjänsten är en konfiguration som avgör hur historiken lagras för varje resurstyp med alternativet för resursspecifik konfiguration. Den här principen är direkt relaterad till begreppet hantering av historik för FHIR-resurser.

Historik i FHIR

Historik i FHIR ger dig möjlighet att se alla tidigare versioner av en resurs. Historik i FHIR kan efterfrågas på resursnivå, typnivå eller systemnivå. HL7 FHIR-dokumentationen innehåller mer information om historikinteraktionen. Historik är användbart i scenarier där du vill se utvecklingen av en resurs i FHIR eller om du vill se information om en resurs vid en viss tidpunkt.

Alla tidigare versioner av en resurs anses vara föråldrade och den aktuella versionen av en resurs bör användas för normala åtgärder för affärsarbetsflöden. Det kan dock vara användbart att se tillståndet för en resurs som en tidpunkt när ett tidigare beslut fattades.

Versionspolicy

Med versionsprincipen i FHIR-tjänsten kan du bestämma hur historiken lagras antingen på FHIR-tjänstnivå eller på en specifik resursnivå.

Det finns tre olika nivåer för versionshanteringsprincipen:

  • versioned: Historiken lagras för åtgärder på resurser. Resursversionen ökas. Det här är standardinställningen.
  • version-update: Historiken lagras för åtgärder på resurser. Resursversionen ökas. Uppdateringar kräver ett giltigt If-Match sidhuvud. Mer information finns i VersionedUpdateExample.http.
  • no-version: Historiken skapas inte för resurser. Resursversionen ökas.

Versionshanteringsprincip som är tillgänglig för konfiguration på som en systemomfattande inställning och även för åsidosättning på resursnivå. Den systemomfattande inställningen används för alla resurser i FHIR-tjänsten, såvida inte en specifik princip för versionshantering på resursnivå har lagts till.

Jämförelse av versionsprinciper

Principvärde Beteende för historik meta.versionId Uppdateringsbeteende Standardvärde
versioned Historiken lagras If-Match krävs inte Yes
version-update Historiken lagras If-Match krävs No
no-version Historiken lagras inte If-Match krävs inte No

Anteckning

Att ändra versionsprincipen till no-version har ingen effekt på den befintliga resurshistoriken. Om historiken behöver tas bort för resurser använder du åtgärden $purge historik .

Konfigurera versionshanteringsprincip

Om du vill konfigurera versionshanteringsprincip väljer du bladet Konfiguration av versionsprincip i FHIR-tjänsten.

Skärmbild av konfigurationen av Azure Portal versionshanteringsprincip.

När du har bläddrat till Konfiguration av versionsprinciper kan du konfigurera inställningen på både systemnivå och resursnivå (som en åsidosättning av systemnivån). Konfigurationen på systemnivå (kommenterad som 1) gäller för varje resurs i FHIR-tjänsten om inte en resursspecifik åsidosättning (kommenterad vid 2) har konfigurerats.

Skärmbild av Azure Portal konfiguration av versionshanteringsprinciper som visar konfiguration på systemnivå jämfört med resursnivå.

När du konfigurerar konfiguration på resursnivå kan du välja FHIR-resurstypen (kommenterad som 1) och den specifika versionsprincipen för den här specifika resursen (kommenterad som 2). Se till att välja knappen Lägg till (kommenterat som 3) för att köa den här inställningen för att spara.

Skärmbild av Azure Portal konfiguration av versionshanteringsprinciper som visar konfiguration på resursnivå.

Se till att välja Spara när du har slutfört konfigurationen av versionsprincipen.

Skärmbild av konfigurationskonfigurationen för Azure Portal versionshanteringsprincip med knappen Spara.

Hantering av historik

Historik i FHIR är viktigt för slutanvändare för att se hur en resurs har ändrats över tid. Det är också användbart i samordning med granskningsloggar för att se tillståndet för en resurs före och efter att en användare har ändrat den. I allmänhet rekommenderar vi att du behåller historiken för en resurs om du inte vet att historiken inte behövs. Frekventa uppdateringar av resurser kan resultera i en stor mängd datalagring, vilket kan vara oönskade i FHIR-tjänster med en stor mängd data.

Om du ändrar versionsprincipen på system- eller resursnivå kommer inte den befintliga historiken för några resurser i FHIR-tjänsten att raderas. Om du vill minska historikens datastorlek i FHIR-tjänsten måste du använda åtgärden $purge historik .

Nästa steg

I den här artikeln har du lärt dig hur du rensar historiken för resurser i FHIR-tjänsten. Mer information om hur du inaktiverar historik och vissa begrepp om historikhantering finns i

Åtgärd för rensningshistorik

FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.