业务对象管理

1、简介

1.1、功能介绍

将业务表单填写的数据模型进行增、删、改、查、导出、导入，支持添加主子（一对多，一对一）二层和主子孙三层关系的数据，数据还可支持来源第三方接口和多数据源维护的表数据，对该功能亦可理解为类似数据库的客户端可在线傻瓜式操作生成对应的物理表信息。

1.2、使用场景

在日常中涉及到填写数据的场景，比如：请假单、报销单、申请、入库等，都可以通过业务对象维护基础数据。

1.3、预期效果

以请假申请为例，效果如下：

2、创建业务对象

选择「表单管理>> 业务对象管理 >> 添加按钮>>新建>>下一步」，设置业务对象名称为「请假申请表」，即可创建请假申请表的数据模型信息。

1、新建主业务对象（主表）有两种方式：
（1）直接线上创建业务对象信息
（2）导入离线表信息，即根据连接池配置的数据库信息，直接将该维护的物理表直接一键引入添加
2、新增子业务对象（子表）有三种方式：
除了主表以上两种方式，多增加一种“现有BO”方式，该方式方便解决不同个主对象但是是同个子对象，即业务场景比如：出库、入库明细等，再利用该方式可将出库、入库2个对象变相维护成一个大BO的主子业务对象，即虚拟个主对象，从而实现多表多表单功能。

2.1、添加模式

简介：
1、新建：由实施人员、测试人员等在线添加业务对象信息；
2、现有BO:调用选择已维护的业务对象信息，避免同个业务对象每次都从零添加提高一定实施效率；
（注意：为了支持多表多表单显示，可将之前没有关联的表整合成主子表关系，变相将多个表汇总在一个业务对象。）
3、离线表：直接引入设计好的数据库信息，支持多数据源，可快速维护第三方表结构的数据；
4、导入接口：业务对象数据来源第三方接口，导入模式分如下：
（1）Swagger导入地址【根据提供的地址，获取里面的接口来填写前缀匹配】【iform格式的json数据】
（2）Swagger接口文档导入【根据提供的文件，获取里面的接口来填写前缀匹配】【iform格式的json数据】
（3）服务管理选择接口【在服务管理选择接口，创建业务对象】
（4）导入业务对象地址【在202地址操作，通过210获取业务对象地址数据来创建相同的业务对象】

2.1.1、新建

选择「表单管理>> 业务对象管理 >> 添加按钮>>」，选择“新建”模式，如下图：

手动录入业务对象的基本信息、对象属性、其他属性。可以作为主业务对象，也可以作为下级业务对象。

2.1.2、现有BO

编辑之前保存的业务对象信息，仅作为“下级业务对象”使用，选择“现有BO”模式，如下图：

2.1.3、离线表

选择「表单管理>> 业务对象管理 >> 添加按钮>>」，选择“离线表”模式，点击“下一步”按钮，如下图：

点击“离线表”的文本框区域，系统弹窗选择对应数据源、表名信息，如下图：

2.1.4、导入接口

选择「表单管理>> 业务对象管理 >> 添加按钮>>」，选择“导入接口”模式，点击“下一步”按钮，如下图：

2.2、添加字段

请假申请字段信息拆解如下：

字段信息是数据的核心点，也是制作表单的必要工具，在此添加维护的字段信息可对应在数据库生成一张对应的物理表信息，方便后续制作报表查询SQL无缝结合。

2.2.1、基本信息

细节说明：可设置主子孙三层结构关系的表结构数据，子对象可设置为“一对多”和“一对一”关系，若子对象已经设置为“一对一”则不能再添加孙对象（即不能再添加下级业务对象）且在表单对应的“子表单”控件模式只能为“块模式”，另外孙表不支持块模式，且关系类型只能是“一对多”。

设置该业务对象的基本信息为“请假申请人”，编码为“leaveForm”，填写完即可完成基本信息录入：

设置为主表基本信息后，需先在“左树”区域选择“请假申请表”，在右击”“按钮，在出现的菜单下拉选择“添加下级业务对象”按钮，如下图：

2.2.2、对象属性

细节说明：
1、系统默认初始的字段信息，建议不要删除，若执意需要删除创建时间的字段是必须要保留。主键必须是字符串，且不能赋予默认值，此值由系统默认维护，不能自行赋予值！
2、字段：对应物理表的字段信息，系统后缀默认带下划线，避免出现保留字导致生成表失败；
3、编码：对象属性的简称，也对应后端代码生成实体类中的成员属性信息，因此需要驼峰命名格式：systemName;
4、描述：对应物理表字段的注释信息；
6、属性长度：根据业务填写的字段设置对应的属性长度值，若设置较小会导致数据无法保存，例如：组织多选、附件多选、图片多选建议不能低于2000；
5、数据类型：对应物理表的数据类型，且根据数据库类型对应生成数据库中的字段类型，细节内容如下；

• 添加字段属性信息，比如：“申请人”的添加页面，需要继续添加字段则点击页面右下角的“应用”按钮，若不需要继续添加则点击“确定”按钮，如下图：
  

• 添加从表字段信息有：先在“左树”维护主表的基础上，在点击主表右边”“按钮，在出现的菜单下拉选择“添加下级业务对象”按钮，如下图：
  

• 点击“下一步”设置业务对象的名称为“请假证明材料表”，然后再切换到“对象属性”，添加字段信息，如下图：
  
  字段信息如下图：
  

• 设置完业务对象信息后，点击页面上的“保存”按钮，即可完成业务对象数据录入，如下图：
  

2.2.3、其他属性

主要针对数据需维护树形结构才需要操作此功能，若不需要维护树形数据可不理会！选择“其他属性”，需要增加父节点活上级节点字段，且该字段在表单展示不需要展示，值由系统维护，因此对应作为父节点存储值设置对应隐藏域控件即可，如下图：

• 展现形式选择“列表”时，在【数据模板管理】中数据以列表形式展示。如下图：
  
  

其他说明：
①树ID字段：建议选择“主键”
②树父ID字段：树形结构中存储父节点的ID字段
③树展示字段：树形结构中所需显示的字段名

• 展现形式选择“树形”时，在【数据模板管理】中数据以树形形式展示。如下图：
  
  

3、生成表

设置完字段信息后，返回到「表单管理>> 业务对象管理 >> 生成表按钮」选择对应数据（主从多个业务对象，只需要选择主对象对应的子对象则会自动对应生成物理表），点击此按钮，如下图：

温馨提示：
（1）流程选择绑定“业务表”，那么该业务对象就必须生成物理表！
其他说明：
（1）未生成表的BO，列表中才会显示出“生成表”按钮。
（2）系统自动生成对应的物理表名，例如：“T_xxx”。
(ps：oracle和sqlServer是大写表名，mysql是小写表名)。

4、数据导出

简介：在测试库中可将数据导出为zip，再快速导入迁移在生产库中。
选择「表单管理>> 业务对象管理 >>选择要导出的数据 >>导出按钮」，系统提示：是否进一步配置导出数据？否则直接导出当前业务对象。若选择的是主表对象信息，则需要点击“是”进入选填对应的子表对象信息，若不需要导出对应的子表或只是单表则点击“否”按钮，如下图：

此选择的是主表信息，选择点击“是”按钮，勾选完对应的主子信息后，点击右下角“导出”按钮，浏览器会自动提示下载后缀为zip的文件，页面如下图：

5、数据导入

选择「表单管理>> 业务对象管理 >>导入按钮」，系统字段弹窗选择导入业务对象的信息，选择完对应导出的zip文件后，点击“导入”按钮，系统会自动将导出业务对象进行存储，如下图：

说明：
（1）系统之前没有对应的业务对象数据，导入数据是“新增”；
（2）系统之前已有对应的业务对象数据，导入数据是“编辑”且对应的“版本号”会自动增加“1”为一个新版本，若有维护新增的字段，对应的表单需要再原先基础数据复制表单，在弹窗页面切换业务对象版本才行。

6、维护表关系

说明：非连续性添加的主子孙关系，即添加A-B为主子关系，B-C为主子关系，此时在点击A对象生成表只有A和B成功生成表，C没有生成，出现该情况C只能再点击生成表，但在B-C维护的表单会出现C表数据丢失，出现该情况必须选择该A-B-C的信息后点击维护关系才能正常存储数据。
选择「表单管理>> 业务对象管理 >>添加按钮」，先添加A表和B表的对象信息，如下图:

然后再编辑B表，添加它的下级对象为C表，如下图：

选择“A表”的信息，点击“生成表”按钮，如下图：

生成表成功，返回到业务对象列表，发现“C表”没有生成表，此时需在点击“生成表”按钮，如下图：

但此时生成的表关系会导致，选择主表“B表”设置的表单信息，会导致C表的子表单数据丢失，出现该情况则需要再次选中该3条数据，点击“维护表关系”才能正常存储数据，如图：

7、同步表结构

- 支持同步表结构的范围【业务对象管理-离线表，代表管理-表配置】

实例：
离线表在数据库中新增字段，业务对象内的离线表不会同步更新，同步表结构后，自动更新【影响范围：表单管理{已经配置的字段}】

（1）添加业务对象

• 首先我们要进入【业务对象管理】模块，点击“添加”按钮，操作如下图：
  

（2）选择离线表类型

• 其次选择“离线表”，点击“下一步”按钮，操作如下图:
  
  
  

（3）在数据库中给离线表新增一条数据

（4）同步表结构

• 同步表结构，数据更新到跟数据库的数据一致
  
  
  

8、发布新版本

8.1 发布新版本

用户可在原有的对象信息中编辑新增一个版本，不影响历史版本的使用，且可查看历史版本。
（1）根据需求选择所要增加版本的某个对象。

（2）根据需求，对“对象属性”中字段增、删、改等操作。

（3）点击“发布新版本”。

温馨提示：
发布新版本后，旧版本业务对象以及旧版本创建的表单不影响，即新增或删除的字段，发布新版本后，已创建的表单不生效，需要重新复制表单更改版本号。

8.2 历史版本维护

（1）查看历史版本的业务对象

• 业务对象列表，“版本信息”列中点击“更多版本”。
  
• 查看历史业务对象。
  
  （2）对历史对象进行编辑、删除、查看明细
  
  （3）设置为主版本
• 根据需求，将某个历史版本设置为“主版本”。
  
  

温馨提示：
（1）设置为“主版本”后，新建表单绑定业务对象时，绑定的为主版本的对象信息。
（2）“主版本”不可在“更多版本”列表中删除。

9、复制业务对象

在实施过程中，将之前类似的业务对象信息，复制一份之后，在此基础上进行添加和删除字段方便快速构建新的业务对象信息。

• 在【业务对象管理】选择某条数据，比如：请假申请单，在右边“管理”列中，点击圆形图标出现的按钮菜单点击“复制”按钮，可进入复制页面，细节如下图:
  
  
  温馨提示： 编码的值格式只支持首字符为字母，其他只能为字母、数字或者下划线组合，且字符不能超过18字符。

10、删除业务对象

• 可选择数据，进行删除，点击列表后面的【删除】按钮，选择：物理删除、逻辑删除
  
  

温馨提示：
①业务对象若已关联父对象，需取消关联才能删除父对象，子对象则可以直接删除；
②业务对象（任何业务对象）若已关联表单、流程，需先取消关联才能进行删除；
③继续点击删除就只删除子业务对象和没有关联父对象、表单、流程的业务对象；

10.1、物理删除

选择物理删除后，页面的业务对象和在数据库已生成的物理表同时删除成功。

10.2、逻辑删除

选择逻辑删除后，页面的业务对象删除成功，但在数据库已生成的物理表不会被删除。
注意：逻辑删除业务对象后，再在页面新增相同编码业务对象，生成表时会提示表已经存在。遇到此情况时，只能在数据库中手动删除表后，再在页面生成表。