Insights Hub Insights Hub 与 Mendix 应用集成

2024-03-19T02:30:42.000-0400

Applications

摘要

Insights Hub 与 Mendix 应用集成

Insights Hub 可与 Mendix 应用集成，从而使得客户的 Mendix 应用能够使用到 Insights Hub 平台提供的开放式 IoT 功能。

目前在 Mendix Marketplace 中有两个 Starter Application。如下图所示：

我们需要选择第一个 Starter Application，如其描述中所述：

启动过后，按照如下步骤创建应用：

应用的名字我们填：Siemens_Insights_Hub_Starter_Application_V4_0_0

最后点击 "Create app" 创建应用。

如果在创建应用中遇到如下提示，直接点 Close 按钮忽略即可。因为应用中可能某些依赖有错误（我们会在后续的修改中解决其它依赖问题）；或者这只是警告信息，可以忽略。

如下所示，通过应用浏览器展开应用。我们需确保如下三个模块是正常被引入的，因为后续主要是对这三个模块里的配置进行修改。

通过该模块，已登录 Insights Hub 的用户无需再次登录便能使用应用程序。同时此模块还能让用户在本地测试应用程序。更多信息请参考模块介绍中单点登录（Single Sign-On）部分。

模块独立下载地址：Siemens Insights Hub SSO。

由于应用是运行在本地私有云（LPC）环境中，我们需要对以下信息进行配置：

AskForCredentialsOnStartup。配置为 True 过后，在本地运行应用时会弹出窗口让用户输入 App Credentials 信息。
CockpitApplicationVersion。在 Insights Hub 的 Developer Cockpit 上注册应用时填写的版本信息。
EnableLocalApiReverseProxy。本地反向代理。根据实际情况填写。
UserEmail。非必须值。根据实际情况填写。
UserTenant。通过 App Credentials 获取 token 时，请求 body 里的参数。参考 Token Management 服务中对于请求参数的介绍。
CockpitApplicationName。在 Insights Hub 的 Developer Cockpit 上注册应用时填写的应用内部名字。
GatewayURL。Gateway 的地址。默认值为 AWS 公有云上 Gateway 的地址：https://gateway.eu1.mindsphere.io。需修改为实际环境中 Gateway 部署的地址。例如：https//gateway.{yourHost}.{yourDomain}。
HostTenant。通过 App Credentials 获取 token 时，请求 body 里的参数。参考 Token Management 服务中对于请求参数的介绍。
PublicKeyURL。默认值为 AWS 公有云上的地址：https://core.piam.eu1.mindsphere.io/token_keys。需修改为实际环境中 piam 服务的地址。例如：https://core.piam.{yourHost}.{yourDomain}/token_keys。

当修改好了模块相关参数后，我们需要注册模块，这样应用在启动时便会直接执行模块中的微流。

在应用设置中 Runtime 选项里注册 Single Sign-on 中的微流：

Insights Hub 中 OS Bar 显示为如下：

参考 Insights Hub 模块详细信息中的 Siemens Insights Hub OS Bar 部分。

Config。OS Bar 中显示的信息。格式为 JSON。例如：{"displayName":"Sample App","appVersion":"0.0.0","appCopyright":"© Siemens 2023","links":{"default":[{"type":"www","name":"DEV Information","value":"http://sie.ag/abc"}],"de":[{"type":"www","name":"Entwicklungs-Information","value":"http://sie.ag/abc"}]}}。
OSBarURL。加载 OS Bar 资源的地址。默认值为 AWS 公有云上 OS Bar 的静态资源地址：https://static.eu1.mindsphere.io/osbar/v4/js/main.min.js。需根据实际环境进行配置。

关于 Insights Hub OS Bar 的更多介绍，请参考：OS Bar Design。

引入模块可将 Insights Hub 设计风格的组件集成到应用中。Demo 程序将会使用到 Web Content 中的一些组件。

更多信息请参考 Insights Hub 模块详细信息中 Siemens Insights Hub Web Content 部分。

关于部署 Mendix 应用的方式有很多种，比如：Cloud Foundry、Mendix Cloud、Private Cloud、本地 Docker 部署。参考 Mendix 官网关于“部署方式”的介绍。

针对私有云客户可以采用 Docker 的方式部署。

Applications - Other Insights Hub