System- och gränssnittsversionhantering

NEMO upprätthåller en förteckning över versioner som stöds. NEMO stöder alltid den aktuella produktionsversionen (latest stable) samt de två (2) föregående versionerna.

Stödet för äldre versioner upphör efter en övergångsperiod som definieras i EMSA:s policy för versionshantering. NEMO kan visa tidigare inskickade uppgifter även om den aktuella versionen inte längre stöds.

Säkerställande av kompatibilitet

• NEMO innehåller schema- och logikvalideringar som säkerställer överensstämmelse med MIG.
• Stöd för flera versioner baseras på versionsidentifiering på metadatanivå (t.ex. versionsnummer i ett meddelande eller i ett API-anrop).
• Det är möjligt att granska historiska uppgifter även från äldre versioner, men endast den senaste versionen garanterar full funktionalitet.

Versionsuppdateringar och ändringsmeddelanden

När Finland får information om en kommande uppdatering av en MIG-version publicerar Fintraffic ett informationsmeddelande om detta. Meddelandet beskriver att en ny MIG-version är på väg samt en preliminär uppskattning av tidpunkten för publicering.

Den faktiska implementeringen av den nya MIG-versionen sker stegvis och kommuniceras separat via följande kanaler:

1. Fintraffics utvecklarportalApar i en ny flik 
2. E-post till organisationens kontaktpersoner

Organisationens kontaktpersons e-postadress hanteras i vyn Organisationsadministration.

Versionsinformation, inklusive beskrivning av den nya versionen, meddelandestruktur och gränssnittsbeskrivning, publiceras i Fintraffics GitHub-repositorium (JSON Schema, OpenAPI och MIG-strukturer). För varje version publiceras en ändringslogg (changelog) som beskriver de viktigaste ändringarna jämfört med föregående version.

Syftet med informationsspridningen är att säkerställa att alla tredje parter får tillräckligt med tid att förbereda sig för versionsuppdateringar och testa sina implementationer innan övergången till produktion.

Åtgärder vid versionsuppdatering

Vid en versionsuppdatering ska du eller organisationens tekniska kontaktperson beakta följande:

• Kompatibilitetstestning – säkerställ att ditt system stöder den nya MIG-versionen och producerar giltiga data enligt gränssnittsspecifikationerna.
• Gränssnittsändringar – granska publicerade scheman och eventuella ändringar i obligatoriska fält eller datastrukturer.
• Driftavbrott – beakta eventuella produktionsavbrott eller schemalagda underhållsfönster i samband med versionsuppdateringar.
• Versionshantering – dokumentera vilken version som används i er utvecklingsprocess och följ de övergångsperioder som Fintraffic meddelar.
• Acceptanstestning – testa hela meddelandeflödet (sändning, kvittens och eventuella felmeddelanden) i stagingmiljön.