在前面的章节中,我们介绍了两种在O2OA中使用React开发应用的方式,已经可以满足绝大多数的情况了。如果您考虑完全脱离O2的web服务器,自己搭建web服务器,那就请阅读本章。
  我们还是使用React的Create React App工具,创建React应用,然后将O2OA集成到应用中,并实现以下功能:列示当前用户的前20条待办,点击标题打开待办;通过点击按钮启动流程和打开主页。

版本要求

本文适用于如下版本:

  • O2OA版本要求:5.1及以上版本;
  • React版本:本文撰写时,react版本是16.13.1。(更低的版本未经验证)

    前提

  • 开发端安装了Node.js,Node >= 8.10, npm >= 5.6

  • 有一台O2服务器(并不需要启动webServer,但其他服务需要正常启动)
  • 使用合适的开发工具:WebStorm、VSCode、Atom等(本例使用WebStorm)

创建React应用

您可以使用WebStorm创建一个新的React App,如下图:
image.png
或者创建一个空项目,然后使用以下命令创建React应用:

npx create-react-app my-app
cd my-app


创建后目录结构如下:
image.png

添加O2平台web脚本

  将O2服务器的webServer下的所有文件夹拷贝到public目录:image.png
在public/index.html的head中添加O2脚本引入:

<script src="../o2_core/bundle.js">script>


修改public/x_desktop/res/config/config.json文件:

{
    "center": [
    {
      "port": "20030",        //O2服务器中心服务器端口
      "host": "develop.o2oa.net"    //O2服务器中心服务器Host
    }
  ],
  "applicationServer": {
    "host": "develop.o2oa.net"    //O2应用服务器Host
  },
  "initManagerChanged": true,
  "initManagerName": "",
    ...
}

此文件主要修改两部分内容:
1、center部分,修改为要访问的O2中心服务器地址和端口;
2、applicationServer部分,修改为要访问的O2应用服务器地址,如果没有applicationServer,就添加一个。集群环境下,可配置应用服务器负载地址;

为了方便后续引入,我们在src下创建一个o2.js,添加以下代码:

let o2 = window.o2;
let layout = window.layout;
export {o2, layout};


自此以后,所有的过程都和第二章基本一样了。

修改inde.js

修改src/index.js文件如下:

import React from 'react';
import ReactDOM from 'react-dom';
import './index.css';
import App from './App';
//获取O2全局对象
import {o2, layout} from './o2';

//在O2平台脚本载入完成后执行
layout.addReady(function(){
    layout.app = true;
      //通过平台服务,获取当前用户的前20条待办(可通过http://your-server:20030/x_program_center/jest/list.html查询平台接口服务)
    o2.Actions.load("x_processplatform_assemble_surface").TaskAction.V2ListPaging(1,20, {}, function(json){
        //React渲染App组件
          ReactDOM.render(
            <React.StrictMode>
                <App value={json.count} data={json.data}>App>
            React.StrictMode>,
            document.getElementById('root')
        );
    });
});

layout.addReady 方法会在O2载入完成后执行回调方法。
o2.Actions.load 方法可以调用平台的Restful服务。

修改App组件

先修改src/App.css样式文件,拷贝以下代码:

.App {
  padding: 20px;
  margin: 20px;
}
.App-header {
  padding: 5px 10px;
  background: #0f81cc;
  font-size: 18px;
  color: #ffffff;
}

.o2-tasklist {
  padding: 10px;
  background: #f3f3f3;
  font-size: 18px;
}
.o2-task {
  line-height: 30px;
  height: 30px;
  cursor: pointer;
}
.o2-button {
  padding: 10px 20px;
  text-align: center;
  background: #0f81cc;
  margin-top: 10px;
  color: #ffffff;
  font-size: 18px;
  float: left;
  margin-right: 20px;
  cursor: pointer;
}

修改src/App.js文件如下:

import React from 'react';
import './App.css';
//获取O2全局对象
import {o2, layout} from './o2';

function App(props) {
    function openHomepage(){
            //通过O2全局对象layout的openApplication方法打开主页"Homepage"
        layout.openApplication(null,"Homepage")
    }
    function openTask(id){
          //通过O2全局对象layout的openApplication方法打开待办
        layout.openApplication(null,"process.Work", {"workId": id});
    }
    function startProcess(){
          //通过o2.env对象启动流程
          //o2.env对象即是在O2门户页面的脚本中的this指向,可以使用其方法。
          //请将“application-name”和“process-name”修改为您的流程应用名称和流程名
        o2.env.page.startProcess("application-name", "process-name");
    }

    function listTask(){
        let list = [];
        props.data.each(function(d){
            list.push(<div className="o2-task" onClick={()=>{openTask(d.work)}}>{d.title || "无标题"}div>);
        });
        return list;
    }

    return (
        <div className="App">
            <header className="App-header">
                <p>
                    您有{props.value}个待办
                p>
            header>
            <div className="o2-tasklist">
                {listTask()}
            div>
            <div className="o2-button" onClick={startProcess}>点击此处启动流程div>
            <div className="o2-button" onClick={openHomepage}>点击此处打开O2首页div>
        div>
    );
}

export default App;

  上述代码创建了一个React组件,列示了待办列表,并创建两个div,点击后分别启动指定的流程,打开主页。

  App.js中,我们使用了o2.env对象,这个对象和在门户页面脚本中的this指向一致,可以调用除了与门户页面组件相关方法以外的各种方法,如:o2.env.page.openWork、o2.env.inculde、o2.env.confirm、o2.env.page.startProcess等,详细内容可以参考API文档。

编译并运行

  我们完成了上述开发工作,就可以编译并运行我们的应用了。使用以下命令来查看结果:

npm run start

  运行后,会启动一个web服务器,默认端口3000,并自动打开浏览器,访问http://locahost:3000,就可以看到和第二章一样的效果了。
  如果您未登录到服务器,会出现登录页面,登录后就可以看到登录人的待办列表,并可以启动流程了。image.png
  登录后:
image.png
您可以接着修改代码,每次修改保存后,React会自动编译,并刷新浏览器,及时看到修改效果。

开发完成后,可使用命令:

npm run build

React会在将所有的代码编译到build目录下,你就可以将build中的内容部署到任意的web服务器了。

总结

  O2OA和React的集成还是非常方便的,对于熟悉React的用户,可以通过更多更灵活的工具来进行集成开发,更多有关React的内容请参考React官网教程。
  对于VUE和Angular和O2OA的集成,我们将在后面的章节为大家介绍。

推荐文章:

系统架构-基于nginx快速集群部署-上下文分发
2021-02-26
O2OA平台使用分布式架构设计,提供灵活的扩展方案用于对服务器的负载能力进行扩展,保障系统的高可用性。本篇主要介绍如何基于nginx上下文分发的方式快速集群部署
连接O2云体验APP移动手机办公
2021-02-25
O2OA拥有配套的移动办公APP,支持IOS和安卓端,用户可在连接O2云之后,使用APP使用移动办公。移动办公APP开放源代码,不会产生任何费用。本篇主要简单讲
系统配置-自定义消息提醒
2021-02-25
O2OA平台设计了灵活的消息提醒数据交互方式,开发者可以根据自己的需要,来消费消息提醒数据,也可以将消息提醒数据接入到Kafka消息中间件来实现消息的准实时提醒
信息栏目-新建信息发布流程
2021-03-01
O2OA提供的信息管理功能可以帮助用户快速地配置信息发布栏目,如通知公告,公司动态,规章制度等。用户可以高效地完成信息栏目和配置。本文主要介绍如何在O2OA中为
开发知识-Vue篇:在O2门户页面中使用Vue
2021-02-07
  在O2OA门户页面中使用Vue非常容易,本章我们介绍两个实例,来展示如何在门户页面中使用Vue。版本要求本文适用于如下版本:O2OA版本要求:5.1及以上版
用车管理使用手册
2021-03-16
O2OA平台应用市场提供了用车管理模块,用户可以直接从应用市场下载并安装模块,满足企业用车管理相关关的业务需求。本文主要介绍用车管理的下载安装以及设计相关说明
系统配置-服务器端口冲突和端口修改
2021-02-25
在安装O2OA的服务器上很可能已经启用了IIS、apache或者nginx等服务器,已经有其他的应用或者web站点正在运行中,所以O2OA启动所需要的80端口已
平台服务器下载及安装部署-Windows系统
2021-02-25
O2OA信息化系统开发支持公有云,私有云和混合云部署,也支持复杂的网络结构下的分布式部署。O2OA开发平台安装部署非常方便,只需要简单的三步即可完成安装。平台内
移动办公-将O2OA接入到微信公众号
2021-03-17
O2OA平台拥有配套的原生开发的安卓和IOS移动APP,目前O2OA已经支持微信公众号的集成,用户可以通过关注微信公众号进行工作处理。并且支持待办工作的消息提醒
快速入门-服务器总体介绍汇总
2021-02-07
一、服务器目录介绍二、服务器组成结构三、服务器所占端口四、微服务API五、服务内置对象(方便二次开发、实现2小时一个流程目标)六、架构图

results matching ""

    No results matching ""