驰骋工作流引擎表单设计器操作手册.docx

驰骋工作流引擎表单设计器操作手册.docx

《驰骋工作流引擎表单设计器操作手册.docx》由会员分享，可在线阅读，更多相关《驰骋工作流引擎表单设计器操作手册.docx（122页珍藏版）》请在冰点文库上搜索。

驰骋工作流引擎表单设计器操作手册

驰骋表单设计器

操

作

说

明

书

济南驰骋信息技术有限公司

2013年1月修订

第1章:

总体说明

1.1:

前言（必读）

驰骋自由表单设计器有一种存储格式、两种设计模式，三种展现方式，具有一定的通用的接口可以被外部调用，自己有可以独立运行起来的应用程序。

一种存储格式：

采用映射的机制，以xml文件格式存储。

两种设计模式：

傻瓜表单设计器，自由表单设计器。

三种展现方式：

傻瓜表单、自由表单、手机表单。

表单设计器以映射思想为核心。

所说的映射业务规则对字段，操作方法，界面展现，操作行为的描述。

表单设计者认为事物的业务规则与操作模式都是可以被抽象出来的，并且把其封装并实现。

但是并不是所有的业务规则都有价值去抽象，是否有价值去抽象并封装是应用的范围与实现的代价。

由以上两个理论为指导，把界面所有的元素的描述，业务规则的描述以对象的形式为描述。

Ccflow自由表单设计器不一定满足所有的数据采集与数据展现格式，但是可以解决对数据库操作层面的绝大多数需求。

用户可根据自己的需要选择其中的一种表单的工作方式。

1.2:

一种存储格式（同一个表单）

Ccflow的表单存储格式与传统的表单存储格式不同，它是采用数据表的存储的，这是最大区别于文件格式的存储。

正是因为ccflow摆脱了对文件格式存储的表单的依赖，所以具有最大范围的扩展性通用性、灵活性。

物理表名

中文名

说明

Sys_FrmLab

标签

存储标签

Sys_FrmLine

线

存储线，线只分横线与竖线。

Sys_FrmLink

超连接

超连接

Sys_FrmImg

图片

图片

Sys_FrmBtn

按钮

按钮，按钮支持多样的事件方式

Sys_MapAttr

字段

存放三种类型的字段

textbox,checkbox,dropdownlistbox.

Sys_MapData

表单主表

Sys_M2M

一对多

Sys_M2MM

一对多多

Sys_FrmAttachment

附件

….

…

…更多请参考程序代码.

可以利用ccform的导出功能把这些规则化的数据导出成一个xml。

1.3:

两种表单设计器（同一个表单）

驰骋公司根据用户群体不同，用户对界面的要求不同特开发了两种表单设计器，三种展示模式。

自由表单设计器与傻瓜表单设计器，两者的存储格式都是一样的，就是展示与设计方式不同。

1.3.1:

傻瓜表单设计器

优点：

设计方便，不需要排版，有分组显示功能界面简洁清晰，容易上手。

缺点：

不形象直观，不符合用户的需求格式。

1.3.2:

自由表单设计器

优点：

设计方便，形象直观，随心所欲。

缺点：

没有傻瓜表单简洁，需要排版，同样的功能没有傻瓜格式方便。

1.4:

四种展现方式（同一个表单）

对于一个表单来说有三种展现方式，至于用户使用那种表单是有流程的节点属性来设置的。

1.4.1:

傻瓜表单

优点：

界面清晰、简洁、紧凑。

缺点：

格式固定。

1.4.2:

自由表单

优点：

界面元素可以根据用户的需要任意排列。

缺点：

样式不能调整。

1.4.3:

手机表单

手机填写主表:

手机从表:

点上图中的费用明细就可以看到下面的从表查看界面。

手机表单是

手机表单特点

1.4.4:

Silverlight表单

1.5:

自由表单设计器预览

1.6:

傻瓜表单设计器预览

1.7:

表单样本

1.7.1:

企业基本情况

企业基本情况（打印）与打印模板.

1.7.2:

财务负责人简历

具有附件图片

1.7.3:

从表导入导出

从表的导入导出

1.7.4:

多表头从表

企业代表工程业绩一览表（多级表头明细）

1.7.5:

从表的卡片表现形式

从表的卡片方式展现

1.8:

表达式全局变量

在系统中有很多的地方需要用到表达式的地方，这些表达式就需要参数与变量，这些参数是以@+变量名。

我们把参数与变量分为全局变量，字段变量。

操作人员登陆系统后就有如下全局变量。

@WebUser.No当前操作员编号

@WebUser.Name当前操作员名称

@WebUser.FK_Dept当前操作员部门

@AppPath当前的文件路径。

比如:

http:

//demo.ccflow.org/ccflow

变量用@加变量名体现。

比如:

@WebUser.No。

以FF中，很多的表达式需要变量的支持。

比如一个sql表达公式。

SELECTNo,Name,FK_DeptFROMPORT_EmpWHEREFK_DEPT=’@WebUser.FK_Dept’

注意区分大小写。

表单字段变量：

@+字段名比如:

SelectgenerBillNo（@OID）fromdualOID就是表单字段。

@+字段名是获取界面上的动态输入的值。

第2章:

控件使用说明

工具栏中的对象分为装饰类控件、数据类的控件、与功能类的控件。

鼠标：

类型vs设计器中的鼠标功能，当您点了其它的功能按钮后，您想取消选择，就点此功能。

选择：

在画布画矩形在矩形内部的对象都被选择，比如对选择的线条的粗细进行+-。

对颜色进行更换，对label集合的字体颜色进行变化。

标签：

文字类装饰元素，标签的文字大小、类型、颜色，都可以变化。

画线：

线条的粗细、长度、颜色属性可以改变。

超连接：

功能类的控件，它有两部分组成标签与连接，标签部分的功能与标签功能一致。

装饰图片：

装饰类的控件，多用于把公司的icon图片放在上面。

按钮：

为了实现一些功能

文本框：

长度、高度、默认值都可以被编辑。

日期框：

长度固定

选择框：

Boolean类型的字段。

下拉框（枚举）：

枚举类型下拉框。

下拉框（表、视图）：

下拉框中是以表格为内容的。

表单附件：

可以是任何格式的控件。

图片附件：

比如简历的个人图片。

从表：

与主表之单的表格

一对多的关系：

比如与主表的关系，节点岗位，

隐藏字段：

不需要在表单上显示出来的字段，多用于值的计算，或者节点方向条件的转换。

所有的控件，都在工具箱，这里介绍这个工具箱里控件使用方法。

2.1:

装饰类控件

用来装饰表单界面元素的控件，我们称为装饰类控件，这类的控件没有任何计算作用，仅仅实现装饰表单的效果。

此类的控件有三种：

线、标签、装饰图片、公章。

2.1.1:

线

线是装饰类对象的基本元素。

对于线的操作有画一根线，选择一根线。

选择一个线，可以把这条线变长，变粗，变颜色。

拖动线头的红色原点，可以让其变长。

线的位置移动微调：

选择一根线后，使用aswd键进行改变他的位置。

加粗一根线的操作：

选择这根线，然后点A+图标，每点一次就增加1px，点A-就可以让一根线变细，A+,A-功能就是增益与减益。

对字体也是一样的操作。

2.1.2:

标签

标签是用来文字说明装饰，标签可以改变颜色，字体大小，风格等等。

标签元素可以复制，选中后，ctrl+CCtrl+V就可以实现。

支持鼠标移动，aswd键，方向键移动。

字体放大：

选择这label，然后点A+图标，每点一次就增加1px，点A-就可以让label变小，A+,A-功能就是增益与减益。

2.1.3:

装饰图片

图片是表单元素的一部分，该控件是在指定的位置贴一个图片，一般是客户的icon。

2.1.4:

公章

这里的公章就是一个图片，为了能够更生动的让审批人员或者处理人员查看，ccform的公章处理规则如下。

第一：

一个部门一个岗位只有一个公章。

流转到的节点

2.2:

字段类控件

文本框、日期框、选择框、下拉框、单选按钮、表单附件、图片附件、从表、一对多的关系表、隐藏字段。

2.2.1:

普通类型的控件

用来描述一个属性的文本类型、数值类型的属性，称为普通类型的字段。

比如：

年龄、地址、身高、电话、邮件、出生日期、婚否？

这些字段都是以文本的的方式或者checkbox的方式展现出来。

2.2.1.1:

新增字段.

在工具栏里，选择一个文本框，然后拖动到画布里，系统弹出来对话框让您确认部分属性。

说明：

1,日期与日期时间框不能改变大小，其它的类型的文本框可以改变大小。

2,要改变文本框的位置可以按下它的边框，然后移动，或者选中它，使用方向键移动。

3，字段全拼，字段简拼都是当前字段的英文名称，系统创建字段时，就按照这个值来创建。

属性编辑:

如上图

2.2.1.2:

创建审核分组

在表单设计中经常遇到领导审核、或者审批，这种审批与审核通常有三个字段组成分别是审核意见、审核人、审核时间。

审核意见是一个大块文本采集框、审核人是默认当前操作人员、审核时间就是当前时间。

如果在自由表单设计器中一个个的字段添加也是可以的，ccform为了提高设计者的效率与傻瓜表单设计器一样推出增加审核分组功能。

如下图：

填写说明见上图:

如果审核分组的字段前缀是CW，那系统就会创建三个字段分别是CW_Checker审核人,CW_RDT审核日期,CW_Note审核意见。

同时也建立了一个字段分组，条理化规则的显示在傻瓜表单设计器中。

审核分组字段提高开发效率，规范了字段命名规则。

2.2.1.3:

创建隐藏字段

隐藏字段的用途？

隐藏字段不体现在表单里，隐藏字段一般用于计算临时计算，在节点表单中做为方向条件。

如何创建与编辑隐藏字段？

在创建正常字段时您是是否是隐藏字段勾上，如果要编辑隐藏字段在工具栏里有一个隐藏字段图标。

2.2.2:

枚举类型控件

枚举类的控件简单来说，就是0代表什么，1代表什么，2代表什么。

枚举类的数据类型用下拉框与单选按钮来完成。

它用于声明一组命名的常数，当一个变量有几种可能的取值时，可以将它定义为枚举类型。

2.2.2.1:

枚举值定义

技术信息:

ccflorm用两个表来存储枚举值信息分别如下。

CCForm有一个功能界面来维护这些枚举值，当您新建一个枚举字段时，系统就会给您一个枚举列表，让您选择，如果系统中没有的枚举值，您可以自己定义枚举值。

2.2.2.2:

下拉框

如下图，建立下拉框枚举值：

新建枚举类型

展示的效果：

2.2.2.3:

单选按钮

单选按钮是枚举值的一种表现形式，它相对于下拉框，把选择项平铺出来，更直观的让用户进行选择。

设计方法如下：

选择枚举.

设计样式

浏览样式

拖动枚举值，可以根据展示需要调动它的位置。

2.2.3:

外键类控件

关键字：

ccform外键表外键字段

对于一个表单来说外键是经常遇到的，ccform为我们提供系统的基础表（Port_Emp,Port_Dept,CN_PQ,CN_SF,CN_City,），当然也可以把自己定义外键表，或者说字典表。

在您初始化系统后，您可以打开SELECT*FROM　Sys_SFTable你将会看到一些演示的数据。

’

外键实体分为物理表类型与系统类库.用类库可以很好的控制查询权限,比如人员查询权限，在表单中只列出该操作员的部门人员。

部门类可以控制只查询本人的部门与本人的下级部门。

如果用物理表就没有这个概念了。

外键表存储在Sys_SFTable系统表中，您可以通过界面维护它，也可以手工的维护它。

如果您手工的维护（注意：

SFTableType此字段已经不用了）。

对于Sys_SFTable列描述如下：

No:

外键,Name:

表名称,FK_Val在创建外键字段时默认的外键字段名称TableDesc:

描述。

IsEdit是否可以编辑。

如何把ERP，OA，CRM应用程序中的物理表对应到ccform中去？

首先把应用系统的物理表通过视图映射到ccflow可访问的数据库中来，这个表或者视图必须有No，Name,两个列。

其次把这个数据维护到Sys_SFTable中去。

对于技术人员掌握了这个表结构,可以自己的外键表去维护到里面去。

2.2.3.1:

自定义表列表

选择外键字段

2.2.3.2:

创建与编辑外键表

2.2.4:

隐藏字段

用于存储临时计算值，在节点表单中，经常被用到方向条件。

在您创建文本框时您如果选择了隐藏字段，系统就会把此字段不体现在表单设计器中。

在创建正常字段时，您只要把是否是隐藏字段勾上就可以了。

隐藏字段也属于普通类型的字段一种。

2.3:

附件类控件

2.3.1:

单个表单附件

文件是以上传一个文件保存到服务器上，如下图所：

附件的格式需要以,分开比如:

*.doc,*.docx,*.txt

拖放后：

预览表现：

2.3.2:

多表单附件

多表单附件是用户上传的附件格式不能确定，数量不能确定情况下使用。

设计步骤：

在工具栏点多附件按钮，如下图：

多表单附件属性：

附件名称：

就是为控件起一个名称，附件编号需要全局唯一。

保存到是文件要保存的位置。

是否可下载，是否可删除，是否可上传是用来控制附件的访问权限的。

特别说明：

类别可以为空，如果不为空时系统就会自动为它附件按约定的格式分类。

两种附件的展现模式：

多附件的功能比较应用比较广泛，可以使用到公文上面。

2.3.3:

手写板

2.3.4:

图片附件

图片附件与文件附件不同的地方就是图片附件需要预览。

比如：

我们做一个简历表单，需要把人员的照片放在指定的位置。

设计方式：

在工具栏中找到图片附件。

用shift+方向键改变图片的大小。

预览效果如下图。

编辑与上传图片：

点编辑连接，系统弹出如下对话框。

可以把剪切的图片点确定按钮，返回。

其他：

有时间图片附件出现剪切错误，请按照如下方式解决。

1.程序代码不是最新。

2.浏览器兼容问题导致。

3.迁移到自己系统中出现问题。

请仔细检查核。

2.3.5:

对附件路径的变量支持

业务背景：

很多情况下，ccform要求上传的文件目录需要只读的，在上一个版本中ccform的附件目录是根据实体的主键值创建的，这样会导致打开附件目录找不到对应的附件文件，为此ccform支持了目录名字可以自定定义如下图：

保存到的文本框支持了ccflow的表达式，值得说明的是变量后面必须增加一个@OID,这样不会导致目录名称重复。

对于项目类的文件就可以支持到了，一个项目一个文件夹，如果查看该项目的所有附件，直接打开上传的文件夹就可以获得了。

2.3.6:

附件功能大总结

流程引擎运输的不仅仅是表单数据，而且还是有附件数据，附件数据是ccform的重要处理部分，本文介绍ccflow在流程管理系统中怎么处理附件数据的。

单个附件：

是上传一个附件，有文件名称。

如果该附件是只读的就不显示编辑按钮。

多个附件：

可上传多个附件，也可以多个类型，可以有分组，也可以无分组。

如果该附件是只读的就不显示编辑按钮。

多个附件上传时可以有分组功能，也可以无分组功能。

图片附件：

图片的展示，需要放在表单上，如果该附件是只读的就不显示编辑按钮。

表单设计界面：

表单预览界面：

2.4:

关系类控件

与主表发生关系的控件，但是需要独立工作的控件，我们称为关系类控件。

关系类控件目前有三种：

主从表、一对多、一对多多、审核组件。

2.4.1:

从表（明细表）

从表也叫明细表，从表是表单常用，主要的控件之一，ccform的从表有丰富的功能满足不同环境下的应用需要。

2.4.1.1:

从表设计器介绍

从表设计器：

在从表设计器面板里，可以可视化的展现出要运行的从表样式。

2.4.1.2:

基本属性

点击明细表的名称连接，在左上角，设计器弹出一个明细表设置的属性窗口，如下图。

明细表属性窗口

属性列表

2.4.1.3:

插入列

插入列就是为表格增加列，一个列就是对应一个字段，如下图：

弹出的是插入列向导，我们把字段分为普通类型字段，枚举类、外键类字段。

也可以使用导入自动功能快速的增加列。

点击列名可以设置其属性，这个属性与字段类的控件使用方式一致。

修改列的属性

2.4.1.4:

插入列组

在工作流引擎上，有的列是系统约定好的一些字段，这些字段是配合从表的属性一起使用的，他们组合在一起完成流程的一些特定的功能，我们把这些指定字段名的字段称呼为固定列组。

比如：

点击从表审核分组，系统就会自动创建如下字段。

这些字段就是具有固定列名的字段。

2.4.1.5:

复制列

可以从其他表或者从表里复制过来一些列，让其保持字段名，字段属性一直，这里用到了节点表单的设计上。

2.4.1.6:

隐藏字段

不要显示给用户，但是数据还是需要有的字段，叫隐藏字段。

一个字段被设置隐藏字段后，可以根据这个列表修改其属性，让其不隐藏，或者删除它。

修改隐藏字段的属性。

2.4.1.7:

多表头

关键字:

ccform从表多表头

需求背景：

多表头是反映在复杂的报表中或者数据输入界面中，它是对用户的表头进行分组。

如下图：

设计步骤：

在设计模式下点多表头，在里面填写html脚本代码。

2.4.1.8:

从表事件

事件是ccform与您的应用程序，或者数据表交互的接口，使用从表的事件可以处理复杂的业务逻辑交互。

明细表可以执行的事件与主表能够执行的事件设置方式是一致的，这里不再重复。

但是事件的执行位置是不同的，认真的理解事件的名字，根据自己的业务需要编写相关的事件。

从表的事件的格式与主表的事件格式一样的描述。

在实际工作中，我们经常用到从表保存完后要处理一些业务逻辑。

比如：

要根据主表的字段更新一些从表的信息。

比如：

在每条数据更新前后都要做安全性校验。

特别说明：

对于从表保存前，保存后两个事件，用@符号获取的变量是主表字段的变量。

其它的事件是从表的字段。

@WebUser.No,@WebUser.Name@WebUser.FK_Dept全局字段约定不变。

从表事件的返回值约定:

1,在明细表的保存前，与删除前如果返回false或者0,系统就会取消保存与删除操作。

这种行为应用于，不能删除或者不能保存的情况。

2.4.1.9:

基本功能设置

点击从表的中文名字，就可以弹出从表的属性窗口，这里介绍的基本设置。

属性说明：

属性

解释

表的英文名称

也叫明细表的ID，这个是只读的不能修改，明细表的相关属性，比如字段属性，都要关联这个ID值。

表的中文名称

展示给用户的名称。

物理表名

也称为表名，用户存储数据的表，指定这个表后，系统就会自动为该表增加相关字段。

是否可见

不可见，就隐藏该明细表。

是否可以修改行

对当前明细表的权限控制，是否可以进行修改。

是否可以新增行

对当前明细表的权限控制，是否可以新建记录。

是否可以删除行

对当前明细表的权限控制，是否可以删除记录。

是否显示序号列

如果是，从表就多一个序号列。

是否显示合计行

如果是，从表底部就多一行合计，它会对数值类型的列进行合计。

是否允许从上一个节点copy数据

对于节点表单有效，如果否，则不会copy数据，如果是在上一个节点发送时，系统就会自动把上一个明细表的数据copy过来。

是否是合流汇总从表

对于分合流节点表单有效，如果当前节点是一个合流节点需要汇总各个子线程上的主表数据，把每个子线程的主表作为当前明细表的一行数据，展示给合流节点的处理人。

是否启用多附件

如果是则在一行上显示一个附件图标，让用户为该行数据上传一个附件。

点击圆圈的地方，设置附件属性，方框的列就是上传附件的连接，运行的效果与设计的效果一致。

是否启用一对多

同上

是否启用一对多多

同上

是否启用审核字段

与流程一起工作有效。

<>

<>

是否启用分组字段

是否启用锁定行

请参考其他其它章节

是否显示明细表头

如果false,则不显示表头了。

初始化行数

打开表单时初始化的行数。

显示格式

表格、卡片、

2.4.1.10:

是否启用多附件

在现实应用中会经常出现在一个从表中每条数据也需要附件功能的支持，为此ccform在从表属性中扩展了此功能，用户只需要启用这个设置就可以了。

如果启用了此功能，如下图，保存后在底部控制按钮会多显示一个附件属性按钮。

点此按钮后可以进入编辑此附件属性功能。

另外在最后显示出来附件按钮ICON.

其它说明：

从表的附件也支持复制。

从表的附件权限控制与主表附件权限控制相同。

运行效果：

2.4.1.11:

数据导入导出

属性配置页如下:

启用导入导出后，运行的前台结果是。

点击导出数据连接ccform就把当前的明细表的数据输出到excel文件里让其下载。

如果启用了导入数据，就需要事先让表单设计人员设计一个excel表格，这个表格的中文列名与明细表的中文列名保持一致，并且把这个模版文件放入到.\DataUser\DtlTemplete目录下并且命名格式为从表ID+”.xls”。

这样用户在执行导入数据前首先下载数据模版，然后根据模版的要求填写数据，之后上传完成导入。

导入分为清空方式导入，与追加方式导入，顾名思义不再解释。

2.4.1.12:

导入导出与数据填充

在明细表中，导入导出是经常用到的，导出就是导出到excel.导入ccform提供两种方案，分别是通过excel导入，通过配置的数据源导入。

2.4.1.12.1:

导出明细表数据

当明细表的配置允许数据导出时，用户就可以按照下列操做步骤进行导出明细表的数据。

2.4.1.12.2:

导入数据模版

2.4.1.12.3:

应用场景

对于大批量的从表数据采集，在web上执行就会给用户带来不方便，用户需要一个导入功能，比如事先把数据整理到excel中然后导入到表单从表中。

本章节介绍如何为ccform的从表设置导入表单模板。

执行效果：

用户点选项按钮，导入

2.4.1.12.4:

设计制作步骤

第一步：

根据从表制作一个excel表（注意:

费用类型为枚举或者外键类型仍然可以导入。

）

注意目前ccform仅支持excel2003版本。

第二步：

把此模板文件按照该从表的ID存储一个从表ID+.xls格式存储到

D:

\ccflow\trunk\DataUser\DtlTemplete\下面.

比如:

D:

\ccflow\trunk\DataUser\DtlTemplete\ND501Dtl1.xls文件.

第三步：

打开从表属性，启用设置可以导入功能。

2.4.1.12.5:

数据选择填充

应用场景：

用户所要输入的数据是需要从其他的数据源选择的，比如要建立一个灰名单库，但是灰名单需要从一个名单列表选择，可能需要选择多条。

配置方法：

这个应用需要如下3个sql支持：

初始化SQL：

当用户进入界面时，首先展现的数据源，必须有No,Name两个列。

查询SQL:

用户点查询时的SQL,注意@Key是关键字，必须有No,Name两个列。

填充数据SQL:

返回的列名一定要与明细表的列名相同，否则填充不上，@Keys是用户选择的多个主键.

前台展示效果：

如果用户点放入，可以按照关键字查询继续选择。

如果用户点放入并关