Add Compatibility Matrix and Upgrade Guide

khode-mx · khode-mx · commit cdc104631a05 · 2026-03-02T17:00:01.000+01:00
Add Compatibility Matrix
Add Upgrade guide from 2506 to 2512
Udpated weights
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 its compatibility with various versions of Teamcenter, Teamcenter X, and Mendix."
+---
+
+Below is an overview that showcases compatibility of Teamcenter Connector with 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 higher* | 2512, 2506, 2412, 2406 | 2512, 2506, 2412 | TC SSO does not work for TC (self hosted) 2406 and older |
+| 2506.0.0 | 10.20.0 or higher* | 2506 | 2506 | |
+| 2412.225.0 | 10.4.0 or higher* | 2412 | 2412 | |
+| 2406.3.0 | 10.0.0 or higher* | 2406 |N/A | |
+| 3.6.0 | 9.18.2 or higher** | 14, 13 | N/A | TC SSO does not work for TC (self hosted) 2506 and newer |
+
+<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/upgrade-from-2506-to-2512.md b/content/en/docs/marketplace/platform-supported-content/modules/siemens/teamcenter-connector/upgrade-from-2506-to-2512.md
@@ -0,0 +1,51 @@
+---
+title: "Upgrade 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 guide will help updating the Teamcenter Connector 2506.0.0 to 2512.0.0.
+
+In this release of the Teamcenter Connector the Single Sign-On (SSO) is implemented differently, which means that in 2512.0.0 the OIDC module is no longer in use.
+
+To see all the changes in this release please view the release notes of the [Teamcenter Connector](https://marketplace.mendix.com/link/component/111627).
+
+## Download Teamcenter Connector and 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).
+
+## Resolve Breaking changes
+Fist of all, resolve the breaking changes mentioned in the release notes:
+* 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 fundamentals have been changed:
+* The `Admin` user role used to have login options (using the `AdminLogin` microflow):
+in 2512 we have removed login functionalities for the `Admin` user role. If the `Admin` role of your application requires the option to login to Teamcenter, provide it with the TcConnector `User` module role.
+* Removed TeamcenterConfiguration event handlers:
+if you have custom logic for `TeamcenterConfiguration` objects, confirm it has the correct validations.
+* Multiple microflows and pages moved from `Public` to `Private` folder:
+check these are no longer directly referenced.
+
+## 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 of the domain model.
+* Once updated, there might be some entities that now give 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 of introduction of new attribute names and relations. Open the entity in question and give all attributes with no rights the read-only access right.
+
+## Remove marketplace modules
+The following marketplace modules are no longer used. These can be removed if they are not used by any other logic in your app:
+* OIDC SSO module
+* UserCommons module
+* MxModelReflection module
+
+## Use React client (optional)
+Teamcenter connector 2512 is compatible with React Client. To enable this go to `Settings > Runtime > Use React client > Yes`. [Read more about React Client here.](https://docs.mendix.com/refguide/mendix-client/react/)
+
+## Setup Teamcenter Configuration
+Because of the new way that SSO is setup, your Teamcenter configuration needs to be set again when deploying a new app with Teamcenter Connector 2512.0.0. Don’t worry, the configuration is much easier than it was before. For setting up the configuration please follow the guide on [Setting up Teamcenter Connector configuration in 2512](/appstore/modules/siemens-plm/configuring-connection-2512).
