本篇围绕 O2OA 平台门户开发快速入门展开,说明如何借助门户管理系统搭建符合企业需要的门户页面。文中先交代登录平台所需的权限条件,再概述门户管理的用途,接着按创建门户应用、创建页面、使用数据源组件、添加样式、增加新闻列表等顺序,逐步完成待办列表与新闻列表的呈现,并通过脚本把固定请求地址参数化,实现列表翻页。收尾处提醒读者,页面外观虽显简陋,但已覆盖设计器各区域、组件属性、样式与脚本等基本操作。
O2OA 平台拥有门户页面定制与集成的能力,平台通过门户定制,可以根据企业的文化和业务需要,设计符合企业需要的统一信息门户、系统首页等 UI 界面。本篇主要介绍如何通过门户管理系统快速搭建开发一个门户页面,并带您认识门户开发界面上的一些基础元素。
1、O2Server 服务器正常运行,系统安装部署请参考文档《如何在服务器上安装部署 O2OA》
2、以拥有管理员权限或拥有门户管理员(PortalManager角色)的用户账号登录 O2OA 平台,如:xadmin
3、可以进入门户管理平台并且创建门户应用,请参考《门户开发-门户设计开发入口和权限说明》
O2OA 平台是一个可定制的应用开发平台,可以通过门户平台搭建一个符合企业个性化需求的系统。所有设计开发都在浏览器端进行,您无需安装任何额外的软件和插件。那通过这篇文章我们可以看看通过我们的门户平台如何快速搭建一个门户实例。
本文将通过以下步骤开发实现一个门户:
创建一个门户应用
创建一个门户的页面,在页面中展现一个待办列表。
美化页面,添加样式。
在页面中增加一个新闻列表。
添加脚本,增加翻页功能。
最后实现的效果图:
首先打开门户管理应用,点击右上角的新建门户按钮,在弹出窗口中填写门户名称,该名称需要在门户管理中唯一,不可重名。
点击 完成 后,我们会看到一个门户应用被创建成功了,如下图所示:
点击并打开门户应用,默认进入页面配置视图。新创建的门户应用没有页面,我们可以点击左上角的新建页面按钮,系统将会为我们创建一个页面,点击并打开这个页面的设计器,如下图所示:
页面设计器分为组件列表、页面工具栏、页面设计区、页面元素区以及页面属性区,如下图所示:
在页面属性区,在基本标签中,把页面的名称设置好,如下取名为 “首页”,如下图所示:
修改完成后,点击设计器左上角的保存按钮。
在页面设计器中,从组件列表拖动一个“容器”控件到页面设计区,再拖动两个“文本”控件到容器中。
点击第一个“文本”组件,在属性区将值设为“固定值”,内容为“待办列表展示”,此设置会将文本控件的显示内容设定为“待办列表展示”,如下图所示:
点击第二个“文本”组件,在属性区将值设为“脚本”,并在脚本区域中输入以下内容:
return this.session.user.name
此设置将使第二个文本控件显示当前用户的名称。
在组件区拖动一个“数据源”控件到容器中,再拖动一个“子数据源”控件嵌套到该数据源控件中。
最后,我们拖动一个“数据文本”控件嵌套到子数据源中。如下图所示:
在右上方的页面元素区可以看到整个页面的 DOM 元素结构树,如下图所示:
接着配置数据源,让页面通过数据源自动获取当前用户的待办信息列表。
在页面设计区选中数据源控件,在属性区切换到“数据源”标签,配置如下信息:
方法:POST(数据源使用 restful 方式获取数据,获取待办列表的接口使用 POST 方法);
服务应用:流程(系统提供的 restfulAPI 的应用)
路径:/jaxrs/task/v2/list/paging/1/size/20(获取待办的请求地址,系统内的固定写法)
我们可以通过 http://centerserver:80/x_program_center/jest/list.html 来查询到所有的服务应用和请求地址。OpenAPI 的查询方法请参考《服务端 OpenAPI 接口查询方法》
然后点击“测试”查看获取到的数据(注意当前登录用户是否有待办数据),如下图所示:
现在数据源已经可以获取到需要展示的数据,接下来需要将获取到的数据展示出来。
系统中所有接口都返回 JSON 格式的数据。根据上面点击“测试”所得到的结果可以看出,返回数据中的 data 字段是一个数组,真实的待办列表数据就存放在这里。接下来要显示的就是 data 中的数据,因此需要通过子数据源遍历 data 内容。
选中“子数据源”,在属性区将其 JSON 路径配置为 data,如下图所示:
在子数据源遍历数组中每个对象的过程中,需要在文本控件中展示相关内容,让用户看到实际的业务数据。数据源测试时,展开数组中的每个对象都能看到完整数据,其中 title 属性存放的是每个待办的标题信息,因此可以选中子数据源内的“数据文本”,并将其 JSON 路径配置为 title,如下图所示。
保存当前页面,点击工具栏上的预览按钮,我们可以看到效果如下:
通过预览,我们可以看到效果如下:
由于还没有添加任何样式,页面看起来比较简陋。展示结果符合预期:第一行是前面设置的固定文本,第二行是当前登录用户,之后是待办 title 列表。
回到页面设计界面:
1)选中最外层的“容器”组件,在属性区的样式中配置如下信息:
{
"width": "90%",
"margin": "auto"
}2)选中第一个文本组件,设置样式如下:
{
"font-size": "24px",
"font-weigth": "bold",
"line-height": "60px",
"text-align": "center"
}3)选中第二个文本组件,设置样式如下:
{
"font-size": "18px",
"font-weigth": "bold",
"line-height": "40px",
"text-align": "center"
}4)选中数据文本控件,设置样式如下:
{
"line-height": "30px",
"border-bottom": "1px solid #cccccc"
}保存当前页面,点击工具栏上的预览按钮,我们可以看到效果如下图所示:
前面实现的内容只包含一个待办列表,比较单一。门户首页需要更丰富的内容,因此接下来为界面增加一个新闻列表,获取系统内信息发布的内容并以列表形式展现。
在设计区再拖出一个“容器”组件到页面上,然后把原先页面上最外层的容器拖入这个新建的“容器”中:
这里用到了门户编辑器中的组件移动功能,旁边还有几个小按钮,分别是复制选中内容、删除选中内容、把选中内容提取为部件。
然后调整样式:为最外层的容器添加如下样式:
{
"width": "1066px",
"margin": "auto",
"display": "flex",
"justify-content": "space-between"
}第二层容器(原有的最外层容器)的样式:
{
"width": "676px"
}
然后再拖入一个容器,用来存放新闻列表,如下图所示:
{
"width": "318px",
"align-self": "flex-start"
}
接下来与上面的待办列表一样,添加数据源、子数据源和数据文本,并填入数据源路径等内容。
不同的是,新闻列表查询的是内容管理模块的数据:
/jaxrs/document/filter/list/1/size/20
子数据源仍然是遍历data数组,数据文本解析的属性仍然是title,如下图所示:
还是保存当前页面,点击工具栏上的预览按钮,效果如下图所示:
从界面观感上看,还应该给新闻列表加一个标题。
继续拖入一个“文本”组件,放到右侧新闻列表数据源上方,如下图所示:
然后再给这个文本组件添加样式:
{
"font-size": "24px",
"font-weigth": "bold",
"line-height": "60px"
}
展示新闻列表标题的数据文本也需要添加样式:
保存当前页面,点击工具栏上的预览按钮,整个页面的展示效果如下图所示:
下面以待办列表为例,为其增加翻页功能。
上面我们在待办的数据源中设置的路径为:/jaxrs/task/v2/list/paging/1/size/20;
其中的“1”表示要展现第一页的待办,“20”表示每页展现20条。
要实现翻页效果我们需要将固定的请求 URL 参数化。在这里我们设置两个参数:{page}和{size}分别代表当前页和每页条数。我们将数据源中设置的路径改为:/jaxrs/task/v2/list/paging/{page}/size/{size}
并且在数据源属性的“参数”中增加这两个参数。如下图所示:
其中的参数 {page} 和 {size} 需要通过脚本赋值,具体脚本稍后再说明。首先需要一个地方记录当前页码数、总共有几页等翻页信息,这可以用一个脚本来完成。
点击页面设计区空白处或点击元素列表区中的<Form>;,确保 Form 被选中,切换属性区到“事件”页,“事件”页内的就是页面加载的时候各个阶段会执行的事件。
需要在 queryLoad 事件或 beforeLoad 事件中添加可执行的脚本。点击“queryLoad”事件会出现脚本编辑区域,在其中添加如下脚本:
this.pageObj = {};this.pageObj.size = 20; //每页显示20条this.pageObj.page = 1; //当前是第1页this.pageObj.taskCount = 0; //待办总数//通过服务,获取当前人的待办总数o2.Actions.load("x_processplatform_assemble_surface").TaskAction.countWithPerson(this.session.user.id, function(json){ this.pageObj.taskCount = json.data.count;}.bind(this), null, false);var n = this.pageObj.taskCount/this.pageObj.size;this.pageObj.pagesize = (n.toInt()==n) ? n : n+1; //总共多少页//定义“下一页”方法this.define("nextPage", function(){ var p = this.pageObj.page+1; if (p<=this.pageObj.pagesize){ this.pageObj.page = p; var source = this.page.get("Source")//获取数据源组 source._getO2Uri();//刷新数据源路径 source.reload(); //刷新取数据源组件 }}.bind(this));//定义“上一页”方法this.define("prevPage", function(){ var p = this.pageObj.page-1; if (p>0){ this.pageObj.page = p; var source = this.page.get("Source")//获取数据源组 source._getO2Uri();//刷新数据源路径 source.reload(); //刷新取数据源组件 }}.bind(this));//定义跳转到第几页方法this.define("gotoPage", function(p){ if (p>0 && p<=this.pageObj.pagesize){ this.pageObj.page = p; var source = this.page.get("Source")//获取数据源组 source._getO2Uri();//刷新数据源路径 source.reload(); //刷新取数据源组件 }}.bind(this));拖动一个容器组件到页面(用于放置翻页按钮),在容器组件内添加两个按钮和一个下拉框,并将两个按钮的名称分别改为“上一页”和“下一页”,如下图所示:
并给新增的容器添加一点样式:
{
"display": "flex",
"justify-content": "center"
}
然后点击新增的下拉框组件,在属性中将“可选值”设为脚本,并在脚本框中输入如下代码:
var options = [];for (var i=1; i<=this.pageObj.pagesize; i++){ options.push(i+"|"+i);}return options; //返回可选的列表添加好之后的效果,如下图所示:
然后切换到下拉框属性的事件页签,在 change 事件中添加如下脚本:
//获取下拉框选中的值,select是下拉框的名称
var p = this.page.get("select").getData();
this.gotoPage(p);
给上一页按钮添加 click 事件脚本如下:
this.prevPage();
this.page.get("select").setData(this.pageObj.page);//设置下拉框的值
给下一页按钮添加 click 事件脚本如下:
this.nextPage();
this.page.get("select").setData(this.pageObj.page);//设置下拉框的值
回到待办列表数据源并选中它,切换到“数据源”属性页,为参数添加脚本。点击“page”参数,在脚本框中输入以下脚本:
return this.pageObj.page;
点击“size”参数,在脚本框中输入以下脚本:
return this.pageObj.size;
保存当前页面,再点击工具栏上的预览按钮查看显示效果:
至此,第一个门户实例就基本完成了。虽然页面看起来比较简陋,但整个开发过程已经接触到了门户设计器中的各项基本内容,包括设计器的各个区域、组件使用、组件属性设置、样式设置和脚本设置等。希望对您有帮助!
关于门户页面开发的更多介绍请参考以下文章:
《门户开发-门户设计开发入口和权限说明》《门户开发-快速入门开发一个门户实例》《门户开发-组件介绍-容器、通用元素》《门户开发-组件介绍-数据源、子数据源、数据文本》《门户开发-组件介绍-文本、图片、按钮》《门户开发-组件介绍-表格》《门户开发-组件介绍-iframe、HTML》《门户开发-组件介绍-嵌入视图、嵌入统计、嵌入查询视图》《门户开发-组件介绍-文本字段、多行文本、地址、组合框》《门户开发-组件介绍-人员组织》《门户开发-组件介绍-日期选择》《门户开发-组件介绍-下拉框、单选框、多选框》《门户开发-组件介绍-平台应用》《门户开发-组件介绍-数据表格》《门户开发-组件介绍-ElementUI 组件》《门户开发-组件介绍-部件、部件元素》
相关内容
下一篇:门户开发-门户属性说明