README.md

# O2OA : Java企业信息化系统

O2OA是基于J2EE架构，集成移动办公、智能办公，支持私有化部署，自适应负载能力的，能够很大程度上节约企业软件开发成本的基于AGPL协议开放源代码的企业信息化系统需求定制开发解决方案，对外提供专业的开发运维等技术服务。

![o2oa](https://static.oschina.net/uploads/space/2018/0918/200301_N9TG_3931542.png)

O2OA平台拥有流程管理、门户管理、信息管理、数据管理和服务管理五大核心能力。用户可以直接使用平台已有功能进行信息信息化建设，平台提供了完整的用户管理，权限管理，流程和信息管理体系，并且提供了大量的开发组件和开箱即用的应用，可以大大减化企业信息化建设成本和业务应用开发难度。


# 其主要能力如下：

流程管理：全功能流程引擎。基于任务驱动，开放式服务驱动，高灵活性、扩展性，事件定义丰富。包含人工、自动、拆分、合并、并行、定时、服务调用、子流程等功能。应用场景丰富，可轻松实现公文、合同、项目管理等复杂工作流应用。

信息管理：具有权限控制能力的内容管理平台。支持自定义栏目、分类，表格，表单，多级权限系统，能轻松实现知识管理、通知公司、规章制度、文件管理等内容发布系统。

门户管理：具体可视化表单编辑的，支持HTML直接导入的，支持各类数据源，外部应用集成能力的，所见即所得的门户管理平台。适用于实现企业信息化门户系统，可以轻松结合O2OA提供的认证设置与其他系统进行单点认证集成。

服务管理：可以在前端脚本的形式，开发和自定义web服务，实现与后端服务数据交互的能力。

数据中心：可以通过配置轻松实现数据透视图展示，数据统计、数据可视化图表开发等等功能。

智能办公：拥有语音办公、人脸识别、指纹认证、智能文档纠错、智能填表推荐等智能办公特色

移动办公：支持安卓\IOS手机APP办公，支持与企业微信和钉钉集成，支持企业私有化微信部署

开箱即用：O2OA还提供如考勤管理、日程管理、会议管理、脑图管理、便签、云文件、企业社区、执行力管理等开箱即用的应用供企业选择


# 产品特点\:

1. 代码全部开源，开发者可以下载源码进行任意，编译成自己的信息化平台。

2. 平台全功能免费，无任何功能和人数限制。

3. 支持私有化部署，下载软件安装包后可以安装在自己的服务器上，数据更安全。

4. 随时随地办公，平台支持兼容HTML5的浏览器，并且提供了原生的IOS/Android应用，并且支持钉钉和企业微信集成。

5. 高可扩展性，用户通过简单的学习后，可以自定义配置门户、流程应用、内容管理应用

更多的产品介绍、使用说明、下载、在线体验、API及讨论请移步至[http://www.o2oa.net/](http://www.o2oa.net/)


# 官方网站\:

开源主页 : https://www.oschina.net/p/o2oa

官方网站 : http://www.o2oa.net

Gitee : https://gitee.com/liyihz2008/O2OA

Github : https://github.com/o2oa/o2oa

脚本API：http://www.o2oa.net/x_desktop/portal.html?id=dcd8e168-2da0-4496-83ee-137dc976c7f6

O2OA开发相关教程天梯：https://my.oschina.net/o2oa/blog/3016363


# 最新版本服务器安装包下载[o2server_V4.1921]\:

windows 64Bit : http://download.o2oa.net/download/o2server_20190618172734_windows.zip

Linux 64Bit : http://download.o2oa.net/download/o2server_20190618172734_linux.zip

MacOS : http://download.o2oa.net/download/o2server_20190618172734_macos.zip

AIX : http://download.o2oa.net/download/o2server_20190618172734_aix.zip

中标麒麟（龙芯）：http://download.o2oa.net/download/o2server_20190618172734_neokylin_loongson.zip


# 官方网盘下载\:

百度云盘：https://pan.baidu.com/s/1oBQ1atXGyXdLaYE5uAqF1w   提取码: pnk9

腾讯微云：https://share.weiyun.com/5krUMjj


# 最新版本 v4.1921\:

[2019-06-18]新增功能：[流程引擎]新增通过配置设置是否要删除无内容的空草稿。

[2019-06-18]新增功能：[流程引擎]新增获取我创建的工作数据接口。

[2019-06-18]新增功能：[流程引擎]新增获取我创建工作数据接口。

[2019-06-18]新增功能：[流程引擎]流程记录新增按活动、意见组、部门分组支持。

[2019-06-18]新增功能：[流程引擎]流程里增加驳回功能，流程结束后可以恢复到流转状态。

[2019-06-18]新增功能：[流程引擎]流程附件增加查看、下载、编辑权限的设置。

[2019-06-18]新增功能：[流程引擎]支持流程根据工作日志进行指定回滚。

[2019-06-18]新增功能：[流程引擎]新增自动删除草稿相关配置。

[2019-06-18]新增功能：[流程引擎]流程时效管理新增催办功能。

[2019-06-18]新增功能：[流程引擎]添加增加分支、流程回溯功能。

[2019-06-18]新增功能：[流程引擎]增加中抢办功能。

[2019-06-18]新增功能：[流程表单]流程表单增加新的皮肤样式。

[2019-06-18]新增功能：[流程表单]表单和页面创建、赋值、拖动组件时按Ctrl进行精确定位。

[2019-06-18]新增功能：[组织管理]增加委托授权相关设置。

[2019-06-18]新增功能：[内容管理]支持根据用户是否阅读查询发布的文档列表。

[2019-06-18]新增功能：[内容管理]支持根据文档ID列表判断后返回未读文档ID列表。

[2019-06-18]新增功能：[内容管理]添加文档访问次数，支持视图查询访问次数 viewCount，添加最后内容修改时间 modifyTime。

[2019-06-18]新增功能：[消息提醒]新增加模块x_message_core_entity，x_message_assemble_communicate"

[2019-06-18]新增功能：[图片识别]增加图片识别文本修改功能。

[2019-06-18]新增功能：[操作系统]支持中标麒麟操作系统：中标麒麟高级服务器操作系统软件（龙芯64位）。

[2019-06-18]新增功能：[数据库连接]支持国产人大金仓KingbaseES8数据库。

[2019-06-18]新增功能：[移动办公]AndroidH端新增H5网页文件选择能力的支持。

[2019-06-18]新增功能：[移动办公]IOS端新增蓝色主题。

[2019-06-18]新增功能：[移动办公]移动端支持表单控件图片编辑器。

[2019-06-18]新增功能：[移动办公]移动端工作界面支持可扩展操作按钮。

[2019-06-18]新增功能：[移动办公]移动端新增常用设备管理。

[2019-06-18]新增功能：[移动办公]新增O2OA移动端JSAPI，通知模块、日期，日历选择模块、导航栏工具模块、设备信息模块。

[2019-06-18]新增功能：[平台版本]新增中标麒麟龙芯版本。

[2019-06-18]系统优化：[服务器控制台]修改图片识别默认设置。

[2019-06-18]系统优化：[流程引擎]自动过滤第一条提醒消息。

[2019-06-18]系统优化：[流程引擎]更新通过API获取workContext中的待办排序，保持与前台一致。

[2019-06-18]系统优化：[流程引擎]work增加当前处理人的显示字段manualTaskIdentityText。

[2019-06-18]系统优化：[流程引擎]workLog增加group字段。

[2019-06-18]系统优化：[流程引擎]workLog增加opinionGroup字段。

[2019-06-18]系统优化：[数据库支持]增加人大金仓V8的支持。

[2019-06-18]系统优化：[数据库连接]由应用管理连接池改为jndi管理resource连接池，连接数需求大幅下降。

[2019-06-18]系统优化：[消息提醒]废弃模块x_collaboration_assemble_websocket，x_collaboration_service_message，x_collaboration_core_entity，x_collaboration_core_message"

[2019-06-18]系统优化：[内容管理]优化源码调exception目录结构。

[2019-06-18]系统优化：[内容管理]支持栏目和分类别名修改。

[2019-06-18]系统优化：[内容管理]优化栏目和分类更名处理逻辑，使用队列提升处理性能。

[2019-06-18]系统优化：[内容管理]优化删除文档过程，降低内存占用。

[2019-06-18]系统优化：[内容管理]优化平台启动过程，大幅提高平台启动速度。

[2019-06-18]问题修复：[流程引擎]召回时会删除办理时间。

[2019-06-18]问题修复：[神经网络]修正神经网络无法删除的bug。

[2019-06-18]问题修复：[数据统计]视图中选择'周'无效。

[2019-06-18]问题修复：[数据库支持]人大金仓ES8数据库boolean读取错误的bug。

[2019-06-18]问题修复：[用户管理]修复管理员被锁定的bug。

[2019-06-18]问题修复：[内容管理]修复栏目更名引起的内存溢出问题。

[2019-06-18]问题修复：[内容管理]修复创建文档时标题超长的问题（截取70字）。

[2019-06-18]问题修复：[H5移动端界面]修正H5界面展示错误。

[2019-06-18]问题修复：[平台功能]其他已知问题的修复。


# 配置编译环境\:

强烈建议将项目Fork到自己的仓库里，Clone到本地后进行编译和打包，偶尔会发现下载zip文件后，commons/ext目录里的jar包不可用，全部只有1k大小。

下载源码建议安装 git lfs，然后 Clone, 这样获取的源码可以编译。https://github.com/o2oa/o2oa 仓库里的源码已经编译打包测试通过，无任何问题。



## 安装NodeJS

1、访问nodejs的官方网站的downdolad，网址：https://nodejs.org/en/download/，获取Linux Binaries (x64)安装包下载链接：

      wget https://nodejs.org/dist/v10.15.0/node-v10.15.0-linux-x64.tar.xz

2、解压安装：

	# yum search xz
	# yum install xz.i386
	# xz -d node-v10.15.0-linux-x64.tar.xz
	# tar -xf node-v10.15.0-linux-x64.tar
	# mv node-v10.15.0-linux-x64 node-v10.15.0

3、配置nodejs（略）

## 安装 Java8 及配置Java环境 

    略
	
## 安装 apache-maven-3.6.0 及配置maven环境 

    wget http://repos.fedorapeople.org/repos/dchen/apache-maven/epel-apache-maven.repo -O /etc/yum.repos.d/epel-apache-maven.repo
	
    yum -y install apache-maven
	
	
## 安装 apache-ant-1.10.5 ant 	

    yum -y install ant
    

# 源码编译

1、打开命令提示工具，cd到o2oa/o2server目录

    cd /usr/o2oa/o2server

2、执行命令进行编译：mvn install，开始进行源码编译

    mvn install

3、打包安装程序： ant

    ant

## 关于编译错误
第一次使用maven进行项目编译执行 mvn install 可能会发生异常，原因是编译生成的META-INF/persistence.xml来不及加载。这种情况下，您可以再执行一次mvn install即可完成对项目的编译。

[ERROR] Failed to execute goal org.apache.openjpa:openjpa-maven-plugin:3.0.0:enhance(enhanncer) on project x_base_core_project: Exception enhancer of goal org.apache.openjpa:openjpa-maven-plugin:3.0.0:enhance failed: MetaDataFactory could not be configured (conf.newMetaDataFactoryInstance() returned null). This might mean that no configuration properties were fount. Ensured that you have a META-INF/persistence.xml file, that it is  available in your classpath, or that the properties file you are using for configuration is available. If you are using Ant, please see the <properties> or <propertiesFile> attributes of the task's nested <config> element. This can also occur if your OpenJPA distribution jars are corrupt, or if your security policy is overly strict. 

-> [Help 1][ERROR]......

如果在编译的时候遇到上述错误，直接重新再 mvn install 就可以了。

## 关于编译打包结果

o2oa/o2server/target目录下会有打包好的zip包，将此zip包Copy到其他目录解压（避免目录层级太深造成启动异常），然后启动服务即可。

服务器部署和启动相关的教程文档，请移步系列教程：https://my.oschina.net/u/3931542/blog/2209110


# 服务器部署

## 部署教程

开源中国技术博客：https://my.oschina.net/u/3931542

## windows部署步骤：

1.下载o2server_yyyyMMddHHmmss_windows.zip程序包。

2.解压下载后的压缩包到任意目录。

3.确认开通服务器的80、20020、20030端口。

4.打开o2server文件夹，选择start_windows.bat双击打开。

5.在命令行中输入"start" 回车,启动服务,等待相关服务启动完成。

6.启动完成后打开浏览器访问http://127.0.0.1。

7.输入用户名xadmin密码o2登陆系统。