门户开发-组件介绍-平台应用-门户管理-O2OA企业应用开发平台-人人都是协同系统开发专家

门户开发-组件介绍-平台应用

时间：2023-03-20

内容导读

本篇说明 O2OA 平台门户设计器中的平台应用组件，可把现有业务应用或自研前端模块嵌入门户页面。既能在下拉列表直接选择应用，也能用脚本返回应用路径，并通过 status 与 options 传入栏目标识和初始化参数。调试时要留意路径需从运行界面的地址栏或前端源码中确认，参数名与取值格式必须匹配，缺失时往往导致嵌入内容空白，必要时可用重载方法刷新嵌入对象。

O2OA 平台具备门户页面定制与集成能力。通过门户定制，可根据企业的文化与业务需求，设计符合企业需要的统一信息门户、系统首页等 UI 界面。本篇介绍页面设计器元素组件中的平台应用组件。

一、先决条件

1、O2Server 服务器正常运行，系统安装部署请参考文档《如何在服务器上安装部署 O2OA》

2、使用具有管理员权限或门户管理员（PortalManager角色）的用户账号登录 O2OA 平台，如：xadmin

3、可以进入门户管理平台并且有开发权限，请参考《门户开发-门户设计开发入口和权限说明》

二、平台应用组件

平台应用组件可以直接将当前 O2OA 平台已有的应用作为一块内容放入门户页面，也可以是自行开发的前端模块，例如使用 VUE 开发的一个功能页面。

三、平台应用属性

平台应用特有的基本属性如下：

属性	描述	备注
选择应用	从现有应用下拉列表中选择一个应用插入到页面中
计算应用路径	通过脚本计算，返回需要插入到页面的应用打开路径	比如要嵌入内容管理的具体栏目，由于栏目打开需要带 id，在系统部署中是找不到的。这个时候就需要在脚本中返回栏目路径 `return "cms.Module"` 路径的查找如下：在平台中打开应用，然后双击“标题栏”。如：在新窗口地址栏中的 app 参数就是对应路径：
应用 status	可以通过固定值或脚本的方式给应用传递 status 状态	比如要嵌入内容管理的具体栏目，由于栏目打开需要带 id，这个时候我们可以通过 status 参数传入 id。如： `{"columnId":"35fd5077-3316-415f-8b8c-2b4591e6b181","categoryId":"whole"}`
应用 options	可以通过固定值或脚本的方式给应用传递 options 参数	options 参数是应用的一些初始化参数。 options 的查找，如查找“内容管理栏目”的 options 参数。打开源代码：o2web/source/x_component_cms_Module/Main.js 在类“Main”中找到 options 参数

四、应用平台事件

除了 DOM 事件之外，应用平台的系统事件如下：

事件名	描述
queryLoad	元素被载入之前执行
load postLoad	元素被载入之后执行
queryLoadApplication	平台应用被载入之前执行

五、应用平台方法

应用对象可通过以下脚本获取：

var el = this.page.get(name); //name为应用平台的标识

获取的对象可使用以下方法：

方法名（属性）	用法	描述
show	el.show()	显示元素
hide	el.hide()	隐藏元素
addEvent	el.addEvent(name, fun)	给元素绑定系统事件。 name：事件按名称 fun：执行的方法
node	var dom= el.node	获取 html 原生 Dom 对象
reload	el.reload()	重新加载嵌入对象

以上是门户设计器中应用平台组件的简要说明，关于门户页面开发的更多介绍，请参考以下文章：

《门户开发-门户设计开发入口和权限说明》