# 关键词：页面集成、单点登录、页面跳转、门户应用卡片点击、门户应用页签
# 一、需求
在许多业务场景中，由于客户已有系统在长期稳定使用，或功能页面在苍穹上重构代价巨大等因素，需要将现有系统中的功能页面直接嵌入到苍穹中以供业务平滑使用，故涉及到一个非常常见的业务场景：苍穹与第三方系统进行页面集成。用户登录苍穹之后，在 **系统门户首页的应用中心点击指定应用卡片** 后，系统自动**单点登录**第三方系统并在 **门户应用页签层** 打开第三方系统的指定页面，然后用户可自由进行业务操作。
# 二、思路与方案
用户登录苍穹后，在系统门户首页的应用中心点击任何一个应用卡片，均会打开该应用的应用首页界面。但本案例需求是打开一个第三方系统页面，故我们可考虑将该应用的应用首页替换成第三方系统页面即可。
但我们通过分析在门户首页应用中心点击应用卡片打开其首页界面的底层实现逻辑（**MyAppAbstract.itemClick(ItemClickEvent) → MyAppAbstract.gotoApp(JSONObject, GoAppEnum, String) → OpenPageUtils.openApp(String, String, Map<String, Object>, IFormView, String) → OpenPageUtils.openAppPage(String, Map<String, Object>)**）可知，代码中一定要用到被打开的页面（即应用首页）的视图模型，如果我们直接将应用首页替换成第三方系统页面，该页面在苍穹平台中并没有一个视图模型（即：IFormView）。
因此我们可考虑将第三方系统页面通过IFrame控件嵌套在空白动态表单中，这样即可通过该动态表单的视图模型IFormView来达到最终目的。但如果采用该方案，我们还需在代码取消打开该应用默认的应用界面，转而打开动态表单页面，这个过程较繁琐，我们可直接在应用首页页面上预置IFrame控件，并将其绑定第三方系统页面的URL，且隐藏掉该应用首页上的其他控件，从而实现用户点击应用卡片后自动打开第三方系统页面。
# 三、实现过程
## 3.1 准备工作
苍穹系统：http://172.20.14.30:8080/ierp
第三方系统：本案例以另一套苍穹环境进行模拟，其访问地址：http://172.20.240.133:8080/ierp
统一身份认证服务系统：https://api.kingdee.com
## 3.2 注册应用
与知识 [苍穹应用卡片触发 | 在新浏览器窗口打开第三方带会话信息页面 ](https://vip.kingdee.com/article/519536360827567360?productLineId=29&isKnowledge=2) $3.2节一致，请自行查阅原文内容。
## 3.3 在苍穹系统中开发单点登录金蝶云平台插件（CldPlatformSSOPlugin）
与知识 [苍穹应用卡片触发 | 在新浏览器窗口打开第三方带会话信息页面 ](https://vip.kingdee.com/article/519536360827567360?productLineId=29&isKnowledge=2) $3.3节一致，请自行查阅原文内容。
## 3.4 二开干预应用首页界面展示第三方系统页面（TrdSysPageFormPlugin）
### 1.在被点击的应用的应用首页设计器中，新增IFrame控件，并调整样式属性（扩展比率设置为1），其设计器界面如下图所示
*备注：
应用首页设计器中其它不需要的控件，在控件树分支顶层节点（即：Flex控件/flexpanelap）的可见性去掉“初始可见”即可。*
### 2.在应用首页中注册表单插件（TrdSysPageFormPlugin），为上一步中IFrame控件绑定第三方系统页面URL
```language
@Override
public void afterBindData(EventObject evt) {
String trdSysTargetUrl = null;
try {
trdSysTargetUrl = OpenTrdPageUtils.getTrdSysTargetUrl(false);
} catch (Exception e) {
this.getView().showMessage(e.getMessage());
}
// 为IFrame控件设置URL
IFrame iFrame = this.getView().getControl(KEY_IFRAME_TRDSYSPAGE);
if (StringUtils.isNotEmpty(trdSysTargetUrl)) {
iFrame.setSrc(trdSysTargetUrl);
}
super.afterBindData(evt);
}
```
## 3.5 （单点登录第三方系统并）返回待打开页面的URL（OpenTrdPageUtils）
与知识 [苍穹应用卡片触发 | 在新浏览器窗口打开第三方带会话信息页面](https://vip.kingdee.com/article/519536360827567360?productLineId=29&isKnowledge=2) $3.6节一致，请自行查阅原文内容。
## 3.6 在第三方系统中开发单点登录金蝶云平台插件（CloudPlatformSSOAuth）
与知识 [苍穹应用卡片触发 | 在新浏览器窗口打开第三方带会话信息页面](https://vip.kingdee.com/article/519536360827567360?productLineId=29&isKnowledge=2) $3.7节一致，请自行查阅原文内容。
# 四、效果图
## 4.1 登录苍穹系统
## 4.2 苍穹门户首页
### 1.旧版门户首页
### 2.新版门户首页
