有关EAS-BOS二次开发各类问题(一)：基础介绍篇

有关EAS-BOS二次开发各类问题(一)：基础介绍篇原创

HN_刘敏

62人赞赏了该文章 856次浏览未经作者许可，禁止转载编辑于2024年12月20日 16:30:10

摘要由AI智能服务提供

本文介绍了金蝶EAS-BOS作为集成开发平台的核心地位，作者作为开发人员分享BOS二次开发（二开）的经验，包括环境搭建的解决方案和注意事项，如需求明确、遵循开发规范、代码质量控制、数据安全、全面测试等，并提供了客户端安装包的下载地址。

有用

反馈

首编于：2024年10月09日

关键词：BOS二开、基础介绍、BOS环境搭建、二开注意事项

前言：

金蝶 EAS-BOS 作为金蝶企业应用套件（EAS）的集成开发平台，为构建、定制以及扩展企业级应用系统提供了一整套完备的工具与框架。在整个 EAS 体系里，BOS 占据核心之位，向上能够有力地支撑诸如财务、供应链、人力资源等各类业务应用模块；向下则与数据库、操作系统等基础软件紧密交互，从而实现数据的妥善存储以及系统的稳定运行。

小编身为金蝶机构的一名开发人员，投身于 EAS-BOS 二次开发领域已然长达十年之久，对于诸多 BOS 二次开发问题基本都能迎刃而解。日常工作主要涵盖项目开发、各项目的运维支持以及月结事宜。本系列文章主要面向具备一定 JAVA 开发经验以及拥有数据库（oracle、sqlserver、mysql 等）脚本编写能力的开发人员。输出BOS二开常见问题系列文章的目的是为了帮助同样从事BOS二次开发人员，在遇到类似问题时，能快速定位解决问题，提高开发效率。本文主要涉及BOS环境搭建的一些小经验和二开的注意事项。

一、BOS环境搭建的一些小经验和解决方案

1、搭建BOS开发环境：

最开始肯定是要搭建BOS开发环境，那么可以了解客户所使用的EAS版本，从而知道我们应该下载哪个版本的BOS工具（虽说高版本一般会兼容低版本，但建议用同版本的工具），一般我们都可以在云之家的企业云盘中下载到https://pan.yunzhijia.com/index?appid=101091498&client_id=101091498&expire_time=1729674773329&msgShowStyle=31#/com/560823

2、BOS工具安装好之后，就是导入解决方案了，有两种方式：

1>可以从远程服务器直接导入，如下图

当导入时可能会提示如下图信息

解决方法：联系系统管理员，找到对应的EAS应用服务的管理控制台将BIM启动即可（不需要停服务哦，只需要将BIM启动即可）

用该种远程服务器直接导入的方式，可能会出现下载资源丢失的情况（一般就是sql包，语言包太大导致），处理方法，可以停掉服务，将比较大的几个包先备份删除，然后再导入，在导入成功后将这几个包再放回原路径下，同样的也要将这几个包放到自己的开发环境对应的目录下

2>从本地服务器导入，如下图：

处理方式：将服务器的server包打包拷贝下来放到自己的电脑上，然后解压,再用上面的从本地服务导入的方式（此种方式是比较稳妥的，但一般server包会有10几个G，需看下电脑空间够不够）

3、从服务器直接导入解决方案失败怎么处理，如下图：

解决措施：先备份服务器该路径下的文件，再删除，然后重新导入，导入成功后，将原该目录下的内容复制到对应的目录下（记得原服务器的内容在导入完成后，要记得还原）

4、导入解决方案时，从内网去拉外网报错，如下图：

分析是启用了防火墙，首先需要确认以上三个端口是否已开放，可以联系网管解决去处理。

5、数据中心连接失败：如下图

该问题首先收集 bos\BOSModular\platform\eclipse\bos.log日志，经检查报错如下图：

是网络不通或者防火墙等导致，1521为oracle数据库端口，可以联系网管解决

二、二次开发过程中我们需要注意的事项：

1、需求分析阶段

在承接一个项目时，需求分析与明确需求乃是关键之重。务必与业务部门展开充分沟通，深度洞察客户的业务流程与实际需求，确保所开发的功能能够切实有效地解决业务痛点。明确需求后，必须将详细需求整理成文档，并与客户以及项目相关人员进行确认签字。尤其是在需求变更时，更应如此处理，以免日后出现推诿扯皮的现象。

此外，需根据企业的战略目标与紧急程度，确定需求的优先级，进而合理规划开发进度。

2、开发过程阶段

a.熟悉系统架构
要深入熟悉 EAS-BOS 的系统架构。特别是在对标准单据进行二次开发时，切不可使用 BOS 工具对元数据进行修改，否则会对升级造成影响。通常情况下，对于标准单据的改造，我们会通过 dep 进行处理，或者直接采用写代码的方式。

b.遵循开发规范
应当严格遵循开发规范，涵盖代码风格、命名规范以及注释要求等方面。例如，新增的二开单据若为付款申请单，应命名为“paymentbill”，切勿使用拼音首字母如“fksqd”之类的难以解读的命名方式。对于新增字段，若为编码，则应命名为“number”，而不是使用中文拼音“bianma”。另外，强烈要求在编写代码时必须添加注释，否则后续的项目维护将极为困难。作为一名运维支持人员，每当看到几乎没有注释甚至一行注释都没有的代码，尤其是那种长达几千行的类时，着实令人头疼。

c.避免过度定制
在满足需求的前提下，应尽量减少对原系统的定制，以降低维护成本和升级难度。要基于我们的 BOS 框架进行开发。

3、代码实现方面

a.代码质量控制
编写高质量的代码，并进行充分的代码审查，以确保代码具有良好的可读性、可维护性和可扩展性。对于一些较为常用的代码，例如获取 dep 控件的方法，可以直接编写一个工具类，避免每次获取 dep 控件时都重复编写代码。在进行接口开发时，可将第三方的配置信息单独放在一个类中，这样当第三方进行修改时，只需修改该类即可，无需在每一个涉及该配置的地方都进行修改，从而提高开发效率。

b.数据安全考虑
在开发过程中，要充分考虑数据的安全性，采取适当的加密、权限控制等措施。例如，在开发接口时，要进行必要的信息校验，如登录接口。

4、测试与部署阶段

a.全面测试
进行单元测试、集成测试、系统测试等多种测试，确保二次开发的功能稳定可靠。

b.兼容性测试
测试新功能与原系统以及其他相关系统的兼容性，避免出现冲突。尤其要重点关注版本是否支持。

c.部署前准备
在部署前，做好数据备份、环境检查等准备工作，确保部署过程顺利进行。

小经验分享：通常情况下，测试人员在测试时会按照现有的业务场景进行操作测试，因此可能会有一些 Bug 无法被检测出来。建议二次开发人员在进行测试时，可以进行多种操作，比如不输入某些值、输入不符合规范的值，甚至在界面上随意点击、进行误操作等，以查看是否存在问题。

5、维护与升级阶段

a.文档记录
对二次开发的过程和结果进行详细的文档记录，以便于后续的维护和升级。需求文档、设计文档、开发文档、操作文档等都应具备。在此强调，开发文档要尽可能详细地编写，并多做截图说明。例如接口开发文档，要详细描述接口的地址、账号信息、报文样例等内容。接口账号切记不能修改或删除，并知会项目相关人，曾经在一个项目中，突然所有接口都无法使用，经检查发现是接口账号的密码被修改了。因此，建议在该接口账号处添加备注信息。

b.持续优化
密切关注系统的运行情况，及时进行性能优化和功能改进，以满足企业不断变化的需求。