泛微Ecology9二次开发全攻略指南(精华)

泛微Ecology9作为一款领先的OA系统，以其强大的功能和灵活的扩展性赢得了众多企业的青睐。然而，企业在实际应用中往往需要进行二次开发，以满足特定的业务需求。那么，如何深入掌握泛微Ecology9的二次开发技术呢？本篇文章将为您详细讲解，并提供丰富的开发技术资源下载，助您快速提升技能。

点击下载(开发技术资源)

一、泛微Ecology9二次开发概述

泛微Ecology9提供了丰富的API接口和开发工具，支持多种编程语言，能够实现高度定制化的业务流程和功能扩展。二次开发的主要内容包括：表单定制、流程设计、接口集成、报表开发等。

1. 表单定制

表单是泛微Ecology9中承载数据的基本单位，通过定制表单，企业可以灵活地定义各种业务数据的录入和展示方式。

2. 流程设计

流程是业务逻辑的核心，泛微Ecology9支持图形化流程设计工具，帮助开发者快速构建复杂的审批流程和工作流。

3. 接口集成

通过API接口，泛微Ecology9能够与其他系统进行数据交互，实现系统间的无缝集成。这是二次开发中非常重要的一环。

4. 报表开发

报表是企业数据分析和决策的重要工具，泛微Ecology9支持自定义报表开发，帮助企业从海量数据中提取有价值的信息。

二、开发环境搭建

要进行泛微Ecology9的二次开发，首先需要搭建开发环境。以下是基本的环境配置步骤：

安装Java开发工具（JDK）：泛微Ecology9基于Java平台开发，因此需要安装JDK。配置开发工具（IDE）：推荐使用Eclipse或IntelliJ IDEA进行开发，这些工具提供了强大的开发和调试功能。搭建泛微Ecology9服务器：安装并配置泛微Ecology9服务器，确保能够正常访问和使用系统功能。 E9后端环境搭建(IDEA) • 使用工具： ideaui 开发工具 • 步骤一：导入本地项目、 jdk • 步骤二：创建包 src 、并指定 src 为源文件包 • 步骤三：导入 jar 、 classbean ，并指定 src 编译后的文件位置 • 步骤四：配置 resin • 步骤五： Ideaui 优化配置开发环境搭建 -ideaui 工具

开发环境搭建 - 导入本地项目、 jdk 版本支持 1.7 、 1.8

开发环境搭建 - 创建 src • 创建 src 包，并指定为源文件，指定成功后会变色

开发环境搭建 - 后端 src 目录结构 • 代码需分层处理，可下载 demo 测试 • 代码仓库： ecology-9-demo: 泛微 e-cology 9.0 非标准开发模板仓库

快速启动说明

1、前端开发环境搭建（ecode代码编辑器）

请访问地址：https://e-cloudstore.com/doc.html?appId=b59e05ced89f43d69ed7d6bdb6c57140

2、后端开发环境搭建

请访问地址：https://e-cloudstore.com/doc.html?appId=84e77d7890a14c439590b37707251859#%E5%90%8E%E7%AB%AF%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA

开发环境搭建 - 导入 jar 、 classbean • 分别需要引入 ecology/WEB-INF/lib 、 resin/lib 、 classbean

开发环境搭建-指定 src 编译后的文件位置

开发环境搭建 - 配置 resin ， resin3.0 、 resin4.0 都支持，最好使用 4.0

E9开发环境搭建(后端)

修改配置文件resin.xml

1、修改配置‪Resin/conf/resin.xml文件的相关参数

• java 编译器路径 • 添加 -g 参数 , 表示 debug 程序可以看到参数值 • 配置 ecology 根路径

修改配置文件app-default.xml 1 、修改配置 ‪Resin\conf\app-default.xml 文件的相关参数 • 添加 source=“ src ” 表示源码来自 ecology/ src 目录下 • path=“ classbean ” 表示编译后的 class 文件放在此目录中

修改配置文件resin.properties

1、修改配置‪Resin\conf\resin.properties文件的相关参数

• 修改 OA 默认发布的端口为 8080

resin.exe启动OA项目

1、路径‪Resin\resin.exe

• 如果项目启动报 Unsupported major.minor version 52.0 。

需要升级JDK为1.8

• 如果项目启动报 java.lang.ClassNotFoundException : com.caucho.loader.SystemClassLoader 。

需要把resin.jar单独添加到环境变量中

批处理bat启动OA项目

1、路径‪ Resin\start.bat

• 可以动态指定 jdk 路径 • Pause 命令表示启动有错 , 控制台不关闭

初始化OA数据库

• 项目启动成功之后 , 访问首页默认跳转初始化数据库界面 • 数据库初始化成功之后 , 默认存在账号 sysadmin/1

登陆激活OA项目

1、登陆地址：http://localhost:端口/wui/index.html

• 用 sysadmin/1 进行 OA 登陆 • 验证码 :ecology\WEB-INF\ code.key 里面的文本内容 • 识别码 : 每台电脑的唯一编码，提供给泛微内部人员，提供 license 文件

OA项目导入开发环境

本次以myeclipse导入E9为例

• 新建 java 项目 • 导入 ecology 项目文件 • 导入依赖 jar 包和目录 (ecology/lib/*,resin/lib/*,ecology/ classbean ) • 集成 resin-web 容器 • 集成 JDK （不要使用 myeclipse 默认的 jdk ）

Ecology:项目根目录

• 源码目录 ecology/ src • 编译后的 class 文件目录 ecology/ classbean • Jar 包目录 ecology/WEB-INF/lib • 日志目录 ecology/log • 属性文件目录 ecology/WEB-INF/prop • OA 数据库信息 ecology/WEB-INF/prop/ weaver.properties • OA 启动配置文件 ecology/WEB-INF/web.xml

产品目录介绍-日志分类

• 线程日志 thread • 系统状态 status • sql 日志 sql • 内存日志 mem • 集成日志 integration • 人力资源导入日志 hrmImportLog • 数据库链接日志 conn

产品目录介绍-sql监听日志

使用场景

1、监听某张表的数据变化

2、反向查询，堆栈跟踪代码位置

3、监听某项操作对数据库的影响

开启sql监听

ecology/WEB-INF/prop/weaver_isSqlLog.properties

日志记录位置:ecology/sqllog/ecologysql

记录触select语句之外的其他所有sql日志

产品目录介绍-sql自动化升级

使用场景

1、升级包含有sql语句的，打包到oa系统，oa自动在数据库中执行这些脚本文件

文件目录

ecology/sqlupgrade

产品目录介绍-安全补丁包的日志

使用场景

1、升级过安全补丁包的客户,jsp页面的报错会记录在此

文件目录

ecology/WEB-INF/securitylog

产品目录介绍-安全补丁包的配置

安全补丁包的标准文件（总文件），存在升级被覆盖的风险

ecology/WEB-INF/weaver_security_rules.xml

自定义配置规则（拆分文件），不会被总部补丁包覆盖

ecology/WEB-INF/securityXML/*.xml

产品目录介绍-ws安全补丁包

使用场景

1、增加ws接口安全,进行管控

Webservice请求的白名单

/WEB-INF/securityXML/weaver_security_rules_for_ws.xml

<?xml version="1.0" encoding="UTF-8"?><root><webservice-list><webservice>/services/</webservice></webservice-list><webservice-ip-list><ip>10.</ip><ip>192.</ip><ip>127.0.0.1</ip><ip>localhost</ip></webservice-ip-list></root>