您的快速入门 Mendix–Teamcenter 集成
关键要点
- Teamcenter Extension 示例应用程序是开始集成之旅的最佳地点 Mendix 使用 Teamcenter。 通过使用示例应用程序,您将获得良好的开端,因为您拥有一组开箱即用的集成。
- 如何向 Teamcenter 进行身份验证取决于您的环境。 Teamcenter X 的身份验证设置与传统 Teamcenter 不同。请务必遵循所有必要的设置步骤。
- Teamcenter Extension 示例应用程序是了解与 Teamcenter 集成的最佳方式 Mendix 在引擎盖下工作。 您可以检查如何在 Studio Pro 中直接设置最常见的集成类型。
在本指南中,您将设置第一个与 Teamcenter 环境集成的应用程序。我们的目标是 Teamcenter 扩展示例应用程序 启动并运行,并添加我们的第一个集成。请确保您能够访问 Teamcenter 或 Teamcenter X 环境,以便能够遵循本指南中的所有步骤。
Teamcenter Extension Sample App 已经包含 Teamcenter 连接器 和 Teamcenter 扩展在本指南中,您将仅使用 Teamcenter Connector 进行首次 Teamcenter 调用。在后续博客文章中,您还将使用 Teamcenter Extension 创建新的自定义集成。如需了解更多关于这些模块的信息,请访问 阅读我们最近的博客文章 关于那个确切的话题!
1 – 创建你的应用程序
我们将创建一个新的应用程序 Mendix Studio Pro 10.24.2 并使用 Teamcenter Extension Sample App v4.1.0 作为起点。使用以下两种方法之一创建您的应用程序。
- 选项1: 为此,首先打开 Studio Pro 并选择 创建新应用。从可用启动应用程序的概览中,选择 Teamcenter 扩展示例应用程序.

- 选项2: 或者,导航至 Teamcenter 扩展示例应用程序市场页面 并选择 从应用程序开始 完成应用创建向导。请注意,该应用将在 Mendix 版本 10.12.6,因此请确保在 Studio Pro 版本 10.24.2 中打开应用程序并进行升级。

首次在 Studio Pro 中打开项目时,系统将提示您启用附加模块 TeamcenterExtension.mx模块。 一定要选择 信任模块并启用扩展.

现在,我们在 Studio Pro 中看到了新创建的应用。让我们先解决错误窗格中显示的错误。该错误提示我们为 加密密钥, 这是在应用程序中安全地存储凭证所必需的。
双击错误以打开应用程序设置对话框。

在设置对话框中打开 默认 配置,转到 常量 标签并设置 加密密钥 常量,即长度恰好为 32 个字符的密钥。使用您选择的方法生成安全密钥。

现在我们准备开始配置我们的应用程序以连接到 Teamcenter。
2 – 连接到 Teamcenter
运行项目并查看应用。以 管理控制台 用户。

我们会看到管理员的配置页面。点击 配置 Teamcenter.

此页面列出了我们所有的 Teamcenter 配置。每个要连接的实例都需要一个 Teamcenter 配置。该列表目前为空,因此我们将创建自己的配置。

如何继续取决于您的 Teamcenter 环境。如果环境是 Teamcenter(传统版)并设置为使用凭据进行身份验证,请继续阅读第 2.1 节。如果环境是 Teamcenter(传统版),但使用 SSO 进行身份验证,请继续阅读第 2.2 节。如果您有权访问 Teamcenter X Premium 环境,请转到第 2.3 节。
2.1 – 使用凭据连接
如果您的环境需要使用凭据进行身份验证,请继续阅读本节。在 Teamcenter 配置页面上,单击 新增 并配置您的 Teamcenter 实例。在本例中,您只需要 Teamcenter 主机地址 和 Teamcenter FMS URL如下所示。如果您的域名以 https 开头,您可能需要按照 此页面上的文档.

保存配置。使用页面右侧的演示切换器,切换到 demo_user.

这里我们可以看到用户仪表盘。目前,我们已登录到 Mendix 应用程序,但尚未连接到我们的 Teamcenter 实例。按 Teamcenter 登录.

输入您的用户名和密码并登录。 团队 和 角色 字段可能是必需的,但通常情况并非如此。

如果一切顺利,您现在会看到用户仪表板。右侧的图块指示用户拥有有效的 Teamcenter 会话。此时,您可以继续进行第三部分,从 Mendix 到 Teamcenter。

2.2 – 连接到 SSO
如果您使用的是传统的 Teamcenter 环境,并使用 SSO 进行身份验证,请继续阅读本节。首先,我们需要返回 Studio Pro。前往 应用程序设置,以及 运行时 选项卡设置 启动后 微流到 SSO_RegisterRequestHandlers 来自 Tc连接器 模块。重新启动应用程序并返回 Teamcenter 配置页面。

在 Teamcenter 配置页面上,单击 新增 并配置您的 Teamcenter 实例。设置 已启用 SSO 至 是。以下值适用于本指南中用作示例的环境,但您的端点可能有所不同。
如果您不确定如何配置这些字段,请参阅 Teamcenter Connector 文档页面中的第 6b 节 配置连接到 Teamcenter, 并确保联系您的 Teamcenter 管理员。
如果您尚未添加 Mendix 应用到 应用程序注册表, 请参阅此文档页面您的域名可能以 https 开头。如果是这样,您可能需要导入 Teamcenter 实例的客户端证书 Free Introduction Mendix 文档页面.

保存配置。使用页面右侧的演示切换器,切换到 demo_user.

这里我们可以看到用户仪表盘。目前,我们已登录到 Mendix 应用程序,但尚未连接到我们的 Teamcenter 实例。按 Teamcenter 登录 并在您的 SSO 登录页面上进行身份验证。

成功登录后,您将被重定向回您的 Mendix 应用程序,您以 demo_user 并受到用户仪表板的欢迎。右侧的磁贴表示用户拥有有效的 Teamcenter 会话。此时,您可以继续进行第三部分,从 Mendix.

如果您的回调返回如下所示的浏览器错误页面(具体页面因浏览器而异),则需要牢记三个重要注意事项:
- 确认您的应用程序已使用以下方式注册 的uid as LDAP 用户名属性 ,在 应用程序注册表.
- 注册应用程序时,您需要分别注册回调到本地主机(用于本地开发/测试目的)和回调到云托管应用程序
- 确认您已在应用程序的项目设置中添加所需的 TLS/SSL 证书
- 确认回调 URL 的端口与项目运行时端口相同

2.3 – 连接到 Teamcenter X SSO
如果您拥有 Teamcenter X 环境,请继续阅读本节。首先,我们需要返回 Studio Pro。前往 应用程序设置,以及 运行时 选项卡设置 启动后 微流到 OIDC.ASU_OIDC_启动. 重新启动应用程序并返回 Teamcenter 配置页面。

在 Teamcenter 配置页面上,单击 新增 并配置您的 Teamcenter 实例。设置 是 TcX 环境 至 是。以下值适用于本指南中用作示例的环境,但您的终端节点可能有所不同。如果您不确定如何配置这些字段,请联系您的 Siemens CApS 团队。您的域名可能以 https 开头。如果是这样,您可能需要导入证书 Free Introduction Mendix 文档页面.

填写所有必填信息后,保存 Teamcenter 配置。返回管理员配置页面。现在应该会出现两个新按钮。点击 配置 MxModelReflection.

访问 行政部, MxModelReflection, 国际数据中心和 系统模块 并点击 同步模块 以及已检查模块的所有实体和微流.

完成后,返回管理员配置页面并单击 配置 OIDC.

点击 OIDC 提供商配置 点击 新增 创建新的 OIDC 配置。

输入 别名, 客户ID和 客户机密。 输入 自动配置 URL 并点击 导入配置。如果您不确定如何配置这些字段,请联系您的 Siemens CApS 团队。新闻 已保存 在页面的最底部,我们才能继续下一步。

再次打开相同的 OIDC 配置并添加以下范围: Openid, 轮廓, email, sam_account, samauth.ten. 再次保存配置。

再次打开相同的 OIDC 配置并转到 用户配置 标签。 设置 存储用户主体的属性 至 电子邮件。 下 属性映射 按照截图设置映射。再次保存配置。

退出应用程序并点击 TcX 单点登录 登录 按钮。

以已通过 Teamcenter X 实例身份验证的用户身份登录。成功登录后,您将被重定向回您的 Mendix 应用程序。当前,用户已登录 Mendix 但尚未迁移到 Teamcenter,如右侧磁贴所示。单击 Teamcenter 登录.

片刻之后,右侧的图块会显示用户已拥有有效的 Teamcenter 会话。此时,您可以继续进行第三部分,从 Mendix 到 Teamcenter。

如果您的回调返回如下所示的浏览器错误页面(具体页面因浏览器而异),则需要牢记三个重要注意事项:
- 确认您的项目设置中具有所需的 TLS/SSL 证书
- 确认回调 URL 的端口与项目运行时端口相同
- 注册应用程序时,您需要分别注册本地主机的回调和云托管应用程序的回调

如果您需要帮助注册 Mendix 应用程序和回调 URL、入职用户或需要确认您拥有正确的 Teamcenter X 层级,请联系您的 Siemens CApS 团队。
3 – 测试应用程序
现在我们已经登录 Mendix 和 Teamcenter 一样,示例应用程序为我们提供了一系列已实现的调用。这些集成均由 Teamcenter Extension 生成,并在示例应用程序中实现。在本系列的下一篇博文中,我们将实现一个新生成的集成。但现在,让我们先来看看一些已生成的集成。首先,点击 搜索项目修订 开始搜索项目修订。

以下页面实现了 项目修订…已保存来自 Teamcenter 的查询搜索。在此实现中 名称, 商品编号和 条目修订类型 字段可用。通过您知道在 Teamcenter 环境中存在的名称搜索项目修订。
您只需使用星号即可搜索所有项目修订版本和派生对象类型。但请谨慎操作,因为这会返回所有匹配的对象,因此此调用可能需要很长时间。更具体的搜索参数可以加快搜索速度。

此页面显示 Teamcenter 调用完成后的搜索结果。点击任意 项目修订 查看更多详细信息。除了此功能之外,示例应用还包含以下实现: 更新 和 修改 选定的项目修订;显示具有默认或自定义配置的结构(例如 BOM);管理项目修订的附加数据集;或创建 新问题报告 用于项目修订。

回到主页,有三个额外的按钮。 搜索工作区对象 是一个实现 常规…已保存的查询搜索。 搜索数据集 是一个实现 数据集…已保存的查询搜索。 创建项目 创建新项目及其第一个项目修订。

Teamcenter Extension 示例应用程序不仅展示了这些现有的集成,还帮助您了解如何使用 Teamcenter Extension 实现这些集成。如果我们看一下微流程 DS_ItemRevisionSearchCriteria_GetDemoItemRevisions,注释告诉我们子微流 DemoItemRevision_SavedQueryItemRevision 由 Teamcenter Extension 生成。此微流在示例应用程序中实现,目前按原样运行。但是,我们也可以用 Teamcenter Extension 生成的另一个微流替换它,我们将在后续的博客文章中介绍。

我鼓励您亲自尝试探索此功能。不要害怕探索和实验!
结束你的第一个 Mendix–Teamcenter 集成
恭喜您设置了此应用程序集成 Mendix 和 Teamcenter 一起!Teamcenter Extension 示例应用程序提供了坚实的基础,提供开箱即用的功能和洞察力 MendixTeamcenter 交互。通过不同的连接方式(例如通过凭证、SSO 或 Teamcenter X),您现在拥有了扩展集成的工具。您可以随意探索和试用 Studio Pro 中的应用功能,如果需要帮助,请记得利用文档和社区资源。
常见问题 (FAQ)
-
最好的入门方法是什么 Mendix 和 Teamcenter 集成?
开始使用 Teamcenter 扩展示例应用程序因为它提供了现成的集成,并帮助您快速设置应用程序。请按照指南中的详细步骤运行它,并参考 官方文件 以获得更多支持。
-
为什么是我的 Mendix 应用程序无法连接到 Teamcenter?
确保您已完成所有必需的设置步骤,包括设置常量、导入证书以及正确配置回调 URL。请查看每个步骤中的故障排除提示 本指南的部分,如果您仍然遇到问题,请咨询 Teamcenter 社区空间 征求意见。
-
我可以在哪里找到帮助或资源 Mendix 和 Teamcenter 项目?
你可以访问 Teamcenter 扩展文档 详细指导或访问 Teamcenter 社区空间 与其他开发人员联系、提出问题并分享解决方案。