Working with the Versioning Assistant

To solve version and dependency issues, you can use the Versioning Assistant.

There are two kinds of versioning issues:

  • The dependencies are not correct, that is, the version of opened libraries used by other opened libraries are not the version specified to be used.
  • The opened libraries are not of the recommended version.

Important: For behaviors created in Functional & Logical Design, you can open in Dymola Behavior Modeling only one functional or logical behavior at a time. If the Functional & Logical Design model uses multiple versions of Modelica libraries, you must open each behavior separately to solve all versioning problems.
Tips:
  • To display the dependency of a library, from the Behavior Authoring section of the action bar, click Modelica Versions and Dependencies . For more information, see Managing Modelica Versions and Dependencies for Libraries and Behaviors.
  • To display information about a versioning issue in a tooltip, pause, in the Package Browser, over the library name that has a warning icon.

Before you begin: To create a dependency problem that you can solve using the Versioning Assistant, do the following:
  1. Create two Modelica libraries:
    1. A library UsedLib with the Modelica version 1.0.0, containing a model UsedModel.
    2. A library MyTestLib with the Modelica version 1.0.0, containing a model Unnamed.
    For more information about how to create libraries, see Create a Modelica Library. For information about how to change model names, see Editing Class Attributes.
  2. To make MyTestLib depend on UsedLib:
    1. Open the model Unnamed in MyTestLib.
    2. From UsedLib, drag UsedModel into Unnamed.
    For more information about instantiation, see Instantiate from Any Package Browser.
  3. To create a dependency problem:
    1. Open the library UsedLib.
    2. From the Behavior Authoring section of the action bar, click New Library PLM Revision and specify the new Modelica version to 2.0.0.
      Note: The version 1.0.0 is saved during the operation.
      For more information, see Creating a New Library PLM Revision with a New Modelica Version.
    The result is:
    • The new revision of the library UsedLib with the Modelica version 2.0.0 replaces the former revision with Modelica version 1.0.0 in session.
    • A dependency issue appear for the library MyTestLib since it uses UsedLib of version 1.0.0, which is not loaded in session anymore. This issue is indicated in the Package Browser:

  1. In the upper part of the Package Browser, click Versioning Assistant .
    The Versioning Assistant displays information about all versioning issues in this session.
    Tip: By default, the Versioning Assistant appears when you import a library with versioning issues. To change this behavior, in the Versioning Assistant header, click Show Preferences , and then clear Automatic launch of the panel.
  2. To manage dependency issues, in the library row, click one of these commands:
    CommandDescription
    Load the right dependencies in session Loads the libraries according to the stated dependency. In this example, the UsedLib version 1.0.0 is reloaded in session.
    Modify dependencies to match library in session Updates the dependency to fit the libraries in session.
    Tip: To update the dependency with a new revision, activate the Create new version option before launching this command.

    This creates a revision of the referenced library, with a new Modelica version. This new revision is loaded in session, and its dependency statement is updated.

    Note: If a conversion script is available, it is used.
    In this example, the dependency statement in MyTestLib is updated to UsedLib version 2.0.0 to fit the UsedLib loaded in session. If Create new version is activated, a new revision of MyTestLib is created with this update.
  3. To manage recommended version issues, in the library row, click one of these commands:
    CommandDescription
    Load recommended version of this library Loads the recommended version of the library.
    Load all recommended versions Loads the recommended version for all libraries in session that are not of the recommended version.
    In the Versioning Assistant, the status for this library is updated with an icon and a comment: No Library Issue.