While a project may be used in the main project, it may be modified and saved to a new version, rendering its version used in the main project outdated. Therefore, in the main project, the used project is indicated with its version number, e.g., #1. You can choose to update the used project to a later version or continue using the older one. You can see the details about the used version in the Containment tree, the Project Usages dialog, and the Advanced Project Usages Configuration dialog. The Edit Branches dialog displays all existing versions of the used project.

  • Refreshing version information display. To ensure the used project version information displayed in the Containment tree and the rest of the tool is up to date, press F5 or click View > Refresh in the main menu.
  • Updating directly used projects. Updating directly used projects does not update indirectly used projects if they are outdated in the projects that use them. In this case, indirectly used projects must be updated individually. However, if the indirectly used project is already updated in the directly used one, then the indirectly used project's version is updated in the main project once you update the directly used project's version.


Updating all used projects to their latest versions

To update all used projects to their latest versions

  1. Open the Project Usages dialog. 
  2. In the Project Usages dialog's toolbar, click the Update Used Projects button. The Update Used Projects dialog opens.
  3. In the Update Used Projects dialog, select the check box in the Update column for the used projects you want to update and click OK.
  4. Click the OK button to close the Project Usages dialog.
    The used projects are updated to their latest versions. 

Changing a used project version via the Containment tree

To change a used project version via the Containment tree

  1. In the Containment tree, expand the Used Projects node, then right-click a used project. In the shortcut menu, click Change Version. The Edit Branches dialog opens.
  2. In the Edit Branches dialog, select the version you want to use, and click OK. 
    The used project version is changed. 

Changing a used project version via the Project Usages dialog

To change a used project version via the Project Usages dialog

  1. Managing local used projects and do one of the following:
    1. In the dialog's toolbar, click the Change Version button.
    2. In the dialog's project usages tree, right-click a used project and in the shortcut menu, click the Change Version command.
      The       Edit Branches dialog opens.
  2. In the Edit Branches dialog, select the version you want to use, and click OK. 
  3. Click the OK button to close the Project Usages dialog.
    The used project version is changed. 

Changing a used project version via the Advanced Project Usages Configuration dialog

To change a used project version via the Advanced Project Usages Configuration dialog

  1. Open the Advanced Project Usages Configuration dialog.
  2. In the Advanced Project Usages Configuration dialog, do one of the following:
    1. Select a used project and in the dialog's toolbar, click the Change Version button.
    2. Right-click a used project, then in its shortcut menu, select the Change Version command.
      The Edit Branches dialog opens.
  3. In the Edit Branches dialog, select the version you want to use, and click OK. 
    The cell in the Action column for the removed used project states 'Switch to <version number> in <project name>'.  
  4. (Optional) To undo the action, do one of the following:
    1. In the dialog's toolbar, click the Reset Changes for Selection button.
    2. Right-click the used project and in the shortcut menu, click the Reset Changes for Selection command.
  5. Do one of the following:
    1. To save changes and keep the dialog open, click the Apply button.
    2. To save changes and close the dialog, click the OK button.
    3. To discard changes and close the dialog, click the Cancel button.
  6. Click the OK button to close the Project Usages dialog.
    The used project version is updated. 

2026x HotFix1 version

This documentation page is for the 2026x HotFix1 version of the SysML v2 Plugin. If you are working with the 2026x version, expand the section above. However, we highly advise upgrading to the 2026x HotFix1 version.

While a project may be used in the main project, it may be modified and saved to a new version, rendering its version used in the main project outdated. Therefore, in the main project, the used project may refer to two of its available versions: Older Version or Latest Version. You can choose to update the used project to its latest version or continue using the older one. You can see more details about the used version in the Containment tree, the Project Usages dialog, and the Advanced Project Usages Configuration dialog.

  • Refreshing version information display. To ensure the used project version information displayed in the Containment tree and the rest of the tool is up to date, press F5 or click View > Refresh in the main menu.
  • Reverting used project version update. Once you update a used project to its latest version and save the project, reverting to an older version is not possible. However, if you do not save the main project after the update, you can close the main project without saving it to discard all changes, including the used project's version update. Thus, make sure the update is necessary to avoid potential model inconsistencies.
  • Updating directly used projects. Updating directly used projects does not update indirectly used projects if they are outdated in the projects that use them. In this case, indirectly used projects must be updated individually. However, if the indirectly used project is already updated in the directly used one, then the indirectly used project's version is updated in the main project once you update the directly used project's version.

Updating all used projects to their latest versions

To update all used projects to their latest versions

  1. Open the Project Usages dialog. 
  2. In the Project Usages dialog's toolbar, click the Update Used Projects button. The Update Used Projects dialog opens.
  3. In the Update Used Projects dialog, select the check box in the Update column for the used projects you want to update and click OK.
  4. Click the OK button to close the Project Usages dialog.
    The used projects are updated to their latest versions. 

Updating a used project to its latest version via the Containment tree

To update a used project to its latest version via the Containment tree

  • In the Containment tree, expand the Used Projects node, then right-click a used project. In the shortcut menu, click Switch to Latest Version.
    The used project is updated to its latest version. 

Updating a used project to its latest version via the Project Usages dialog

To update a used project to its latest version via the Project Usages dialog

  1. Open the Project Usages dialog and do one of the following:
    1. In the dialog's toolbar, click the Change Version button, and in its dropdown menu, click Switch to Latest Version.
    2. In the dialog's project usages tree, right-click a used project and in the shortcut menu, click the Change Version > Switch to Latest Version command.
  2. Click the OK button to close the Project Usages dialog.
    The used project is updated to its latest version. 

Updating a used project to its latest version via the Advanced Project Usages Configuration dialog

To update a used project to its latest version via the Advanced Project Usages Configuration dialog

  1. Open the Advanced Project Usages Configuration dialog.
  2. In the Advanced Project Usages Configuration dialog, do one of the following:
    1. Select a used project and in the dialog's toolbar, click the Change Version button, then in its dropdown menu, click Switch to Latest Version.
    2. Right-click a used project, then in its shortcut menu, select the Change Version > Switch to Latest Version command.
      The cell in the Action column for the removed used project states 'Switch to <version number>'.  
  3. (Optional) To undo the action, do one of the following:
    1. In the dialog's toolbar, click the Reset Changes for Selection button.
    2. Right-click the used project and in the shortcut menu, click the Reset Changes for Selection command.
  4. Do one of the following:
    1. To save changes and keep the dialog open, click the Apply button.
    2. To save changes and close the dialog, click the OK button.
    3. To discard changes and close the dialog, click the Cancel button.
  5. Click the OK button to close the Project Usages dialog.
    The used project version is updated.