泛微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>