Magic Collaboration Studio 2021x Refresh1 brings several great functionalities, like the possibility to index cross-resource element usage data so later you could query for resources using certain elements from the modeling tool, easier management of new external user permissions and assignments, and the capability to create a hierarchical category structure in the Teamwork Cloud repository.The Collaborator app introduces the commit of multiple changes which significantly reduces the number of commits when editing models, the possibility to add hyperlinks to model elements, and further improvements to model editing functionalityintroduces several new and exciting capabilities, such as cross-cluster resource synchronization allowing you to share and reuse resources with their entire history from a remote server in a read-only mode, multiple permission management improvements, the possibility to generate project revisions reports, monitor user activity, and more. In addition, you can now containerize Magic Collaboration Studio web applications to define different deployment topologies based on user needs.
The Collaborator application brings new improvements as well. In addition to increased publishing performance, now you can contextualize documents a lot quicker by adding images and creating or moving paragraphs with just a few clicks.
Note
title
2021x Refresh2 HotFix 5 available
Due to Cassandra 3.11 approaching its end of life, the 2021x Refresh2 HotFix 5 has been released on April 21, 2023. This HotFix addresses the issue by supporting Cassandra 4 and introduces a number of bug fixes and performance improvements.
2021x Refresh2 Hot Fix 4 has been released on July 15, 2022, for CATIA Magic and No Magic portfolios. It introduces a number of bug fixes and performance improvements.
2021x Refresh2 Hot Fix 3 available for Teamwork Cloud, Magic Collaboration Studio, Web Application Platform
Due to the Spring Framework (Spring4Shell) vulnerability issues, the 2021x Refresh2 HF3 has been released on May 27, 2022. The HF3 addresses the Spring Framework (Spring4Shell) 5.3.0 to 5.3.17, 5.2.0 to 5.2.19 versions.
Global Element Usage Indexing and Search (Technology Preview)
Cross-Cluster Resource Synchronization
Teamwork Cloud coupled with Elasticsearch engine brings a powerful introduces a major new functionality allowing you to index resources for their element usages within the selected scope of Teamwork Cloud repository and later query these usages through the modeling tool. This enables you to evaluate what impact modifying or deleting certain model elements will have on other models that are using it.
Teamwork Cloud Admin Console is now enriched with a section dedicated to configuration, initiation, and management of resource indexes. You can choose what needs to be indexed, where, and how with just a few clicks!
Image Removed
The Teamwork Cloud Settings application UI allowing you to create and manage index configurations.
Nested Categories
The new version of Teamwork Cloud brings an ability to organize your resources in a flexible folder-like manner using nested categories. The hierarchical grouping of categories ensures that your huge repository will not turn into a mess and required resources will be found easier.
Image Removed
reuse resources from a remote server in a read-only mode. This makes collaboration between multiple disconnected Teamwork Cloud sites possible enabling sharing not only resources but their entire history as well. Synchronize resources between two different Teamwork Cloud servers with just a few clicks and choose whether resources should be synchronized manually, automatically, or when a specific commit tag is used.
Image Added
Resource synchronization can be used both to collaborate with distant teams and offload resources to a remote server.
Image Added
Creating remote resource configurations in the Settings application.
The Users and Roles applications have been improved and now allow you to filter the resources with branch-level permissions when selecting assignments.
Image Added
Filtering role assignments with branch-level permissions in the Users application.
Managing category-level permissions
In Teamwork Cloud 2021x Refresh2, managing category-level permissions is a lot more convenient. Use a new action in the Resources application to see and change all category assignments in one place.
Image Added
Managing category assignments.
Managing resource permissions
Managing the permissions of a specific resource is now easier because in the Resource pane you can see and change the users assigned to that resource.
This version of Teamwork Cloud introduces the functionality allowing you to export the history of any Teamwork Cloud project into an Excel spreadsheet. Sharing project revision reports can be a quick and easy way to demonstrate the project progress to team leads or project managers.
Image Added
Exporting project history into Excel.
Monitoring user activity
Now Teamwork Cloud allows you to monitor user activity in the Settings application, which will help you analyze how many consecutive users connect to Teamwork Cloud on a daily basis and how often the licence is used.
Image Added
The Settings application displaying recently active users.
In version 2021x Refresh2, Web Application Platform and all of its plugins are provided as separate web applications. This allows containerizing web applications in order to define different deployment topologies based on user needs. As shown in the figure below, you are free to choose a custom deployment option for your company to increase performance and scalability.
Image Added
An enterprise deployment option for Web Application Platform and its plugins.
Other
When updating Teamwork Cloud to a new version, be aware that several Authentication server properties have been modified. The default value of the authentication.redirect.uri.whitelist property needs to be changed to "https://$<web_application_server_IP>:<port>/". In addition, the following new properties need to be added to the property file: authentication.unlimited.token.expirity, authentication.client.unlimited,disable.credentials.authentication.
If you use SAML Identity Provider, note that the following new properties need to be added to the Authentication server properties file: authentication.saml.authn.contexts, authentication.saml.authn.context.comparison.type, authentication.saml.error.visible.
REST API Change Log
The
Nested categories in Teamwork Cloud.
Managing User Permissions and Assignments
Now all external users created in Teamwork Cloud upon successful authentication can automatically be given a certain set of permissions and assignments. Once you enable the Default user permissions template option, all newly created external users are instantly added to the dedicated Default Template user group. This way you can manage new user permissions and assignments a lot quicker because they simply inherit them from the dedicated user group.
Image Removed
A new option in the Settings application allowing you to manage new user permissions and assignments.
This version of Cameo Collaborator for Teamwork Cloud brings a major improvement allowing you to commit changes accumulated while editing a model in one go. This significantly reduces the number of commits and therefore decreases the database growth when editing models.
Image Removed
Committing model changes to Teamwork Cloud.
Adding Hyperlinks to Model Elements
Now Cameo Collaborator for Teamwork Cloud supports cross-references to model elements in all string-type values. You can represent links as element names, representation text, or any custom text. In addition, you can choose whether links are updated when element names change.
Image Removed
Adding links to model elements in string-type values.
New Model Editing Capabilities
We are constantly improving and expanding the model editing in Cameo Collaborator functionality, so this version of the product brings several new features as well. Now you can:
Create and edit slot values for Instance Specifications.
Edit bullet lists created by using document templates.
Image Removed
Creating a new value for an Instance Specification.
OtherNow you can organize Cameo Collaborator documents in a flexible folder-like manner using nested categories. The hierarchical grouping of categories will help you keep the repository tidy and find your documents easier. Image Removed
Enriching Cameo Collaborator Documents
Have you ever struggled to publish a document that would be easily understood by anyone and would look more like a website and less like a model? If so, we hope you tried using the paragraph creation functionality presented in earlier versions to add additional texts to your documents. However, we haven't stopped working on new document enrichment ways and are happy to announce that Cameo Collaborator 2021x Refresh2 brings a number of improvements and new capabilities allowing you to contextualize Cameo Collaborator documents more elaborately and quicker than before.
Adding images
Now you can decorate Cameo Collaborator documents with images as well. An image is added as a new document paragraph allowing you to update it or change its location at any time.
Image Added
Adding an image to a Cameo Collaborator document.
A new way to create paragraphs
In Cameo Collaborator 2021x Refresh2, paragraph creation is much user-friendly than before. Once you select to edit a document, paragraph creation icons are displayed after every section which lets you instantly select the paragraph location.
Image Added
Creating a paragraph.
Paragraph editing improvements
Editing paragraphs is easier as well. You can move a paragraph up or down directly in the editing pane, or use the Full screen button for rich text editing.
Our product team is continuously striving to improve Cameo Collaborator for Teamwork Cloud performance. Therefore in version 2021x Refresh2, publishing is twice faster compared to earlier versions of the product.
Image Added
Cameo Collaborator for Teamwork Cloud publishing performance.
Image Added
Performance of the first update after adding 100 elements.
Other Improvements
Now it is possible to subscribe to email notifications not only from a Cameo Collaborator document but from the Resources application as well.
Image Added
In Cameo Collaborator for Teamwork Cloud 2021x Refresh2, you can filter comments by the name of the comment author.
Image Added
From version 2021x Refresh2, users can edit or delete only the comments that they have created.
Now it is possible to publish a Cameo Collaborator document from a historical version of the project. However, such a document cannot be edited or commented.
From this version of Cameo Collaborator for Teamwork Cloud user interface depends on user permissions. For example, the commenting or editing button will be shown in a document only if you have the permissions to comment or edit the document.
Key Issues Fixed
Metric Tables in Cameo Collaborator documents are no longer editable.
Now heading numbering is not displayed in Cameo Collaborator documents exported to PDF or HTML when the selected scope is Active section or Active section's presentation elements.
