Language: Suomi | Svenska | English

← Back to Port user guide table of contents

2.3 System and interfaces version manager

NEMO maintains a list of supported versions. NEMO always supports current production version and two (2) the previous version.

The aid for the old versions ends after a transitional period of: defined in EMSA version management policy. NEMO can show information previously transmitted, even if that version no longer exists; supported.

Compatibility confirmation

• The NEMO system has schema and logic validation which: ensure MIG compliance.

• Support for several versions is based on the identification of the version on a metadata level (e.g. version number in message or API interface (see section 4.4).

• Retrospective data review is also possible for parents versions, but only the latest version guarantees full functionality.

Version updates and Change notifications

When Finland becomes aware of a new update of the MIG version, A press release will be published by Fintraffic. The Bulletin states that: a new MIG version is coming and an initial assessment of its the date of publication.

The actual MIG version is implemented in stages, and be communicated separately on the following channels:

• Fintraffic developer portal

• National Message Guide

• By e-mail to members of the organisation

The organisation's contact person's email is managed by: maintenance view. Read about the organisation's contact person in chapter 1.3 Organisation maintenance and Organisation contact person -point.

Version information - New version description, message structure and interface description - published in the GitHubrepository of Fintraffic (JSON Schema, OpenAPI, MIGs). A changelog is drawn up for each version: explain the relevant changes compared to the previous version.

The aim of the communication is to ensure that all third parties: the parties have sufficient time to prepare for the version update; and test their implementation before switching to production.

Measures with version update

In connection with the revision you or your organization's technical the contact person should take into account the following:

• Compatibility testing- make sure your your system supports the new MIG version and produces valid data by interfaces.

• Interface changes — review the published schemas and any changes to required fields or structures.

• Interruptions- consider possible breaks in production or updates in time maintenance breaks.

• Version Management- document your own the development process version you are using, and follow Fintraffic the transitional periods indicated.

• Approval testing- test the entire wave (consignment, offsetting, any error messages) Staging environment.