前端接入说明

最近更新时间:11/9/2023, 4:23:36 PM作者:austinxxia(夏国昌)

外部第三方接入

适用情况

适用于外部第三方已有现成前端页面,不想再进行额外过多的开发的情况,可以直接通过iframe嵌入工业云平台。

适用于工业云的三个端接入:门户端、Console端、Sp端

第三方提供物料

需提供以下信息于工业侧同学进行配置

  1. 接入端(门户端、Console端、Sp端)
  2. 接入的页面地址(如https://someDomain.com)
  3. 接入的菜单模块名称

接口调用

如接入页面需调取工业侧接口,请参考OAuth说明接入,换取access_token后再进行接口(openapi)调用。

高度样式问题

由于此方案接入页面跟工业云侧页面非同源,可能会存在高度样式问题,通常接入方可以在页面初始化好之后主动传递页面的高度到工业云侧,例如:

window.top.postMessage(
{
  type: "third-app-iframe-height",
  data: 5236, // 计算好的页面高度
  },
    "*"
);

回到顶部

涉及到需要工业云侧页面回到顶部,可以主动传递信息:

window.top.postMessage(
  {
  type: "third-app-iframe-scrollToTop",
  },
    "*"
);

腾讯内部产品接入

适用情况

本方案适用于腾讯内部其他产品已有页面接入工业云平台,类似于外部页面通过iframe嵌入工业云平台。

接入说明

本方案直接给定一个同源域名给接入方,以接入的「工业视觉平台」为例:

  1. 商定一个同源域名,如industryai.{工业环境域名}。
  2. 接入方需在tke里面录入对应域名,配置访问规则。
  3. 配置对应的本地host即可访问。

由于是同源域名,可以直接从Cookie中获取到access_token,接入方按照key=access_token的规则去解析对应的身份信息即可。

接口调用

因为是同源域名,如接入页面需调取工业侧接口,可以直接从Cookie中获取到access_token,再进行接口(openapi)调用。