驰骋工作流引擎表单设计器功能一览表
基础功能
属性:用来控制表单的基本属性
保存:保存当前的设计,在设计过程中多执行保存并预览按钮。目前的保存具有保存与预览的功能。
预览:浏览当前的设计。
导出:就是把该表单备份,导出到一个xml文件。
导出ccform模板。导出ccform模板并共享。
全选:选择全部的元素,一般用于全部删除,全部平移对象,目前不太成熟。
对齐方式按钮:
左对齐——在选择多个同类的控件时,比如:标签、线、文本框,执行此按钮会执行左对齐。
居中——在选择多个同类的控件时,比如:标签、线、文本框,执行此按钮会执行居中。
右对齐——在选择多个同类的控件时,比如:标签、线、文本框,执行此按钮会执行左对齐。
顶部对齐——在选择多个同类的控件时,比如:标签、线、文本框,执行此按钮会执行左对齐。
底部对齐——在选择多个同类的控件时,比如:标签、线、文本框,执行此按钮会执行底部对齐。
删除:删除选择元素,如果选择的元素有多条,就要删除选择的元素集合。
增益:如果选择的是线条:点一次就增加一个像素的宽度;如果选择的是标签:点一次就增加一个字体的大小。
减益:如果选择的是线条:点一次就减小一个像素的宽度;如果选择的是标签:点一次就减小一个字体的大小。
调色版:用来改变线条,标签的颜色。
表单导入
CCForm提供多种方式导入表单模版。从ccBPM网站上导入
在ccBPM官方网站上有一些网友共享的表单模板,通过他们方便的导入进来。
目前该功能还没有实现。
1.从本机导入
导入存储在本机上的表单模板,选择本机的一个表单模版文件,执行确定按钮。
选择本机的文件,点确定按钮,系统提示您,导入会清除当前的设计,导入表单模版文件。
点确定,完成表单导入。
2.从节点表单导入
如果您当前设计的是节点表单,那末这个功能是有效的,该列表中列出了当前节点,选择一个节点执行确定,就完成了对节点表单的导入。
3. 从表单库导入
选择表单库中现有的表单,然后点确定,就完成从表单库表单导入.
他类似于把该表单复制一份。
4. 从内外部数据源导入
应用背景:ccform的表单设计是自上而下的设计,就是说现有表单后有数据表,就是说在设计表单时ccform就自动创建了字段,如果该表单的表有了该字段就不创建了。但是很多程序员习惯了先创建表,然后在创建表单,也就是说在设计表单时,系统已经有该表了,要以已经有的表结构做为该表单的模版导入,就需要用到此功能。
解释:从指定的数据源中,指定的表,导入字段信息。
用途:在新建表单以前,表单已经有一个原型,或者已经有一个表,要以原来的数据表结构为模版,创建表单。比如我们要做一个人员入职流程,在实施以前,人员的基础信息已经在一个表里了,为了方便快速的,准确的完成表单设计,可以从现有的人员表里把字段信息导入进来。
导入前的准备工作:
如果确认要使用原来的表作为该表单的数据表,那就把该表单的表与该表一致。需要把每个字段的中文描述都要写清楚,系统就会按照这个描述生成字段说明标签。
执行导入步骤:点击下图中的进入导入数据表字段向导,就进入下一步骤。
选择数据源:
选择要导入的数据源
在上图中可以创建一个数据源从其他数据库中导入字段, 这里是从本数据库导入数据表结构。注意:如果字段或者属性已经
选择要生成的字段
点击下一步,进入属性字段编辑界面,如下图.
配置字段属性
如果一个字段是枚举或者外键,可以在该字段上双击绑定值文本框,弹出外键或者枚举让其选择。
为字段设置外键或者枚举类型
点击【导入字段,生成表单】按钮就出现如下字段补充到该表单的最后面。
导入后的字段效果
导入后的字段根据自己的需要进行位置调整,完成导入工作。
表单事件
表单事件分为主表表事件与从表事件,事件是为您提供的业务处理的接口。
事件概述
设计图如下:
表单事件是在表单装在前后,保存前后发生的事件,它是编辑业务逻辑的接口。所以掌握表单事件非常有必要。
每个表单事件都有一样的如下4个属性:
事件类型:业务逻辑处理的依托载体,你是用存储过程,还是用sql.来实现你的功能。
执行内容:就是执行的主体,书写时支持全局变量@WebUser.No,@WebUser.Name 。支持本表单的字段变量@+字段名。
执行成功时:执行成功时提示的信息,信息内容支持变量,同执行内容一样。
执行失败时:执行失败时提示的信息,信息内容支持变量,同执行内容一样。
执行存储过程:
请在执行内容里填写一个存储过程名称,注意表达式支持变量。
执行SQL:请在执行内容里填写SQL,注意表达式支持变量。如果有多条sql ,可以用@GO 分开。
比如:DELETE WF_Emp WHERE 1=2
@GO
DELETE WF_Emp WHERE 2=3
如果要执行存储过程就要写: EXEC YourProName @OID @OID 是一个当前的workid 参数。
如下图:
执行自定义URL.
概要介绍:
用户在表达自己的业务逻辑时,往往用代码编写比较顺手,在这样的应用条件下,你可以编写一个url 向这个url中传递不同的标记,返回不同的结果来,返回空表示顺利执行。
实例:在执行内容里设置一个http://myserver/Do.aspx?DoType=aaaaa,创建一个Do.aspx 根据DoType 标记这不同的内容处理。
如果顺利处理了就返回空,出现异常一定要返回: Error+”异常信息。”
处理返回值用: this.Response.Write("Error:"+msg); 方法.
Ccform 处理的机制是,使用 HttpWebRequest 类静默的执行URL ,然后获取返回的内容。如果检查到前几个字符是Error 就认为是异常ccform 就会抛出异常。
系统参数:
您定义的url比如为 /App/DoUrl.aspx?ABC=123 , 系统会在之后增加一些参数,这些参数叫系统参数。实际执行的url为。
http://yourserver/App/DoUrl.aspx?ABC=123&UserNo=xy&SID=xxxxx&FK_Dept=1010&FK_Unit=10&EntityName=ND101&EntityPK=OID&EntityPKVal=12333&FK_Event=xxxxxx
后面多出的参数是系统参数,这些系统参数意义是:
参数名 | 中文名 | 用途 |
UserNo | 当前用户编号 | |
SID | 安全验证码 | 根据sid与userno可以进行访问的安全性校验,关于什么是SID,请参考其它文章。 |
FK_Dept | 当前操作人员编号 | |
FK_Unit | 操作员单位编号 | |
EntityName | 当前实体编号 | 当前实体的名称 |
EntityPK | 实体主键 | 实体的主键,大多是OID |
EntityPKVal | 主键值 | 实体的主键值,通过它可以获得该实体的其它信息。 |
FK_Event | 事件ID | 根据它可以获得sys_frmevent这条数据配置的其它信息。 |
注意如下事项:
在url 中不能用session对象,不能访问webUser.*的全局变量.
注意系统安全,防止非法侵入。
充分的利用系统参数,来获取其它的信息。
如果在执行内容里配置的url是一个相对路径比如是”/App/DoUrl.aspx”, 在bs模式下运行ccBPM就会自动拼接它的url . http://yourserverIP/App/DoUrl.aspx 如果是在cs模式下您需要在就需要在web.config中配置 BaseUrl 来告诉ccform执行的绝对路径。
执行系统URL
为了方便期间ccform定义一个系统的url, 如果选择这种类型,执行内容里就可以为空。系统在执行的时,就会自动访问。
http://myserver/ccflow/DataUser/AppCoder/FrmEventHandle.aspx
如果在FrmEventHandle.aspx文件中实现业务逻辑里面的一个详尽的案例。
主表事件
主表分为如下4种事件 装载前事件、装载后事件、保存前事件、保存后事件。您可以根据自己的需要加载相关的事件。
比如:在保存后处理相关的业务逻辑,要保存前做安全检查。
从表事件
从表具有如下事件:从表保存前,保存后。单条数据保存前,保存后。单条数据删除前,删除后。一共三对共计六个。
从表保存前,保存后:参数是主表的字段参数。
单条数据的事件是从表的参数。