Merge pull request mendix#10826 from khode-mx/teamcenter-connector-compatibility-matrix

NicoletaComan · web-flow · commit 546f2c8cf003 · 2026-03-03T13:48:04.000+01:00
Add Compatibility Matrix and Upgrade Guide
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/2506-configuration/_index.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/2506-configuration/_index.md
@@ -2,7 +2,7 @@
 title: "Configuring the Connection to Teamcenter with Teamcenter Connector 2506.0.0 and Below"
 linktitle: "Connecting with Teamcenter Connector 2506.0.0 and Below"
 url: /appstore/modules/siemens-plm/configuring-connection-2506/
-weight: 2
+weight: 3
 description: "Describes the steps to configure the connection to your Teamcenter instance using Teamcenter Connector 2506.0.0 and below."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/2506-configuration/configuring-connection.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/2506-configuration/configuring-connection.md
@@ -1,7 +1,7 @@
 ---
 title: "Configuring the Connection to Teamcenter"
 url: /appstore/modules/siemens-plm/configuring-connection/
-weight: 3
+weight: 4
 description: "Describes the connection configuration steps for Teamcenter."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/2506-configuration/teamcenterx.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/2506-configuration/teamcenterx.md
@@ -1,7 +1,7 @@
 ---
 title: "Configuring the Connection to Teamcenter X"
 url: /appstore/modules/siemens-plm/teamcenterx/
-weight: 4
+weight: 5
 description: "Describes the steps to connect to Teamcenter X."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/compatibility-matrix.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/compatibility-matrix.md
@@ -0,0 +1,20 @@
+---
+title: "Compatibility Matrix"
+url: /appstore/modules/siemens-plm/compatibility-matrix/
+weight: 1
+description: "Provides an overview of Teamcenter Connector versions and their compatibility with various versions of Teamcenter, Teamcenter X, and Mendix."
+---
+
+This table showcases the compatibility between the Teamcenter Connector and various versions of Teamcenter, Teamcenter X, and Mendix.
+
+|Teamcenter Connector | Studio Pro version | Supported Teamcenter Self-hosted version | Supported Teamcenter X versions | Known Teamcenter incompatibility
+| :--- | :--- | :--- | :--- | :--- |
+| 2512.0.0 | 10.24.8 or above* | 2512, 2506, 2412, 2406 | 2512, 2506, 2412 | TC SSO does not work for self-hosted TC 2406 and below |
+| 2506.0.0 | 10.20.0 or above* | 2506 | 2506 | N/A |
+| 2412.225.0 | 10.4.0 or above* | 2412 | 2412 | N/A |
+| 2406.3.0 | 10.0.0 or above* | 2406 |N/A | N/A |
+| 3.6.0 | 9.18.2 or above** | 14, 13 | N/A | TC SSO does not work for self-hosted TC 2506 and above |
+
+<sub>* Latest Mendix 10 LTS version recommended</sub>
+
+<sub>** Latest Mendix 9 LTS version recommended</sub>
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/designing-applications.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/designing-applications.md
@@ -2,7 +2,7 @@
 title: "Designing Mendix Applications with Single or Multiple Active Teamcenter Configurations"
 linktitle: "Designing Mendix applications"
 url: /appstore/modules/siemens-plm/designing-applications/
-weight: 3
+weight: 5
 description: "Describes the process of designing Mendix application with single of multiple active Teamcenter configurations."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/documentation-references.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/documentation-references.md
@@ -1,7 +1,7 @@
 ---
 title: "Documentation References"
 url: /appstore/modules/siemens-plm/references/
-weight: 7
+weight: 9
 description: "Provides information on obtaining additional documentation."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/services-included.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/services-included.md
@@ -2,7 +2,7 @@
 title: "Using Teamcenter Services Included with the Teamcenter Connector"
 linktitle: "Using Included Teamcenter Services"
 url: /appstore/modules/siemens-plm/using-included-services/
-weight: 5
+weight: 7
 description: "Describes how to use Teamcenter services that are included in the connector."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/services-not-included.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/services-not-included.md
@@ -2,7 +2,7 @@
 title: "Using Teamcenter Services Not Included with the Teamcenter Connector"
 linktitle: "Using Teamcenter Services Not Included"
 url: /appstore/modules/siemens-plm/services-not-included/
-weight: 6
+weight: 8
 description: "Describes how to use Teamcenter services that are not included in the connector."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/teamcenter-configuration-guide.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/teamcenter-configuration-guide.md
@@ -2,7 +2,7 @@
 title: "Configuring the Connection to Teamcenter with Teamcenter Connector 2512.0.0 and Above"
 linktitle: "Connecting with Teamcenter Connector 2512.0.0 and Above"
 url: /appstore/modules/siemens-plm/configuring-connection-2512/
-weight: 1
+weight: 2
 description: "Describes the steps to configure the connection to your Teamcenter instance using Teamcenter Connector 2512.0.0 and above."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/teamcenter-domain-model.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/teamcenter-domain-model.md
@@ -1,7 +1,7 @@
 ---
 title: "Teamcenter Connector Domain Model"
 url: /appstore/modules/siemens-plm/teamcenter-domain-model/
-weight: 4
+weight: 6
 description: "Describes the Teamcenter Connector domain model."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/teamcenter-reference.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/teamcenter-reference.md
@@ -1,7 +1,7 @@
 ---
 title: "Teamcenter Connector Reference"
 url: /appstore/modules/siemens-plm/teamcenter-reference/
-weight: 8
+weight: 10
 description: "Lists and describes the Teamcenter Connector reference parameters."
 ---
 
diff --git a/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/upgrading-2506-to-2512.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/upgrading-2506-to-2512.md
@@ -0,0 +1,52 @@
+---
+title: "Upgrading Teamcenter Connector 2506.0.0 to 2512.0.0"
+url: /appstore/modules/siemens-plm/upgrade-teamcenter-connector-2506-to-2512/
+weight: 4
+description: "Describes the steps to upgrade Teamcenter Connector 2506.0.0 to 2512.0.0 and discusses how breaking changes can be resolved."
+---
+
+## Introduction
+
+This document guides you through the process of upgrading the Teamcenter Connector from version 2506.0.0 to version  2512.0.0.    
+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.    
+To see all the changes in this release, refer to the [Teamcenter Connector](https://marketplace.mendix.com/link/component/111627) release notes.
+
+## Upgrading the Teamcenter Connector
+
+1. Download the latest versions of the Teamcenter Connector and of the Teamcenter Extension:
+
+    * Download the latest 2512.x version of the [Teamcenter Connector](https://marketplace.mendix.com/link/component/111627).
+    * Download the latest 4.x version of the [Teamcenter Extension](https://marketplace.mendix.com/link/component/225544).
+
+2. Resolve the breaking changes mentioned in the [release notes](https://marketplace.mendix.com/link/component/111627):
+
+    * Replace `UserLogin` with `NAV_UserLogin`.
+    * Replace `ShowLoginPage` with `NAV_UserLogin`.
+    * Replace `LoginToMultipleTeamcenters` with `NAV_UserLoginMultipleActive`.
+    * Replace `AdminHomePage` with `NAV_AdminHomePage`.
+    * Remove `SSO_RegisterRequestHandlers` after startup microflow.
+
+    The following fundamental changes have been made:
+
+    * 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.
+    * The `TeamcenterConfiguration` event handlers have been removed. If you have custom logic for `TeamcenterConfiguration` objects, confirm it includes the correct validations.
+    * Multiple microflows and pages have been moved from the `Public` to the `Private` folder. Make sure that these are no longer directly referenced.
+
+3. Update entity access.     
+    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.    
+    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.
+
+4. Remove Marketplace modules.     
+    The following Marketplace modules are no longer used, and can be removed if they are not used by any other logic in your app:
+
+    * OIDC SSO module
+    * UserCommons module
+    * MxModelReflection module
+
+5. Use React client (optional).     
+    Teamcenter Connector 2512 is compatible with React Client. To enable this, go to **Settings**, then to **Runtime**, then select **Yes** for **Use React client**.     
+    For details on React Client, refer to its [documentation page](/refguide/mendix-client/react/).
+
+6. Set Up the Teamcenter Configuration.    
+    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).
+    
