1-1 项目环境配置及项目启动与访问

1-1-1 项目环境配置

详细安装教程不做详解，自行官网寻找版本进行安装

1.安装HBuilder9.0.2版本（红色图标版）

2.安装IntelliJ IDEA

3.安装Git

1-1-2 检出项目代码

如下图4-1所示：打开Idea选择Get From Version Control，填写项目地址：https://gitee.com/xmlland/conflux-bpm.git，进行项目代码的检出，选择检出之后idea会有进度提醒。

项目检出完成进入idea之后，idea页面显示效果如下图4-2所示 。

1-2 系统简单配置

添加系统所需要的角色、用户、字典等内容，详情参考视频教程该部分内容，此处不做具体介绍。

1-3 生态项目管理系统快速开发（普通表单）

以生态项目管理系统为例，分步骤创建普通表单，实现项目信息的增删改查、组合查询条件及分页功能。

1-3-1 表单设计

1.登录Bpm平台，菜单栏中表单管理--表单设计，点击添加新建表单；

2.在表单设计tab页下，填写表名（project_manage）、说明（项目管理），英文说明点击说明后面的‘译’按钮即可，选择表单类型为列表，合约地址选择系统测试合约；如下图所示：

3.点击快速创建，填写自己所需要的内容，使用空格分隔

注：快速创建的内容默认为单行文本组件，如需设计下拉框，人员选择等内容，需在领域管理--通用领域部分将所要快速创建的字段进行设计添加；

否则添加之后对部分内容进行手动添加控件进行设计（点击相应组件，即可添加该组件）

4.点击需要设计的组件，右侧可对其进行属性配置

具体可配置内容如下：

a.字段名：数据库字段名

b.说明：数据库字段注释，英文说明点击说明后面的‘译’按钮即可

c.是否可编辑

d.默认值

e.Java类型：String、long、Integer、Double等（根据需要自行选择）

f.物理类型：文本、整型、日期、长文本等（根据需要自行选择）

g.窗格：在表单中占一整行，选择x12，占据半行则选择x6即可

h.可空：若未必填项，则选择必填，否则选择可空

i.校验：对组件内容进行校验，可选择字符串、电子邮件、日期、银行卡号、身份证号等

j.最大长度/最小长度，最大值/最小值

k.Java属性名称：该名称在表单中唯一，不能重复

l.显示表单类型：单行文本、多行文本、下拉框、多文本编辑器等

m.区块链：对某字段设置其是否为区块链以及区块链是否加密，如下图所示

注意：对组件进行配置之后一定要点击‘应用’按钮才可修改生效。

1-3-2 自定义表单

若需要导出单据类内容，则可在自定义表单部分根据表单设计的内容自定义表单内容，如下图所示；点击“生成自定义表单”按钮，生成自定义表单。

1-3-3 列表设计

在列表设计tab页下。组合查询条件设计：拖拽左侧数据项到自由表单列表选择其作为查询条件；如下图

点击齿轮选择其查询匹配方式（=，>，<,like等），点击应用配置完成。如下图：

列定制选择列表展示内容，如下图：

之后选择对表单进行保存。

1-3-4 新建菜单

列表搜索表单project_manage，点击设计。在创建菜单的tab页下点击添加菜单，选择上级菜单和图标，之后进行保存。如下图：

1-3-5 同步数据库

列表搜索表单project_manage，列表可以看到该表单数据库同步状态，显示未同步，点击同步数据库按钮进行同步数据库操作（即在数据库中创建该表）。

1-3-6 表单发布

列表搜索表单project_manage，勾选表单，点击列表页的发布按钮对代码进行发布（生成前端页面代码），选择表单风格（动态表单物理表），填写功能描述及功能名。

1-3-7 刷新缓存

系统设置的菜单下找到缓存管理，分别点击“刷新字典缓存”、“刷新菜单缓存”，“刷新表单缓存”。如下图所示：

1-3-8 模块演示

添加项目信息

如下图所示：可以看到项目姓名、项目编号、项目负责人等单行文本及人员选择内容，日期选择显示正常，项目目标、项目描述等为多行文本；项目名称、项目编号设置其上链（区块链）；

项目信息查看

如下图所示：列表页可以看到设计好的相关显示字段，每条数据操作列部分查看相关操作按钮，点击实现对数据的查看、编辑、删除操作。

组合查询条件及分页

如下图所示，根据名称内容进行查询，列表仅展示查询条件的数据，且可在列表页右下角看到分页信息。

编辑删除项目信息

编辑删除项目信息不做说明，自行测试即可。

1-4 生态项目管理系统详情（主子表）

以项目验收申请为例，进行主子表的操作演示。查看主子表的关系，增加、查看、编辑、删除组子表的信息。

1-4-1 表单设计

1.登录Bpm平台，菜单栏中表单管理--表单设计，点击添加新建表单；

2.在表单设计tab页下，填写表名（project_check_apply）、说明（项目验收），英文说明点击说明后面的‘译’按钮即可，选择表单类型为列表，合约地址选择系统测试合约；如下图所示：

3.点击快速创建，填写自己所需要的内容，使用空格分隔

注：快速创建的内容默认为单行文本组件，如需设计下拉框，人员选择等内容，需在领域管理--通用领域部分将所要快速创建的字段进行设计添加；

否则添加之后对部分内容进行手动添加控件进行设计（点击相应组件，即可添加该组件）

4.点击需要设计的组件，右侧可对其进行属性配置

具体可配置内容如下：

a.字段名：数据库字段名

b.说明：数据库字段注释，英文说明点击说明后面的‘译’按钮即可

c.是否可编辑

d.默认值

e.Java类型：String、long、Integer、Double等（根据需要自行选择）

f.物理类型：文本、整型、日期、长文本等（根据需要自行选择）

g.窗格：在表单中占一整行，选择x12，占据半行则选择x6即可

h.可空：若未必填项，则选择必填，否则选择可空

i.校验：对组件内容进行校验，可选择字符串、电子邮件、日期、银行卡号、身份证号等

j.最大长度/最小长度，最大值/最小值

k.Java属性名称：该名称在表单中唯一，不能重复

l.显示表单类型：单行文本、多行文本、下拉框、多文本编辑器等

m.区块链：对某字段设置其是否为区块链以及区块链是否加密，如下图所示

注意：对组件进行配置之后一定要点击‘应用’按钮才可修改生效。

1-4-2 列表设计

在列表设计tab页下。组合查询条件设计：拖拽左侧数据项到自由表单列表选择其作为查询条件；如下图：

点击齿轮选择其查询匹配方式（=，>，<,like等），点击应用配置完成。如下图：

列定制选择列表展示内容，如下图：

之后选择对表单进行保存。

1-4-3 新建菜单

子表内容以tab页的形式展现在主表的表单下方，因此如果子表无需单独的菜单查看其单独的内容，子表部分可以选择不添加菜单（需要的话自行按照单表的方式进行添加）；

1-4-4 同步数据库

列表搜索主表的名称，点击左侧加号，即可看到该主表下的字表（一张主表下面可以有多个子表），列表可以看到该表单数据库同步状态，显示未同步，点击同步数据库按钮进行同步数据库操作（即在数据库中创建该表）。

1-4-5 表单发布

列表搜索表单project_check_apply，勾选表单，点击列表页的发布按钮对代码进行发布（生成前端页面代码），选择表单风格（动态表单物理表），填写功能描述及功能名。

主子表的部分因其展现在主表表单的下方，因此发布子表的同时，需要将主表的代码重新发布（即重新生成）。

1-4-6 刷新缓存

系统设置的菜单下找到缓存管理，分别点击“刷新字典缓存”、“刷新菜单缓存”，“刷新表单缓存”。如下图所示：

1-4-7 模块演示

添加项目信息

如下图所示：可以看到主表下方点击添加按钮即可添加子表相关的内容：项目编号、验收申请时间等单行文本及附件内容，日期选择显示正常，项目完成情况、资料审查情况等为多行文本；

项目信息查看

如下图所示：列表页可以看到设计好的相关显示字段，每条数据操作列部分查看相关操作按钮，点击实现对数据的查看、编辑、删除操作。

组合查询条件及分页

如下图所示，根据名称内容进行查询，列表仅展示查询条件的数据，且可在列表页右下角看到分页信息。

编辑删除项目信息

编辑删除项目信息不做说明，自行测试即可。

1-5 生态项目审批（工作流）

以生态项目为例，分别进行上链流程申请-审批演示。增加、查看、编辑、删除信息、分页、组合查询条件等功能同非流程表单，以下内容对该部分不做记录。

1-5-1 表单设计

1.登录Bpm平台，菜单栏中表单管理--表单设计，点击添加新建表单；

2.在表单设计tab页下，填写表名（organic_project_workflow）、说明（生态项目管理系统工作流），英文说明点击说明后面的‘译’按钮即可，选择表单类型为列表；

3.点击快速创建，填写自己所需要的内容，使用空格分隔

注：快速创建的内容默认为单行文本组件，如需设计下拉框，人员选择等内容，需在领域管理--通用领域部分将所要快速创建的字段进行设计添加；

否则添加之后对部分内容进行手动添加控件进行设计（点击相应组件，即可添加该组件）

4.点击需要设计的组件，右侧可对其进行属性配置

具体可配置内容如下：

a.字段名：数据库字段名

b.说明：数据库字段注释，英文说明点击说明后面的‘译’按钮即可

c.是否可编辑

d.默认值

e.Java类型：String、long、Integer、Double等（根据需要自行选择）

f.物理类型：文本、整型、日期、长文本等（根据需要自行选择）

g.窗格：在表单中占一整行，选择x12，占据半行则选择x6即可

h.可空：若未必填项，则选择必填，否则选择可空

i.校验：对组件内容进行校验，可选择字符串、电子邮件、日期、银行卡号、身份证号等

j.最大长度/最小长度，最大值/最小值

k.Java属性名称：该名称在表单中唯一，不能重复

l.显示表单类型：单行文本、多行文本、下拉框、多文本编辑器等

m.区块链：对某字段设置其是否为区块链以及区块链是否加密，如下图所示

注意：对组件进行配置之后一定要点击‘应用’按钮才可修改生效。

1-5-2 列表设计

在列表设计tab页下。组合查询条件设计：拖拽左侧数据项到自由表单列表选择其作为查询条件；如下图

点击齿轮选择其查询匹配方式（=，>，<,like等），点击应用配置完成。如下图：

列定制选择列表展示内容，如下图：

1-5-3 流程定义

1.在流程定义tab页下，点击添加新建流程,填写相关内容并保存，如下图：

2.选中要设计的流程，在操作列部分选择在线设计，对流程进行设计，如下图所示：

3.选中某一节点，点击权限配置，如下图所示：

4.人员范围部分设置流程中该流程相关人员，（注：第一节点人员必须选择相对角色中的发起者）如下图所示：

5.权限规则中，选择表单按钮，表示流程中该节点所拥有按钮（可对当前申请进行暂存、提交到下一节点等）；规则变量中设置该节点用户是否可对当前表单的内容进行修改或填写，并设置其是否显示、是否必填等内容；如下图所示:

6.之后进行保存，并对流程中涉及到的节点分别按照需求进行设计，之后点击部署，进行部署，并将该流程选中到该表单设计中，如下图所示：

之后对表单进行保存。

1-5-4 新建菜单

列表搜索表单organic_project_workflow，点击设计。在创建菜单的tab页下点击添加菜单，选择上级菜单和图标，之后进行保存。如下图：

1-5-5 同步数据库

列表搜索表单organic_project_workflow，列表可以看到该表单数据库同步状态，显示未同步，点击同步数据库按钮进行同步数据库操作（即在数据库中创建该表）,同步之后可以看到同步数据库状态为‘已同步’，如下图：。

1-5-6 表单发布

列表搜索表单organic_project_workflow，勾选表单，点击列表页的发布按钮对代码进行发布（生成前端页面代码），选择表单风格（动态表单物理表），填写功能描述及功能名。

1-5-7 刷新缓存

系统设置的菜单下找到缓存管理，分别点击“刷新字典缓存”、“刷新菜单缓存”，“刷新表单缓存”。如下图所示：

1-5-8 模块演示

填写申请

点击添加合同申请按钮（待发Tab页），填写相关内容；如下图：

点击提交，即可提交到流程下一节点，如下图所示：

流程审批

根据流程配置，上一节点用户对当前申请提交之后，下一节点用户（即当前登陆用户）可在待办（待办Tab页）中查看自己需要办理的流程，选中需要办理的申请单，点击办理，填写审批意见，并可查看流程日志，根据流程配置选择是否可对当前表单内容进行修改。详情如下：

A.下一节点用户在待办中可以看到自己待办的内容（即：当前情况下，上一节点用户提交的内容）；如下图所示：

B.点击办理，即可填写审批意见继续选择提交或回退（当前申请不会提交到下一节点，而是回退到上一节点，上一节点的用户可在其待办中看到），最后一个节点的人员提交后，该流程结束；如下图所示：

查看流程日志

每一个表单在查看或编辑时都可查看流程日志，并可查看当前审批流程已经走到了哪个节点(当前为了方便操作，使用同一人进行申请审批，具体实际应用要根据需求决定)。如下图所示：

1-6 列表层级关系设计演示（树表）

以生态项目管理系统为例，分步骤创建普通表单，实现项目机构的增删改查、组合查询条件及分页功能。并将项目机构按照树表形式进行层级逐级展示。

1-6-1 表单设计

1.登录Bpm平台，菜单栏中表单管理--表单设计，点击添加新建表单；

2.在表单设计tab页下，填写表名（organic_post）、说明（生态项目机构），英文说明点击说明后面的‘译’按钮即可，选择表单类型为树表；如下图所示：

3.树表与普通表单略有不同，因此不做快速创建的演示，如下图所示，因为树表是层级展示，因此针对于层级展示的表单，系统中有上级控件，可以选择该层级的上级

Ps：树表中 上级 控件是必选

注：快速创建的内容默认为单行文本组件，如需设计下拉框，人员选择等内容，需在领域管理--通用领域部分将所要快速创建的字段进行设计添加；

否则添加之后对部分内容进行手动添加控件进行设计（点击相应组件，即可添加该组件）

除了以上的字段之外，树表需要一个字段存放所有上级的id，因此需要添加一个单行文本（将其拖拽到下方隐藏区域即可），字段名必须为parent_ids，如下图所示：

4.点击需要设计的组件，右侧可对其进行属性配置

具体可配置内容如下：

a.字段名：数据库字段名

b.说明：数据库字段注释，英文说明点击说明后面的‘译’按钮即可

c.是否可编辑

d.默认值

e.Java类型：String、long、Integer、Double等（根据需要自行选择）

f.物理类型：文本、整型、日期、长文本等（根据需要自行选择）

g.窗格：在表单中占一整行，选择x12，占据半行则选择x6即可

h.可空：若未必填项，则选择必填，否则选择可空

i.校验：对组件内容进行校验，可选择字符串、电子邮件、日期、银行卡号、身份证号等

j.最大长度/最小长度，最大值/最小值

k.Java属性名称：该名称在表单中唯一，不能重复

l.显示表单类型：单行文本、多行文本、下拉框、多文本编辑器等

m.区块链：对某字段设置其是否为区块链以及区块链是否加密，如下图所示

注意：对组件进行配置之后一定要点击‘应用’按钮才可修改生效。

1-6-2 列表设计

列定制选择列表展示内容，如下图：

之后选择对表单进行保存。

1-6-3 新建菜单

列表搜索表单organic_post，点击设计。在创建菜单的tab页下点击添加菜单，选择上级菜单和图标，之后进行保存。如下图：

1-6-4 同步数据库

列表搜索表单organic_post，列表可以看到该表单数据库同步状态，显示未同步，点击同步数据库按钮进行同步数据库操作（即在数据库中创建该表）。

1-6-5 表单发布

列表搜索表单organic_post，勾选表单，点击列表页的发布按钮对代码进行发布（生成前端页面代码），选择表单风格（动态表单物理表），填写功能描述及功能名。

1-6-6 刷新缓存

系统设置的菜单下找到缓存管理，分别点击“刷新字典缓存”、“刷新菜单缓存”，“刷新表单缓存”。如下图所示：

1-6-7 模块演示

添加机构信息

如下图所示：可以看到上级机构的上级控件选择，行政区域的区域选择，负责人等人员选择控件，均正常显示；

机构信息查看

如下图所示：列表页可以看到设计好的相关显示字段，每条数据操作列部分查看相关操作按钮，点击实现对数据的查看、编辑、删除操作。

树表内容按照层级关系进行多级逐级展示，在每一条数据的后面都会有’添加下级机构’的按钮选项，即可添加本条数据的下级内容

编辑删除机构信息

编辑删除机构信息不做说明，自行测试即可。

1-7 人员信息即部门层级展示（左树右表）

以生态项目管理系统为例，分步骤创建普通表单，实现项目信息的增删改查、组合查询条件及分页功能。以前面生态项目机构为基础，进行人员表（左树右表-机构为左树，人员信息为右表）进行教程说明。

1-7-1 表单设计

1.登录Bpm平台，菜单栏中表单管理--表单设计，点击添加新建表单；

2.在表单设计tab页下，填写表名（organic_user）、说明（生态项目人员），英文说明点击说明后面的‘译’按钮即可，选择表单类型为列表，合约地址选择系统测试合约；如下图所示：

在左树右表的教程中，我们将前面创建好的机构的表作为左树，右表即为当前的人员内容，因此在表单设计部分我们可以看到人员表是机构表的子表，如下图所示：

3.点击快速创建，填写自己所需要的内容，使用空格分隔，或者手动点击选择我们所需要的组件

注：快速创建的内容默认为单行文本组件，如需设计下拉框，人员选择等内容，需在领域管理--通用领域部分将所要快速创建的字段进行设计添加；

否则添加之后对部分内容进行手动添加控件进行设计（点击相应组件，即可添加该组件）

4.点击需要设计的组件，右侧可对其进行属性配置（左树右表中，需要上级的控件，其属性配置中的字段名为parent_id，不可更改）

具体可配置内容如下：

a.字段名：数据库字段名

b.说明：数据库字段注释，英文说明点击说明后面的‘译’按钮即可

c.是否可编辑

d.默认值

e.Java类型：String、long、Integer、Double等（根据需要自行选择）

f.物理类型：文本、整型、日期、长文本等（根据需要自行选择）

g.窗格：在表单中占一整行，选择x12，占据半行则选择x6即可

h.可空：若未必填项，则选择必填，否则选择可空

i.校验：对组件内容进行校验，可选择字符串、电子邮件、日期、银行卡号、身份证号等

j.最大长度/最小长度，最大值/最小值

k.Java属性名称：该名称在表单中唯一，不能重复

l.显示表单类型：单行文本、多行文本、下拉框、多文本编辑器等

m.区块链：对某字段设置其是否为区块链以及区块链是否加密，如下图所示

注意：对组件进行配置之后一定要点击‘应用’按钮才可修改生效。

1-7-2 列表设计

在列表设计tab页下。组合查询条件设计：拖拽左侧数据项到自由表单列表选择其作为查询条件；如下图：

点击齿轮选择其查询匹配方式（=，>，<,like等），点击应用配置完成。如下图：

列定制选择列表展示内容，如下图：

之后选择对表单进行保存。

1-7-3 新建菜单

列表搜索表单organic_user，点击设计。在创建菜单的tab页下点击添加菜单，选择上级菜单和图标，之后进行保存。如下图：

1-7-4 同步数据库

列表搜索表单organic_user，列表可以看到该表单数据库同步状态，显示未同步，点击同步数据库按钮进行同步数据库操作（即在数据库中创建该表）。

1-7-5 表单发布

列表搜索表单organic_user，勾选表单，点击列表页的发布按钮对代码进行发布（生成前端页面代码），选择表单风格（动态表单物理表），填写功能描述及功能名。

1-7-6 刷新缓存

系统设置的菜单下找到缓存管理，分别点击“刷新字典缓存”、“刷新菜单缓存”，“刷新表单缓存”。如下图所示：

1-7-7 模块演示

添加人员信息

如下图所示：点击添加按钮，表单中可以看到归属机构的树选择、登录名的单行文本等内容（此处该归属机构的上级控件比较关键）

人员信息查看

如下图所示：列表页可以看到设计好的相关显示字段，每条数据操作列部分查看相关操作按钮，点击实现对数据的查看、编辑、删除操作。

编辑删除人员信息

编辑删除人员信息不做说明，自行测试即可。