Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Content layer
id1391683922
Content column
id1391683925
Content block
id1391683924

The cross-version compatibility checking mechanism is triggered when a project with new feature usages is loaded with an older version of the modeling tool. The mechanism tracks feature usages of 19.0 SP1, 19.0 SP2, 19.0 SP3, and later service pack (SP) versions that result in the appearance of a Missing features detected notification in earlier modeling tool versions. The following table shows tracked features, the version they appear in, and whether the project can be committed/saved without any consequences. 


Excerpt

Anchor
Forward Compatibility
Forward Compatibility


If you are working with features that can cause inconsistencies after save/commit (see the table above), the following warning message indicating possible consequences if you proceed will be shown.

Image Added







Diagramming features

Forward compatibility tracks the following diagramming features introduced in 19.0 SP1:

When opening a project with a tool version 19.0, the usage of these features makes the diagram read-only. Additionally, you will be warned of possible consequences if you edit the diagram:

Image Added

This mechanism prevents unexpected changes after opening a project with a version 19.0 SP1.


Compatibility of profiles

While the tool is backward compatible, we highly recommend for every user working on a particular project to use the same version of the tool. For example, if you use an older version of the tool and open a project created with a later version, a balloon notification pops up:


Image Added


To avoid this:

  • Make sure that every user working on the same project uses the same version of the tool.
  • Do not migrate profiles unless every user working on the same project is informed and ready for migration.

Status
colourGreen
titleAvailable from 19.0 SP1

As from modeling tool version 19.0 with service pack releases we introduce new features, the forward compatibility are required for tool compatibility with a later version of itself in the future. The forward compatibility allows to ensure that project data would not be lost when opened with a different tool version. 

Note

If a user wants to edit diagram, we highly recommend to do it with a version in which feature is supported. Otherwise, the possible data loss when opened with a newer tool version.

Forward compatibility allows to maintain the same diagram view after saving a project with previous modeling tool versions. This implies that user can work on the same project with different versions only if a modeling tool unsupported features are used. For this, the diagrams are made read-only after opening with the previous version of modeling tool if a view is not supported. This mechanism is used for the following features:

  • Complete diagrams (for suspended symbols):

    After opening the project, which is saved in 19.0 SP1 or newer, using 19.0 version of modeling tool, the diagram shall be made read-only if at least one of the following statements are true:

    • If at least one symbol shown on diagram has Suspend Auto Resizing of Shape symbol property value set to true;
    • If at least one symbol shown on diagram has Suspend Auto Displaying of Label symbol property value set to true;
    • If diagram symbol properties Suspend Auto Resizing of Shapes or Suspend Auto Displaying of Labels value is set to true.
  • Diagrams where vertical labels are used: If a user wants to edit this diagram, we highly recommend to do it with a version in which feature is supported. Otherwise, the possible data loss when opened with a newer tool version.

    To handle cases when a project with new feature usage is loaded with older version of the modeling tool the cross-version compatibility was implemented. Before project commit/save, the message can be shown about possible data loss or project inconsistency when opened with a newer tool version. These question messages were added in the 19.0 SP1. So, the user will see these messages only by using a later version than the 19.0 SP1.

    This cross-version compatibility is implemented for the following features:

    Image Removed