工作流快速入门

第1章前言

本文档以一个企业采购申请业务为例，来介绍华丹CHARISMA工作流系统的开发使用方法。

为了使用户能够对利用CHARISMA开发平台和CHARISMA工作流系统，开发工作流程，有一个整体的系统的了解。本文中将以需求分析（第2章流程描述），数据库设计（第3章数据库设计），系统实施（4-7章），测试（第8章测试）这样的顺序来介绍开发过程。

第2章需求描述

2.1 企业采购申请业务需求：

首先，员工填写采购申请单。然后，将申请单送交分公司经理审批。分公司经理无异议，再交由总部财务填写单价和优惠总价。如果金额大于100万，则同时送财务总监和副总经理审批；之后总经理汇总其意见，作出采购与否的决定。如果金额小于100万，只需送总经理审批即可。

审批流程如图所示：

第3章数据库设计

3.1 数据库逻辑结构设计：

分析需求不难发现，在这个业务系统中，主要的业务信息有两类：一是这次采购的总体信息，如申请人、申请时间、采购用途等；二是采购的具体产品的信息，如数量、名称、说明等。据此，我们设计了两张表：采购申请表、采购明细表。其表结构设计如下：

采购申请表记录采购申请的详细信息。而采购申请明细，记录申请采购的具体产品信息。用户可根据表的逻辑结构，来创建数据库。

第4章资源初始化

从这一章开始，直到第6章结束。我们将介绍实例的实施过程。这里的实施其实是一个系统详细设计兼实施的过程。因为业务较为简单，这里只描述设计思路。

首先是采购员录入采购信息。那么就需要一个填写采购信息和采购产品信息的表单。之后需要将这次采购申请，送交进入审批流程，也即“启动流程”。进入流程之后，CHARISMA 工作流系统将会自动的调度和协调审批任务在流程中各节点之间的流转；当然这需要将本业务的业务流程配置在CHARISMA工作流系统中。当审批任务在各个流程节点流转时，为了使审批人能够执行审批操作，还需要定制审批信息录入表单。分析各审批节点的任务可以发现：总部财务需要一个只填写价格的表单，而其他节点则需要填写审批意见的表单。下面开始实施。

本例的实施过程遵循在CHARISMA开发平台上开发业务应用的一般过程，即首先初始化资源，包括配置数据库连接，建立子系统，建立数据字典（包括表和数据列的信息）。然后进行应用的开发。

对于开发工作流系统，开发的第一个步骤应该是配置流程定义。但是，鉴于流程定义的配置过程中需要填写一些资源的url，比如审批表单的url，所以将流程定义的配置放在实施阶段的最后第7章来介绍。

4.1 数据库连接配置

系统开发之前，首先要创建数据库（上一章中所设计的数据库）。然后在平台中对其进行连

接配置。在系统控制中心>>注册业务应用>>数据库连接维护，注册数据源，即配置数据库连接参数。界面如下：

4.2 注册子系统

在本平台中，业务功能模块是以子系统的形式进行划分和管理的，即一个子系统代表一个业务功能模块。因为系统中已有其它子系统，所以，开发前先要建立自己的子系统。我们在这里建立一个名为”demoflow”的子系统。注册过程：系统控制中心>>注册业务应用>>子系统信息维护。点击其中的“注册子系统”按钮，即可进入下图所示的“新增子系统”信息页面。

注意，其中的“运行数据库”要选择我们刚才配置的数据库。

4.3 注册字典信息

此处所述字典信息，主要指数据表中某些字段的值的取值和它的文字说明。

4.3.1 注册数字字典

在这个示例中我们会用到采购申请的“状态”和“审批结果”这两个数据字典。相信用户看到它的设置情况，就知道它的使用含义了。

注册操作如下：

打开模块：系统控制中心>>数据字典管理>>数字字典维护，点击“新增字典组”，界面如下所示：

当前状态：

审批结果：

4.4 生成表列信息

“生成表列信息”这个步骤的目的是将数据库中的表以及字段的信息保存起来，如表的中文名称，字段的中文名称等等。其实就是生成数据库表的字典信息。

打开模块：系统控制中心>>表列信息管理>>表列信息生成向导，界面如下图所示：选择采购系统用到的两个表

分别点击下面两个表的表列信息：

点击“表列信息”，修改PURCHASE_BASE的数据列描述:

点击“编辑”按钮，为申请人、业务状态等字段设置字典。如下：

1、申请人：（申请人字典为系统用户字典）

2、业务状态：（业务状态字典为前面注册的业务状态字典，字典组标识可能与图中不一致请点击旁边按钮选择）

修改PURCHASE_DETAIL的数据列描述：

相信用户在操作这部分内容的过程中就会发现，表列信息的生成，其实是为我们刚才设计的业务表（包括表名、字段名还有字段数据类型、主键等等信息）在系统中建立字典。并且其中的很多信息，已由系统自动生成。

第5章定制流程所需资源

这章里我们的主要任务就是定制业务系统中所需要的表单。我们按照这样的步骤来开发我们的流程示例系统。

5.1节要定做一个包含查询、修改和录入采购申请功能的模块。5.2节定制流程启动功能。

5.3节定制流程节点的审批页面。

5.1 定制采购申请的维护功能模块

5.1.1 采购申请查询功能

一、 定做采购申请单查询报表：

打开模块：系统控制中心>>智能报表管理>>SQL 报表向导，界面如下图所示:

选择“demoflow ：流程系统”。并且点击图中“直接设置SQL ”按扭来填写查询数据所需sql 语句。如图:

填写好报表sql 和报表名称后即可点击“完成”按扭来保存报表信息。此报表使用的sql 如下：

SELECT 'edit','del','submit', APPL YNO,APPL YFOR, APPL YOR, APPL YDATE, APPL YSTATUS, REMARK FROM PURCHASE_BASE WHERE APPL YDATE >= ? AND APPL YDATE <= ? AND (APPL YSTA TUS=1 OR APPL YSTATUS=3) AND APPL YOR= '[%=curUserID()%]' ORDER BY APPL YDATE ASC

Sql 中的前三个数据列（'edit','del','submit'）是留作为每条记录添加操作（改，删，发起流程）等功能链接的数据列，而APPL YSTATUS 这是一个控制申请单显示的字段。当它为1

查询报表SQL 语句

报表名称

（草稿）或3（驳回）状态时才显示。APPL YOR= '[%=curUserID()%]' 这个条件，限定申请单的所有者才可访问申请单。

注意：为方便开发和测试，请将系统中所开发的资源的权限都设置成“否”。

完成上步操作，系统返回“报表基本信息维护”页面。此时点击下图中“报表设计”链接可进入此报表的报表设计器，对其进行详细设置。

点击“报表设计”，打开此报表的报表设计器，如图：

二、发布报表：

设计报表之后，要将其发布到平台左边的导航菜单中，方便调用。发布步骤如下：首先、我们新建一个模块组：“流程示例”，在“系统控制中心>>系统资源发布>>系统模块维护”：

点击“新增模块组”，如图所示。

然后，在报表“采购申请管理”的报表设计器中，将该报表发布到“流程示例”模块组下。

步骤：点击左边树结构中“报表发布”，所属模块组选择“流程示例”：

单击保存后，刷新主菜单就可以看到我们发布的报表：

5.1.2 采购申请录入功能

接下来要制作采购申请单的录入界面。因为一个采购申请涉及到两部分内容，一是采购申请本身，二是要采购的具体产品。该界面是由两个新增资源组合而成的。

其中产品的录入

为批量录入，即可在同一界面录入多个产品，如图所示：

录入界面的制作过程如下：

首先，生成采购申请单和采购明细各自的新增资源：

打开模块：系统控制中心>>数据维护管理>>新增资源生成向导，

1、生成采购申请的新增资源：

选择新增列：因为“采购用途”和“备注”需要用户自己填写，而“申请人”和“申请日期”可经配置后，由系统自动产生，它的配置会在后面给出。所以这里将“采购用途”、“备注”设定成新增列，而将“申请人”、“申请日期”设定成只显示列。

2、生成采购明细新增资源：

设定新增列

保存后，在“新增资源维护”所对应的界面中，以”bInsDetail”作为新增标识查找此新增资源。并修改此新增资源，将其新增类型改为“批量直接数据表操作”，如图：

新增组合维护资源：

打开模块：系统控制中心>>数据维护管理>>组合数据维护资源，点击新增组合维护：

前面创建的两个

新增资源标识

保存后，这个组合资源就基本完成了，不过还需要我们去修改一些东西。如：

新增采购信息里“申请单号”可以设置成自增列，则就用到了平台的序列资源；

新增采购信息里某些列要设定初始值，如申请人、申请时间，状态；

两个新增资源中都有“申请单号”数据列，则就需要让它们录入的值保持一致，所以我们需要把“insApply”的申请单号值传到“bInsDetail”资源中。

下面我们就一一解决这三个问题：

新增序列资源：

打开模块：系统控制中心>>系统资源管理>>常用资源管理>>序列资源维护，点击新增序列资源：

该序列编码规则设定为按日递增，前八位为日期，后两位为序列值。

引用序列：

打开模块：系统控制中心>>数据维护管理>>新增资源维护，找到我们做的新增资源标识为“insApply”的资源，如下图：

点击“新增设计”链接，打开新增资源设计器界面，维护该新增资源，如图：

点击上图中的“新增列扩展信息”菜单，打开列扩展信息维护界面，点击“注册列扩展信息”按钮，新增列扩展信息，如图：

设定初始值：设定申请人，点击“注册列扩展信息”按钮，打开新增列扩展信息界面，申请人：

申请时间：

状态：

数据列传值：

打开模块：系统控制中心>>数据维护管理>>新增资源维护，找到新增资源标识为“insApply”的资源，如下图：

点击上图中的“新增设计”按钮，打开新增资源设计器界面，维护该新增资源，如下图：

选择“表达式操作资源”菜单，点击其中的“注册表达式操作”按钮，新增一个表达式操作资源，用于将申请号保存起来，以便申请单明细表中使用。这里是将它保存在request 对象的属性里面。如下图：

表达式内容：setReqAttr("applyno",col("APPL YNO"))，即把数据列值通过request属性applyno 来传递。

传申请号给申请单明细表

打开模块：系统控制中心>>数据维护管理>>新增资源维护，找到我们做的新增资源标识为“bInsDetail”的资源，打开其新增资源设计器，在其左侧菜单中选择“新增列扩展信息”，点击“注册列扩展信息”按钮：