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

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

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

一、泛微Ecology9二次开发概述

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

1. 表单定制

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

2. 流程设计

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

3. 接口集成

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

4. 报表开发

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

二、开发环境搭建

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

1. 安装Java开发工具（JDK）：泛微Ecology9基于Java平台开发，因此需要安装JDK。
2. 配置开发工具（IDE）：推荐使用Eclipse或IntelliJ IDEA进行开发，这些工具提供了强大的开发和调试功能。
3. 搭建泛微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>

三、二次开发实例讲解

1. 表单定制实例

以一个请假申请表单为例，我们需要在泛微Ecology9中创建一个自定义表单，包含以下字段：申请人、请假类型、开始时间、结束时间、请假理由。

步骤：

1. 登录系统，进入表单管理模块。
2. 创建新表单，定义表单名称和字段。
3. 配置字段属性，如必填项、数据校验等。
4. 保存并发布表单，即可在系统中使用该表单。

2. 流程设计实例

基于上述请假申请表单，我们需要设计一个请假审批流程，包括申请、部门经理审批、人事审批三个环节。

步骤：

1. 进入流程设计器，新建流程。
2. 添加流程节点，分别设置申请、部门经理审批、人事审批节点。
3. 配置节点属性，定义每个节点的审批权限和操作。
4. 绘制流程图，连接各个节点，形成完整的审批流程。
5. 保存并发布流程，即可在系统中使用该流程。

3. 接口集成实例

我们需要将泛微Ecology9中的请假数据同步到HR系统，通过API接口实现数据的自动传输。

步骤：

1. 获取泛微Ecology9 API文档，了解相关接口的调用方式。
2. 编写接口代码，在泛微Ecology9中调用HR系统的API接口，实现数据同步。
3. 测试接口，确保数据能够正确传输和接收。

4. 报表开发实例

我们需要开发一份请假统计报表，统计各部门的请假情况，并进行数据分析。

步骤：

1. 进入报表设计器，新建报表。
2. 定义报表数据源，选择请假数据表。
3. 设计报表布局，添加统计图表和数据分析组件。
4. 配置报表参数，如时间范围、部门筛选等。
5. 保存并发布报表，即可在系统中查看和分析数据。

超全面的技术全攻略讲解:

提供日常开发的案例代码实现：

四、开发资源下载

为了帮助您更好地进行泛微Ecology9二次开发，下载资源文档提供了丰富的开发资源下载，包括：示例代码、开发文档、视频教程等。您可以点击以下链接进行下载：

点击下载

https://pan.baidu.com/s/18xOCxt74muw7DB7r6Pnryg?pwd=abcd

提取码: abcd