Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Content layer
id753686899


Client-side Performance Improvements
Content column
width100.00002%
id753686902


Content block
id753686898

Anchor
top
top


Magic Systems of Systems Architect

Released on: June 4, 2021


The 2021x Refresh1 release introduces further performance and scalability upgrades in key product areas: compatibility modes, report generation, metrics calculation, integration, general modeling, and collaboration improvements. Furthermore, new tables and usability improvements are here to make your modeling experience better. Additionally, this version introduces a technology preview of ArchiMate model import.

This release also comes with Behavior to Structure synchronization, Contextual Relationships enhancements, and other improvements. 

Collaborative modeling has been extended to assess the impact of element modification or deletion in other projects an element is used in, enable users to conveniently organize projects into the nested categories, customize the representation of Magic Collaboration Studio users in the modeling tool, and quickly return to the Merge dialog to change the merge decisions.


To download the latest version, see Downloading installation files. Don't forget to give us your feedback on LinkedInTwitter, or Facebook. For further information, check the product documentation.

Note
title2021x Refresh1 Hot Fix 2 available

Due to the Apache Log4j vulnerability issues, the 2021x Refresh1 HF2 has been released on March 4, 2022. The HF2 addresses Log4j 1.x and 2.x versions.

For more information, see CATIA Magic and No Magic products affected by Log4j vulnerability - CVE-2021-44228, CVE-2021-45046, CVE-2021-44832.

Also, see the Knowledge Base article at https://kb.dsxclient.3ds.com/mashup-ui/page/resultqai?id=QA00000102301e.

Note
title2021x Refresh1 Hot Fix 1 available

Due to the Apache Log4j vulnerability issues, the 2021x Refresh1 HF1 has been released on December 22, 2021. The HF1 addresses Log4j 2.x versions.

For more information, see CATIA Magic and No Magic products affected by Log4j vulnerability - CVE-2021-44228, CVE-2021-45046, CVE-2021-44832.

Also, see the Knowledge Base article at https://kb.dsxclient.3ds.com/mashup-ui/page/resultqai?id=QA00000102301e.

Warning
titleHot Fix version compatibility

The version and Hot Fix number of a modeling tool and its plugins must be the same. After installing the Hot Fix version of a modeling tool, select the same Hot Fix version when downloading its plugins. The modeling tool will not work correctly if you install plugins of a different version and/or Hot Fix number. 


Content block
id243271308
Content block
id243271308


Content block
id753686901
Anchor
ms
ms
Performance Improvements in UAF

Back to Top

Content block
id244508097
SysML Features

Back to top

Content block
id272319258
Content block
id884215702
TWC-related Performance Improvements

Back to top

Content block
id884222643
System Requirements

Back to Top

Content block
id243174490
Modeling and Infrastructure

In this version, we continued improving the performance with a major focus on compliance mode, reports, and UAF metrics.

Compliance Modes

Turning on the BPMN or SysML compliance modes in large projects now takes less time than in earlier versions. 

Feature

2021x

2021x Refresh 1

BPMN Compliance Mode (UAF)> 60 min9 min 27s
SysML Compliance Mode (UPDM)> 60 min3 min


Image Added

Report

The report generation was optimized so it takes less time for large projects. In the optimization process, the tables, matrices, and relation maps were excluded from the scope of the Used in Diagrams column. MS Word supports files only up to 512 MB, therefore we do not recommend generating a report with the entire project as its scope.

The following table shows the testing, performed with the scope of ~ 5000 elements, results.

Feature

2021x Refresh 1

All views report (XL project)5 min 30s
Dictionary report31s
Summary and  Overview report15s 
Dictionary Excel Spreadsheet 2 min 11s

UAF Metrics

The metrics calculation was also optimized and runs smoothly in the larger projects. However, we do not recommend selecting the entire project as a scope for calculating metrics.

The following table shows the testing, performed with the scope of ~ 5000 elements, results.

Feature

2021x

2021x Refresh 1

UAF metrics (1M)Low memory21.719 s
UAF metrics (10M)Low memory190.35 s
UPDM2 metrics (1M)Low memory42.564 s
UPDM2 metrics (10M)Low memory56.109 s

Diagrams and Tables
  • The Hierarchical Typical Measurements tables were enhanced and no longer hold the status of technology preview. New hierarchical display modes were implemented. You can also generate predefined reports for these tables. Also, having the Hierarchical Typical Measurements table filled out makes it easy to create the Hierarchical Actual Measurements table by simply clicking the Evaluate Measurements button.  Learn more >>
  • The Hierarchical Actual Measurements tables are available for all domains. The hierarchical table for actual measurements allows working with the actual measurements directly in the table. You can add new or existing Actual Property Sets and define values. When you add a Property Set to the table, all existing Actual Property Sets will be collected recursively according to the defined scope. Learn more >>
  • The Actual Project Milestone Summary Table (Pj-Rm) depicts all actual project milestones in the model. Adding the actual project milestones into the table allows you to see their name, kind, start date, project, project status, version released, version withdrawn, and actual resource information. You will also be able to add or modify the actual project milestone information directly in this table. Learn more >>
  • The new Strategic Typical Deployment tables are now available in all frameworks. Two new wizards come along with this new type of table. Use the  Actual Resources Deployment Creation Wizard to create a table and the Typical Resources Deployment Wizard to add resources to the table. Learn more >>
    Image Added
Usability Improvements
  • If you need to see the original name, set the Show Original Name of Measurement symbol property to true. The original name will be displayed in brackets and in gray font. Learn more >>

Image Added

  • You can create a Model Library package for each UAF domain.
  • A new system property is implemented to help with the migration of server projects. There are two cases regarding the migration of UAF and UPDM projects:

    • If you are performing UPDM project migration from the modeling tool with the UPDM environment, only the project version will be migrated.
    • The UPDM project migration from the modeling tool with the UAF environment will not be performed. However, if you want to migrate the UPDM project to UAF, you need to open the magicdraw.properties (or cea.properties) file and change the value of the system property -Dmigrate.project.from.updm2.to.uaf\=false to True. By default, the value of this property is False, which means that your UPDM projects will not be migrated.
      Learn more >>
ArchiMate Model Import (Technology Preview)

In this version, the import of the ArchiMate model from the open exchange file into the UAF project is implemented. As it is only a technology preview for this version, the imported element mapping is only partial. The mapping of ArchiMate 3.1 to UAF 1.1 approach is based on the NATO Architecture Framework.

Image Added

Learn more >>>

Content block
id252677720
Discontinued Products
  • The development of the following plugins is discontinued:

    • Document Modeling Plugin (Model-based reports). For more effective model publishing and reviewing on the web, use Cameo Collaborator.
      • To create Views and Viewpoints diagrams using the modeling tool with no plugins installed, use the Cameo Collaborator Publisher plugin or  the SysML plugin instead. 
      • The DockBook Library Profile is no longer available. 
    • Methodology Wizard Plugin.
    • QVT Plugin.
    • Excel Import Plugin. We highly recommend using Excel/CSV Sync or Excel/CSV Import features instead.
    • CSV Import Plugin. We highly recommend using Excel/CSV Sync or Excel/CSV Import features instead.
    • LieberLieber Embedded Engineer plugin.
    • Project Element Counter plugin.
    • MBSE plugin.
  • Web portal reports are no longer available. For more effective model publishing and reviewing on the web, use Cameo Collaborator. You can also use Web Publisher (Simple HTML) or Web Publisher 2.0 ReportWizard templates to generate HTML reports.
  • WSDL Code Engineering and WSDL diagrams are no longer available.
  • C# Code Engineering and C# Professional Edition are no longer available.
  • CIL and CIL Disassembler Code Engineering are no longer available.
  • The News Reader (RSS) is no longer available. The notification at the right bottom corner of the modeling tool will inform you about the new version release instead.

  • The no_install_mac.zip and 32-bit installation files are no longer offered for download.
  • The Project Usage Map Profile is no longer available. 
  • The JavaScript Nashorn is deprecated with the intention of removing it. We highly recommend using JavaScript Rhino instead.  
  • The following 3rd party plugins are discontinued:
    • Cameo Workbench
    • Cameo Inter-Op
    • ParaMagic Lite
  • The following no cost plugins are no longer available in modeling tools:

From Teamwork Server to Teamwork Cloud

Teamwork Server is no longer supported in the latest release. Teamwork Cloud should be used as a product for collaborative modeling and model version control. Customers still using Teamwork Server must migrate their server projects to TWC 19.0 series first and then upgrade to TWC 2021x.

Learn how to migrate from Teamwork Server to Teamwork Cloud >>

From Cameo Collaborator for Alfresco to Cameo Collaborator for Teamwork Cloud

From version 2021x, Cameo Collaborator for Alfresco is no longer supported. We recommend using Cameo Collaborator for Teamwork Cloud instead.

Learn the benefits of Cameo Collaborator for Teamwork Cloud compared to Cameo Collaborator for Alfresco >>

Learn how to migrate your documents and comments from the Alfresco server to Teamwork Cloud >>

Back to Top


Content block
id243713866244508097
SysML Features

Behavior to Structure Synchronization

Collaboration
Detecting Changes in Diagrams During Merge

You can now specify in the Environment Options dialog whether to compare only the direct or all the changes in diagrams during the Project Merge and Project Comparison operations. By default, only the changes made by the user in loaded (open) diagrams are analyzed, leaving out unintentional diagram changes that occurred due to indirect changes in the model. This feature not only eases both merge and project comparison processes for the user, since the number of diagrams with changes is considerably reduced but also optimizes modeling tool performance. 

Image Removed

An Environment option to specify the changes to detect in diagrams.

Learn more about diagram changes in model merge and project comparison >>

Further Merge Usability Improvements

The model merge has undergone further usability improvements. From now on, changes from the Target and Equivalent Changes are automatically hidden by default; only the Source changes are shown. As a result, fewer changes need to be reviewed by the user.

Additionally, the model merge has been extended by adding a capability to select which ancestor calculation algorithm to use. You now have the freedom to choose a Branch Point as an ancestor for your merges. This is especially useful when merge results become too complex to understand and analyze due to previously rejected changes. By default, the Lowest Common Parent ancestor calculation algorithm is used.

Image Removed

Selecting the ancestor for future merges in the Merge Project dialog.

Learn more about merge types in Teamwork Cloud >>

Back to Top

keep your Internal Block diagram (IBD) consistent with Activities with less effort! Our brand new behavior-to-structure synchronization allows you to validate Part Properties in an IBD to check whether Proxy Ports exist and are typed by compatible Interface Blocks based on flows found in Activities. As a result, instead of manually updating IBDs to be consistent with Activities, coherence between them is ensured by automatically detecting inconsistencies and providing the user with the solvers to handle each inconsistency individually.

Image Added

Synchronizing IBD based on Activities. 

Learn more about behavior to structure synchronization >>

Contextual Relationships Enhancements

Contextual Relationships have undergone major improvements! From now on, you can create contextual relationships directly in structure tree view tables and represent data in table columns by considering the usage context of the row elements. 

Image Added

Creating contextual relationships in tables.

Additionally, for a more compact Internal Block Diagram (IBD) view, you can now represent contextual relationships in the Element Properties compartment of the element shape.

Image Added

Displaying contextual relationships in the element compartment. 

Learn more about creating and displaying contextual relationships >>

Other enhancements

  • In earlier versions, the Show Parts filter in the ICD Whitebox tables was hard to use in larger projects: only a limited list of connectors was visible; and identifying the connectors was difficult in some cases. This version brings enhancements that will allow easy searching, identification, and selection of all connectors outgoing from the parts. Using this dialog, you can easily filter connectors and choose which ones should be displayed in the table or hidden from it. Learn more >>


Image Added

Back to top


Content block
id272319258
Performance Improvements
  • Anchor
    numbering validation
    numbering validation
    Numbering validation. Project opening now takes less time as a result of boosting numbering validation efficiency.
    Image Added

A chart comparing the project opening speed in 2021x and 2021x Refresh1 SysML projects with 0.5M, 1M, 2M, and 5M elements.
  • Anchor
    element selection
    element selection
    Element selection. Further improvements have been introduced to element selection (i.e., the Select Element dialog and drop-down lists) performance. The stereotyped element search is now performed approximately 20-200 times faster.
  • Anchor
    import from another project
    import from another project
    Import from another project. Projects can be imported much faster as the import operation now works more like Copy/Paste rather than Merge.

    Image Added

A chart comparing the sample project import speed in 2021x and 2021x Refresh1 SysML projects with 0.5M and 1M elements.
  • Anchor
    Time consumption on large server projects
    Time consumption on large server projects
    Time consumption on large server projects. Report Wizard now utilizes significantly less time on large server projects using the Web Publisher 2.0 template, in comparison with the 2021x version.Image Added

    A chart displaying the results of performance testing between SysML project 5M and 10M sizes in the whole elements scope.
  • Anchor
    ignoring smart package calculation in tables and matrices
    ignoring smart package calculation in tables and matrices
    Ignoring Smart Package Calculation in Tables and Matrices. Depending on the complexity and the total number of Smart Packages within the specified scope in tables and matrices, significant performance degradation can be caused while building tables and matrices. Since the 2021x Refresh1, the inner Smart Packages are no longer calculated by default unless you turn on the Include Additional Content option. Consequently, tables and matrices are now built faster. 
    Image Added

    The contents of a Smart Package that falls within the specified scope is excluded when building a table. 
  • Anchor
    freezing smart package contents
    freezing smart package contents
    Refreshing Smart Package contents on demand. You can now suspend the automatic Smart Package contents recalculation in the background to enhance performance by simply changing the Smart Package state to Frozen. As a result, elements are no longer automatically added to the Smart Package contents; however, the dynamic contents can still be refreshed on demand by clicking the button.

Image Added

Refreshing the Smart Package contents on demand.  

Learn more about freezing the contents of Smart Packages >>

Info

Four SysML projects in 2021x that were used to run the performance tests, ranging from 0.5M to 5M in size, are equal in size to projects of earlier versions with sizes ranging from 1M to 10M. 


Content block
id884215702
Integrations

Importing Variability Data From the ENOVIA Model Definition Application

Info
This functionality is available with the 3DEXPERIENCE ENOVIA Model Definition Integration and Product Line Engineering plugins.

Import variability data to your modeling tool project directly from the 3DS ENOVIA Model Definition application on the 3DEXPERIENCE platform. The 3DEXPERIENCE ENOVIA Model Definition Integration plugin is available for your modeling tool (together with the Product Line Engineering plugin)

Image Added

Learn more about importing ENOVIA models >>

Learn more about authenticating with 3DEXPERIENCE platform >>

Back to top

Content block
id243174490
Modeling and Infrastructure

Tree View in Select Element Drop-Downs and Quick Find

Quick Find and Type Selection drop-downs have been enhanced with the Tree view. In cases when multiple elements share the same name, it will no longer be confusing as to which one to select: all you need to do is switch to the Tree view to identify the element's place in the model hierarchy. 

Image Added

Switching between the Tree and List views to find the needed element faster.

Anchor
Other Feature Improvements
Other Feature Improvements
Other improvements 

  • The 3DEXPERIENCE menu item groups all available integrations with the 3DEXPERIENCE platform. When you install plugins that support integration with the platform, all their available functionalities will be added under the 3DEXPERIENCE menu. Learn more about authentication with the 3DEXPERIENCE platform >>
    Image Added
  • Since the UsageInDiagrams Opaque Behavior is a time-consuming operation (it loads all diagrams - matrices, tables, and maps), it has been deprecated and replaced with the UsageInDiagramsWithSymbols Opaque Behavior that searches for symbol usages only. Learn more about built-in operations >>


Content block
id884222643

Key Issues Fixed

The following key issues have been fixed with this version:

  • Improved performance - Smart Packages that fall within the tracking scope are no longer automatically calculated when the Suspect Links Show Suspicions command is executed.
  • The problem with Java sign-in is solved and the modeling tool now launches on macOS Big Sur without warnings.
  • The project update no longer fails when the standard profile has no internal version specified.
  • The modeling tool no longer becomes unresponsive when the element search is in progress.
  • The diagram is no longer scaled incorrectly on mouse click/drag.
  • The filtered changes are now accepted/rejected recursively when performing the merge operation.
  • The information in structured expression queries is properly updated when adding projects to Teamwork Cloud.
  • The element refactoring no longer fails when the Legend item is applied.
  • The applied Legend item adornments are no longer removed after saving a Teamwork Cloud project locally.
  • The Diagram Info box in the diagram no longer changes its position after performing the merge operation.
  • Action pins no longer remain synced to Activity when the action behavior is unset.
  • Associations are no longer moved when centering Classes vertically. 
  • The modeling tool no longer freezes when publishing large projects to Teamwork Cloud.
  • When two different custom prefixes are applied for two different sets of elements, the element renumbering no longer works incorrectly for the set of elements with one custom prefix.

Back to Top






Content block
id252677720
Discontinued Products

CSV Import Plugin support will be discontinued from the next major version. Excel/CSV Sync or Excel/CSV Import features will be replacing the CSV Import Plugin.

Back to Top


Content block
id243713866
Collaboration

Global Element Usage Search

No more accidental Recovered Elements and unexpected surprises when updating Used Project versions! The latest release introduces the global element usage search functionality that allows you to query for the usages of the element you are about to modify or delete. Depending on the server-side configuration, projects using the element in question can be returned either from the entire Teamwork Cloud repository or the chosen custom indexed scope.

Image Added

Searching for element usages within the Teamwork Cloud repository.

Learn more about global element usage search >>

Nested Categories 

Do your projects need to be grouped hierarchically? Are you seeking to organize them in a folder-like manner? We have a solution! You can now organize your projects into nested categories so you can find them later with no difficulty.

Image Added

Organizing server projects into nested categories.

Representation of Teamwork Cloud Users

You now have the freedom to customize how individual Teamwork Cloud users are represented in the modeling tool (for example, when they lock elements) by simply changing the value of the Representation of Users environment option. It is your choice whether a User Name, a Full Name, or an Email address is shown to identify them. 

Image Added

Changing the user representation in the Teamwork Cloud project.

Learn more about representation of Teamwork Cloud users >>

Returning to Merge Dialog

Need to make some adjustments after finishing the merge operation? Not a problem! You can now quickly return to the previously performed merge operation if you notice that you have accepted or rejected the changes (e.g., rejected the element creation) by mistake and need to change your merge decisions.

Image Added

Returning to the Merge dialog to change merge decisions.

Learn more about returning to Merge dialog >>

Anchor
Other TWC Improvements
Other TWC Improvements
Other Teamwork Cloud-related Improvements

  • Filters in the Merge dialog have been redesigned to improve the user experience. 

  • Updating a server project with local changes in disconnected team collaboration now handles the Used Project branch deletions more effectively, with no errors. 

Back to Top


Content block
id243817262
Report Wizard
Content block
id243817262
Other Features

Report Wizard

With a significant improvement in report generations for large-scale MagicDraw projects, Report Wizard 2021x has now been equipped to more efficiently generate reports using Web Publisher 2.0 templates of projects, with less time required and supporting more elements than earlier versions of the product.
Image Removed
A bar chart displaying the performance testing of report generation from Report Wizard 19.0 SP4 and 2021x using Web Publisher 2.0.
You can view the overall progress of generating reports deploying Web Publisher 2.0 through the progress bar and its displayed success percentage.
Image Removed
The progress bar with the success percentage shown above when generating reports using Web Publisher 2.0.
A more effective tool of the Document Report Designer diagram is now available for conveniently drafting and designing new extensive templates of the Microsoft Word Document (DOCX) format. Discover more about Document Report Designer >>
Image Removed
Document Report Designer for drafting and designing new templates of the Microsoft Word Document (DOCX) format.
With the Spreadsheet Report Designer provided in Report Wizard 2021x, you are now capable of effectively designing and generating Microsoft Excel Spreadsheet (XLSX) format. Find out how to use Spreadsheet Report Designer >> 

Image Removed

Spreadsheet Report Designer for designing and generating the Microsoft Excel Spreadsheet (XLSX) format.
Web Publisher 2.0 now has the Quick properties panel, at the lower left (similar to MagicDraw), to show the documentation settings in the Documentation tab and properties in the Properties tab of elements selected in the diagram and from the Containment tree. Learn more about the new Quick properties panel >>

Image Removed

The Quick properties panel: Documentation and Properties tabs.
  • The capability of $report.isEmpty(obj) has been specially improved to check HTML String whether it is empty or not. Learn more about using this report tool >>

  • The multi-field sorter is now available as a function for sorting a collection of elements in ascending or descending order by deploying multiple sorting properties, rather than merely a single property as in previous versions. Find out more about the multi-field sorter >>

  • You can now sort elements by using a tag in applied stereotypes, regardless of being customized. Learn more about this capability of the sorter tool >>

  • You can utilize a new sorter function for sorting elements as they appear in the Containment tree. Discover how to use this sorter tool >>

  • With a new option reducing XML meta-data file name length, the error of Web Publisher 2.0 files with lengthy names has been fixed. Know more about this report variable in Web Publisher 2.0 >>
  • Single or double quotes can now be interchangeably used in both of the #includesection and #sectionBegin directives and $import.includeSection(templateName, sectionName) of the Import Tool.
  • You can now access and list property objects (including DSL) classified in the PropertyGroup of customized stereotypes. See how the report tool works this way >>
  • Reference bookmarks and their links can be created for DOCX numbered items. Learn about using these bookmark tools >>
  • Functions for displaying lists of properties in property groups for given elements and stereotypes are ready to use. Learn how to use this group of report tools >>
  • Other

    • The automatic UAF, SysML, and BPMN project migration has been enhanced. The projects are migrated silently and now no additional confirmation is required.

    Back to Top