Versionshanteringsprocess i SSBTEK

Regler kring uppdateringar av SSBTEK

Så här uppdateras SSBTEK eller bastjänst till nya versioner

Nya större uppdateringar (major version)

• ny bastjänst
• borttag av bastjänst
• icke-kompatibel teknisk förändring av en eller flera befintliga bastjänster och/eller SSBTEK
• verksamhetsmässig förändring av bastjänst
  • nya eller förändrade koder i kodverk
    

Tekniska förändringar vid större uppdateringar

• tillägg av nytt obligatoriskt element
• borttag av element
• förändring av kardinalitet
• förändring av datatyp
• förändring av icke-obligatoriskt element till obligatoriskt
• förändring av namn på ett element
• förändring av restriktion på ett element (t.ex. ändra längd på en sträng)
• tillägg/borttag/förändring av schemavalideringsregler

Nya mindre uppdateringar (minor version)

• teknisk förändring som är kompatibel
  • tillägg av nytt icke-obligatoriskt element
• teknisk förändring av bastjänst och/eller SSBTEK som inte är verksamhetskritisk, dvs handläggarens bedömning av ekonomiskt bistånd blir inte lidande om informationen inte visas upp. T.ex. tillägg av kontaktinformation. En bedömning av vad som är en uppdatering av “minor”-karaktär behöver göras av SKR tillsammans med expertråd.

Förändringar vid både större och mindre uppdateringar

• förändring av obligatoriskt element till ej obligatorisk. Dialog med driftsråd för leverantörer av verksamhetssystem krävs.
  • Major: om något verksamhetssystem har byggt in logik som är beroende av informationen
  • Minor: om inget verksamhetssystem har byggt in logik som är beroende av informationen

Ny uppdatering för att hantera buggar (patchversion)

• en buggfix av major- eller minorversion som leder till ny patchversion av SSBTEK eller bastjänst. Detta kan t.ex. vara buggfixar som görs på releasekandidaten som ligger i den publika testmiljön.

Så här uppdateras dokumentationen kopplat till nya versioner av SSBTEK

Ny dokumentuppdateringsversion (enbart för Sammanhållen informatik):

• Vid förändrade beskrivningar av information och rättelser av t ex stavfel.
• Verksamhetsmässig förändring som ej kräver uppdatering av teknisk version.
• Betydelsen av någon information som levereras förändras. Kan påverka hur verksamhetssystemen presenterar informationen, eventuella hjälptexter kan t ex. påverkas.

När det blir en patchversion på bastjänst eller på SSBTEK så blir det en bedömning om Sammanhållen informatik behöver uppdateras med en ny version.

Versionshantering i olika miljöer

Releaseplanen visar när nya versioner är planerade att driftsättas i respektive målmiljö, vilket möjliggör för anslutna parter att anpassa sin egna planering därefter.

Genom att visa vilken typ av version en release får ger det en indikation på vad som är förändrat och vad det innebär för de som nyttjar SSBTEK eller förändrad bastjänst.

När en ny version driftsätts så stängs näst senaste version av SSBTEK. Releaseplanen visar också när end-of-life gäller för respektive version av SSBTEK.

I de fall där det finns behov att förlänga tiden för tillgängligheten på en specifik version av SSBTEK, så tar man upp detta i driftsrådet.

Exempel på versionsbenämningar vid uppdateringar

1. Förändring på teknisk nivå på en bastjänst, som är kompatibel med befintlig version

Detta räknas som en ny minorversion. Uppdateringen får följande versionsbenämningar:

• Bastjänsten uppdateras från 1.0.0 till 1.1.0
• SSBTEK uppdateras från 8.0.0 till 8.1.0
• Dokumentationen (sammanhållen informatik) uppdateras från 8.0.0.0 till 8.1.0.0.

2. Förändring av SSBTEK som inte är kompatibel med befintlig version, ingen uppdatering av bastjänst

Detta räknas som en ny majorversion. Det är ingen uppdatering av bastjänster. Uppdateringen får följande versionsbenämningar:

• Bastjänsten har samma version: 1.0.0
• SSBTEK uppdateras från 8.0.0 till 9.0.0
• Dokumentationen (sammanhållen informatik) uppdateras från 9.0.0.0 till 9.0.0.0.

3. Förändring av datatyp i svaret på en bastjänst

Förändringa av datatyp räknas som en ny majorversion av bastjänsten. Vilket leder till att även SSBTEK får en ny majorversion. Uppdateringen får följande versionsbenämningar:

• Bastjänsten uppdateras från 1.0.0 till 2.0.0
• SSBTEK uppdateras från 8.0.0 till 9.0.0
• Dokumentationen (sammanhållen informatik) uppdateras från 8.0.0.0 till 9.0.0.0.

4. Förändrad information i dokumentationen (sammanhållen informatik)

Varken SSBTEK eller bastjänsterna har förändrats tekniskt. Däremot har det tillkommit nya beskrivningar av informationen som förändrar sammanhållen informatik. Nya versionerna:

• Bastjänsten har samma version: 1.0.0
• SSBTEK har samma version: 8.0.0
• Dokumentationen (sammanhållen informatik) uppdateras från 8.0.0.0 till 8.0.0.1.
  

5. Buggfix i SSBTEK

SSBTEK har fått en ny patchversion. Bastjänsterna har inte uppdaterats. Den nya patchversionen behöver även finnas med i dokumentationen. Nya versioner:

• Bastjänsten har samma version: 1.0.0
• SSBTEK uppdateras från 8.0.0 till 8.0.1
• Dokumentationen (sammanhållen informatik) uppdateras från 8.0.0.0 till 8.0.1.0.