|
| 1 | +--- |
| 2 | +title: "Upgrading Teamcenter Connector 2506.0.0 to 2512.0.0" |
| 3 | +url: /appstore/modules/siemens-plm/upgrade-teamcenter-connector-2506-to-2512/ |
| 4 | +weight: 4 |
| 5 | +description: "Describes the steps to upgrade Teamcenter Connector 2506.0.0 to 2512.0.0 and discusses how breaking changes can be resolved." |
| 6 | +--- |
| 7 | + |
| 8 | +## Introduction |
| 9 | + |
| 10 | +This document guides you through the process of upgrading the Teamcenter Connector from version 2506.0.0 to version 2512.0.0. |
| 11 | +In version 2512.0.0 of the Teamcenter Connector, the Single Sign-On (SSO) option is implemented differently, so the OIDC module is no longer in use. |
| 12 | +To see all the changes in this release, refer to the [Teamcenter Connector](https://marketplace.mendix.com/link/component/111627) release notes. |
| 13 | + |
| 14 | +## Upgrading the Teamcenter Connector |
| 15 | + |
| 16 | +1. Download the latest versions of the Teamcenter Connector and of the Teamcenter Extension: |
| 17 | + |
| 18 | + * Download the latest 2512.x version of the [Teamcenter Connector](https://marketplace.mendix.com/link/component/111627). |
| 19 | + * Download the latest 4.x version of the [Teamcenter Extension](https://marketplace.mendix.com/link/component/225544). |
| 20 | + |
| 21 | +2. Resolve the breaking changes mentioned in the [release notes](https://marketplace.mendix.com/link/component/111627): |
| 22 | + |
| 23 | + * Replace `UserLogin` with `NAV_UserLogin`. |
| 24 | + * Replace `ShowLoginPage` with `NAV_UserLogin`. |
| 25 | + * Replace `LoginToMultipleTeamcenters` with `NAV_UserLoginMultipleActive`. |
| 26 | + * Replace `AdminHomePage` with `NAV_AdminHomePage`. |
| 27 | + * Remove `SSO_RegisterRequestHandlers` after startup microflow. |
| 28 | + |
| 29 | + The following fundamental changes have been made: |
| 30 | + |
| 31 | + * The `Admin` user role used to have login options through the `AdminLogin` microflow. In version 2512.0.0, login functionalities have been removed for the `Admin` user role. If the `Admin` role of your app requires the option to log in to Teamcenter, assign it the TcConnector `User` module role. |
| 32 | + * The `TeamcenterConfiguration` event handlers have been removed. If you have custom logic for `TeamcenterConfiguration` objects, confirm it includes the correct validations. |
| 33 | + * Multiple microflows and pages have been moved from the `Public` to the `Private` folder. Make sure that these are no longer directly referenced. |
| 34 | + |
| 35 | +3. Update entity access. |
| 36 | + To resolve the `Entity access is out of date` error, go to the domain model, and click the **Update security** button on the top bar. |
| 37 | + Once updated, there might be some entities that return the following error: `Non-persistable entity (entityName) contains access rules restricting members to have no access rights, which is not allowed.` This is happening because new attribute names and relations have been introduced. Open the entity in question and assign read-only access to all attributes with no rights. |
| 38 | + |
| 39 | +4. Remove Marketplace modules. |
| 40 | + The following Marketplace modules are no longer used, and can be removed if they are not used by any other logic in your app: |
| 41 | + |
| 42 | + * OIDC SSO module |
| 43 | + * UserCommons module |
| 44 | + * MxModelReflection module |
| 45 | + |
| 46 | +5. Use React client (optional). |
| 47 | + Teamcenter Connector 2512 is compatible with React Client. To enable this, go to **Settings**, then to **Runtime**, then select **Yes** for **Use React client**. |
| 48 | + For details on React Client, refer to its [documentation page](/refguide/mendix-client/react/). |
| 49 | + |
| 50 | +6. Set Up the Teamcenter Configuration. |
| 51 | + Due to the SSO setup, you need to set up the Teamcenter configuration again when you deploy a new app with Teamcenter Connector 2512.0.0. For details on how to do that, follow the steps in [Configuring the Connection to Teamcenter with Teamcenter Connector 2512.0.0 and Above](/appstore/modules/siemens-plm/configuring-connection-2512). |
| 52 | + |
0 commit comments