Document Mendix inside Teamcenter (public Beta, 11.12) by jdiehl · Pull Request #11384 · mendix/docs

jdiehl · 2026-06-19T10:24:55Z

Description

New reference page under /refguide/mendix-client/mendix-inside-teamcenter/ documenting how to embed a Mendix web app as a native component inside Siemens Teamcenter Active Workspace using the embedded client.

This builds on the embedded client documentation added by @WimJongeneel in #11204 and is tied to the 11.12 release.

Changes

New page: refguide/runtime/mendix-client/mendix-inside-teamcenter.md
Updated refguide/runtime/mendix-client/_index.md with a cross-reference to the new page

Coverage

The new page covers:

Version prerequisites (Beta: Mendix 11.12 / TC 2512; GA: Mendix 11.18 / TC 2612)
Adding an Embedded navigation profile in Studio Pro
Configuring CORS (concrete runtime settings and m2ee.yaml example)
Installing the MendixEmbedded AWC component and registering it on a page
Configuring the Teamcenter CSP (gateway/config.json directives)
Authentication via Teamcenter SSO (links to TC Connector docs)
Passing Teamcenter context as startup parameters (code example)
Known Beta limitations

CLAassistant · 2026-06-19T10:25:02Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
2 out of 3 committers have signed the CLA.

✅ jdiehl
✅ MarkvanMents
❌ Jonathan Diehl

Jonathan Diehl seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

wanchoorohan

Provided few suggestions.

MarkvanMents · 2026-06-23T13:06:03Z

@jdiehl
There still seems to be discussion on the content of this. Can you let me know when it is ready to be reviewed by the technical writers?
Thanks.

MarkvanMents

I started reviewing this, but realize that there are a lot of things which are still awaiting confirmation/more documentation.

Can you let me know when this is ready for me to do more work on it?

jdiehl · 2026-06-30T15:01:53Z

I resolved all comments. @MarkvanMents can you continue your review?

MarkvanMents · 2026-07-02T12:59:29Z

Thanks. Working on this. I'll let you know if I have any questions.

Fixes grammar, punctuation, formatting, and clarity in the Mendix Inside Teamcenter feature documentation and cross-reference in the Teamcenter Connector page. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

MarkvanMents

Thanks for this PR @jdiehl, @brambrink, and @wanchoorohan

I've done some proofreading and have a number of questions/suggestions.

I have also asked @NicoletaComan to have a quick look as she is familiar with the Teamcenter documentation.

Please let me know if you have any questions about my changes in ad233c0.

MarkvanMents · 2026-07-02T14:00:51Z

+For information about embedding a Mendix web app as a native component inside Siemens Teamcenter Active Workspace, see [Mendix Inside Teamcenter](/refguide/mendix-client/mendix-inside-teamcenter/). This requires you to be using Mendix version 11.12.0 or above.
+


This seems much too specialized to have in the introduction of the Mendix Client page.
I think this might be better somewhere like https://docs.mendix.com/appstore/modules/siemens-plm/teamcenter-connector/ where people will be looking for Teamcenter information.

I've moved it there.

Suggested change

For information about embedding a Mendix web app as a native component inside Siemens Teamcenter Active Workspace, see [Mendix Inside Teamcenter](/refguide/mendix-client/mendix-inside-teamcenter/). This requires you to be using Mendix version 11.12.0 or above.

MarkvanMents · 2026-07-03T08:13:27Z

+
+| | Mendix | Teamcenter | Teamcenter Connector |
+| --- | --- | --- | --- |
+| **Beta** | 11.12 | 2512 | 2606.0.0 or above |


I still don't see this connector version in the Marketplace.

MarkvanMents · 2026-07-03T10:03:22Z

+
+#### CORS for TcSSO Published REST Service
+
+Configure the [CORS settings](/refguide/cors-settings/) for the TcSSO Published REST Service that is included in the Teamcenter Connector and add your teamcenter host `https://your-teamcenter.example.com` to the Allowed Origins.


Imported the Teamcenter Connector but couldn't find where to change this setting. I couldn't see a Published REST Service as part of TcConnector 2512.1.1. Is it in 2606, or am I looking in the wrong place?

MarkvanMents · 2026-07-03T10:07:10Z

+
+### Adding the Component to Active Workspace
+
+1. Obtain the `MendixEmbedded` component from [GitHub](TBD).


Need a link here

MarkvanMents · 2026-07-03T10:10:34Z

+To display the Mendix app on an Active Workspace page, add a card definition for it to the relevant `layoutsViewModel.json` file in your Active Workspace stage repository. Set `declarativeKeyContext` to the URL of your Mendix runtime:
+
+```json
+"Mendix": {


I assume this is just an example name? I think we should make it clearer that this is an example.

MarkvanMents · 2026-07-03T10:13:24Z

+}
+```
+
+Add `"Mendix"` to the relevant layout handler grid and rebuild Active Workspace. If the Mendix card does not appear after rebuilding, clear the browser cache to ensure the new chunk is loaded.


Is this "Mendix" as in the json object, or "Mendix" as in the "title" of the json object?

MarkvanMents · 2026-07-03T10:32:21Z

+For the GA release we plan to offer an alternative authentication flow that is fully invisible and does not require a popup.
+{{% /alert %}}
+
+Follow these steps to configure authentication. Steps 1–3 require Teamcenter administrator access.


You say that administrator access is required on each step. I don't think we need it here as well.

MarkvanMents · 2026-07-03T10:33:17Z

+
+    Register the Mendix app in the Teamcenter Deployment Center so TcSS can authenticate it. For instructions, see [Registering Your App for Teamcenter SSO](/appstore/modules/siemens-plm/configuring-connection-2512/#register-your-app-for-teamcenter-sso).
+
+    This step requires administrator access to Teamcenter.


Perhaps make this more obvious?

And the other ones below as well?

Suggested change

This step requires administrator access to Teamcenter.

{{% alert color="info" %}}This step requires administrator access to Teamcenter.{{% /alert %}}

MarkvanMents · 2026-07-03T12:13:58Z

+
+## Known Limitations (Beta)
+
+* **Cross-site cookies:** The browser must allow cross-site cookies for the Mendix domain. This is required because the Mendix app runs on a different origin than Active Workspace. Configure this per-domain via organization policy (for example, Intune).


Is this really a limitation? It is not something that we can even change so I would say it is a prerequisite.

MarkvanMents · 2026-07-03T12:16:32Z

+
+* **Cross-site cookies:** The browser must allow cross-site cookies for the Mendix domain. This is required because the Mendix app runs on a different origin than Active Workspace. Configure this per-domain via organization policy (for example, Intune).
+* **Authentication popup:** During Beta, the Teamcenter Connector SSO flow opens a popup window. This can be automated to require zero additional clicks after the user is already authenticated with TcSS.
+* **Optional parameters fallback:** If an optional startup parameter is omitted, the embedded client shows the fallback page rather than using the parameter's default value. This is a known limitation of the embedded client. See [Embedding the Client](/refguide/mendix-client/embedding-the-client/).


This is currently noted as a known issue. I think we should be consistent in the language here. If it is an issue there is an implication that we will fix it in the future.

Suggested change

* **Optional parameters fallback:** If an optional startup parameter is omitted, the embedded client shows the fallback page rather than using the parameter's default value. This is a known limitation of the embedded client. See [Embedding the Client](/refguide/mendix-client/embedding-the-client/).

* **Optional parameters fallback:** If an optional startup parameter is omitted, the embedded client shows the fallback page rather than using the parameter's default value. This is a known issue with the embedded client. See [Embedding the Client](/refguide/mendix-client/embedding-the-client/).

NicoletaComan · 2026-07-03T12:34:36Z

+* The browser allows cross-site cookies for the Mendix domain. This can be configured per-domain via organization policy (for example, using Intune).
+* There is bidirectional network connectivity between the user's browser and both the Mendix runtime and the Teamcenter server.
+
+For Teamcenter Connector prerequisites, see [Teamcenter Connector](/appstore/modules/siemens-plm/teamcenter-connector/).


Direct path to the prereqs: /appstore/modules/siemens-plm/teamcenter-connector/#prerequisites

NicoletaComan · 2026-07-03T12:50:17Z

+* **Use persistable object IDs only.** Pass `Item` UIDs or `ItemRevision` UIDs. These are stable and unique across sessions.
+* **Avoid non-persistable IDs.** BOM line IDs are runtime calculation results that lose synchronization when Teamcenter configuration rules change. Do not use them as parameters.
+* **Prefer `Item` IDs over `ItemRevision` IDs** where possible. `Item` IDs are context-independent and do not depend on the revision rule in effect.
+* **Discover available parameters** by referring to the Active Workspace documentation for a list of available context parameters.


Is there a link we can add to "Active Workspace documentation"?

NicoletaComan · 2026-07-03T12:51:25Z

+## Known Limitations (Beta)
+
+* **Cross-site cookies:** The browser must allow cross-site cookies for the Mendix domain. This is required because the Mendix app runs on a different origin than Active Workspace. Configure this per-domain via organization policy (for example, Intune).
+* **Authentication popup:** During Beta, the Teamcenter Connector SSO flow opens a popup window. This can be automated to require zero additional clicks after the user is already authenticated with TcSS.


Small typo. Should be "pop-up".

NicoletaComan · 2026-07-03T13:04:38Z

+
+| | Mendix | Teamcenter | Teamcenter Connector |
+| --- | --- | --- | --- |
+| **Beta** | 11.12 or above | 2512 | 2606.0.0 or above |


Document Mendix inside Teamcenter (public Beta, 11.12)

3abdf8f

MarkvanMents self-requested a review June 19, 2026 10:44

MarkvanMents self-assigned this Jun 19, 2026

MarkvanMents added Needs language review 11.12 LTS labels Jun 19, 2026

wanchoorohan reviewed Jun 19, 2026

View reviewed changes

brambrink suggested changes Jun 23, 2026

View reviewed changes

brambrink reviewed Jun 24, 2026

View reviewed changes

Comment thread content/en/docs/refguide/runtime/mendix-client/mendix-inside-teamcenter.md

brambrink reviewed Jun 26, 2026

View reviewed changes

Comment thread content/en/docs/refguide/runtime/mendix-client/mendix-inside-teamcenter.md

Small Prrofread

4b0e883

MarkvanMents requested changes Jun 26, 2026

View reviewed changes

MarkvanMents added Future release Needs R&D technical verification and removed 11.12 LTS labels Jun 29, 2026

jdiehl added 2 commits June 30, 2026 14:14

addressed feedback

1b33b3e

addressed feedback

32e6057

Proofread and polish Mendix Inside Teamcenter documentation

ad233c0

Fixes grammar, punctuation, formatting, and clarity in the Mendix Inside Teamcenter feature documentation and cross-reference in the Teamcenter Connector page. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

MarkvanMents requested changes Jul 3, 2026

View reviewed changes

MarkvanMents requested a review from NicoletaComan July 3, 2026 12:22

NicoletaComan reviewed Jul 3, 2026

View reviewed changes

NicoletaComan requested changes Jul 3, 2026

View reviewed changes

		For information about embedding a Mendix web app as a native component inside Siemens Teamcenter Active Workspace, see [Mendix Inside Teamcenter](/refguide/mendix-client/mendix-inside-teamcenter/). This requires you to be using Mendix version 11.12.0 or above.


		#### CORS for TcSSO Published REST Service

		Configure the [CORS settings](/refguide/cors-settings/) for the TcSSO Published REST Service that is included in the Teamcenter Connector and add your teamcenter host `https://your-teamcenter.example.com` to the Allowed Origins.


		### Adding the Component to Active Workspace

		1. Obtain the `MendixEmbedded` component from [GitHub](TBD).


		Register the Mendix app in the Teamcenter Deployment Center so TcSS can authenticate it. For instructions, see [Registering Your App for Teamcenter SSO](/appstore/modules/siemens-plm/configuring-connection-2512/#register-your-app-for-teamcenter-sso).

		This step requires administrator access to Teamcenter.

	This step requires administrator access to Teamcenter.
	{{% alert color="info" %}}This step requires administrator access to Teamcenter.{{% /alert %}}


		## Known Limitations (Beta)

		* Cross-site cookies: The browser must allow cross-site cookies for the Mendix domain. This is required because the Mendix app runs on a different origin than Active Workspace. Configure this per-domain via organization policy (for example, Intune).

	* Optional parameters fallback: If an optional startup parameter is omitted, the embedded client shows the fallback page rather than using the parameter's default value. This is a known limitation of the embedded client. See [Embedding the Client](/refguide/mendix-client/embedding-the-client/).
	* Optional parameters fallback: If an optional startup parameter is omitted, the embedded client shows the fallback page rather than using the parameter's default value. This is a known issue with the embedded client. See [Embedding the Client](/refguide/mendix-client/embedding-the-client/).

Uh oh!

Conversation

jdiehl commented Jun 19, 2026

Description

Changes

Coverage

Uh oh!

CLAassistant commented Jun 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wanchoorohan left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

MarkvanMents commented Jun 23, 2026

Uh oh!

Uh oh!

Uh oh!

MarkvanMents left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jdiehl commented Jun 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MarkvanMents commented Jul 2, 2026

Uh oh!

MarkvanMents left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

CLAassistant commented Jun 19, 2026 •

edited

Loading

jdiehl commented Jun 30, 2026 •

edited

Loading