《HYUEP应用平台开发手册流程系统分册》由会员分享，可在线阅读，更多相关《HYUEP应用平台开发手册流程系统分册（20页珍藏版）》请在金锄头文库上搜索。
1、 内部资料 注意保密HY-UEP应用开发平台开发指南工作流开发分册烟台海颐软件股份有限公司2013年1月文档可自由编辑打印文 档 说 明文档名称HY-UEP应用开发平台开发指南 工作流开发分册文档编号 文档版本0.1文档密级 内部版本0.1.0.2文档类型初稿 征集意见稿 最终稿文档编制 编制时间2013-01-05文档审核 审核时间 文档审核 审核时间 所属项目 项目编号 文档备注 修 订 记 录修订人修订内容摘要产生版本修订日期审核人批准人批准时间 目 录1 前言11.1 编写目的11.2 适用范围11.3 相关说明12 综述12.1 系统架构12.2 开发流程23 开发指南33.1 开发
2、环境配置33.2 任务相关数据说明33.2.1 模板相关数据33.2.2 实例及任务列表43.2.3 任务执行情况53.2.4 待办任务63.3 启动流程实例63.4 流程传递指南73.4.1 正常传递73.4.2 选择传递83.4.3 派工提交83.4.4 回退93.4.5 任务抽回93.5 人员分配103.6 流程和办理进度的网页监控113.7 重要常量说明113.8 系统配置说明134 开发示例144.1 自由流的实现144.2 会签的实现154.3 并行子流程的实现154.4 自动活动的实现154.5 流程初始化参数的实现155 常见问题解答151 前言1.1 编写目的工作流平台依托海
3、颐企业级应用开发平台开发实现，为方便进行二次开发和流程调度，单独封装了一套进行流程调度的API接口。这些接口表现为一个JAVA类的方法，并通过参数和返回值进行流程调度和信息交互。通过这些API的调用，可以协助开发者实现任务的提交，激发工作流进行相应的调度等。使用HY-UEP平台的工作流模块进行二次开发，需要了解系统提供的这些API接口，需要掌握这些接口的含义、使用场合、参数的含义以及遵循一些约定等，本文档详细阐述了这些API编程细节，并对调度引擎中的重要常量、重要参数、常见示例等做了说明；从开发指南到开发示例，一步步指导开发人员完成工作流的二次开发工作。1.2 适用范围工作流模块是HY-UEP
4、的选配模块，因此只有在UEP STUDIO集成开发环境中创建UEP项目时选择了支持工作流模块的特性，项目中才能进行工作流的相关开发工作。本文档面向的读者主要是使用HY-UEP平台的工作流模块进行二次开发的开发人员。1.3 相关说明在工作流调度接口中，使用最多的是各类任务的提交接口，本文档主要详细介绍了任务正常提交、选择传递、派工提交、任务激活、默认回退以及任务抽回等接口。本文档还介绍了几种常用业务需求的解决方案：自由流的实现、会签的实现、并行子流程的实现、自动活动的实现以及流程初始化参数的实现等。要求预期读者需要具备一定的工作流基础知识，并且在开发过程中可能会涉及到众多的平台知识，请参阅HY-
5、UEP相关文档。2 综述2.1 系统架构HY-UEP的工作流平台作为海颐企业应用平台的一个系统模块，以业务服务的形式为企业应用提供服务。工作流平台是基于WfMC的工作流模型，结合多年的开发经验开发出的遵循xpdl模型标准，满足分布式、异构环境要求的工作流系统。体系结构如下图所示：工作流平台包括流程建模工具和工作流引擎两部分，流程建模工具用于流程定义，集成到了UEP Studio开发环境中。流程引擎负责流程的调度和运行，包括三部分：工作流接口、调度内核和引擎服务。工作流接口对外提供流程定义、监控和调度接口。调度内核负责流程调度，产生流程实例、活动实例和任务项并处理，处理过程中调用引擎服务的事件服
6、务、时限服务、应用代理和日志服务。2.2 开发流程UEP项目如果使用流程模块，首先要在项目上增加流程模块的支持，有了流程模块的支持后，就可以绘制业务流程模板，进行基于流程的业务流程开发了。具体开发过程如下：1. 分析业务需求，找出需要绘制的业务流程模板。2. 归纳业务办理步骤，创建标准环节，为流程绘制做准备。3. 绘制流程模板，请参考流程建模的操作手册。校验成功后加载流程模板。4. 在业务应用中建立业务功能和流程模板的对应方式，并确定业务工作单和流程实例的关联方法，以便运行业务功能时能够启动对应模板的流程实例，并把流程实例关联到业务工作单上。5. 显示待办任务。6. 在业务办理界面中增加流程传
7、递的功能。下面的章节对后面几个过程进行说明。3 开发指南3.1 开发环境配置工作流模块只能依托UEP项目进行开发，所以得首先安装集成开发环境UEP-SUTDIO，然后在新建UEP项目时要勾选“工作流模块”，也可以在已有的UEP项目中再增加“工作流模块”的支持。详细操作参考UEP Studio平台操作指南.doc。3.2 任务相关数据说明3.2.1 模板相关数据3.2.1.1 模板类别EP_WF_ TEMPLATE_CLASS：模板类别表，存储工作流系统中定义的模板分类信息。字段说明：列名代码类型说明模板类别号TEMPLATE_CLASS_NOnumber(8)上级模板类别号UP_CLASS_N
8、Onumber(8)模板类别名TEMPLATE_CLASS_NAMEvarchar2(64)使用系统标志MODULE_IDvarchar2(32)排序序号ORDER_CODEvarchar2(32)备注REMARKvarchar2(255)3.2.1.2 模板库主信息EP_WF_ TEMPLATE：存储工作流系统中已经定义的模板信息。字段说明：列名代码说明类型模板号TEMPLATE_NO模板的编号，与版本号一起唯一标识一模板number(8)版本号VERSION_NO标识一模板的具体版本，与模板号一起唯一标识一模板varchar2(8)模板名TEMPLATE_NAME模板的名称varchar2
9、(64)模板类别号TEMPLATE_CLASS_NO模板所属的模板类别号number(8)是否运行版RUN_FLAG是否是当前执行版，Y,Nvarchar2(1)模板对应程序窗口TAG一个流程模板对应的程序主窗口或主类varchar2(128)子流程标识AS_SUBFLOW标识一模板是否只能作为子流程使用，不能独立启动实例varchar2 (1)流程模板类型MODEL_TYPE流程模板类型，1：模型1；2：模型2varchar2（1）所属部门DEPARTMENTnumber(10)创建时间CREATE_TIMEdate创建者CREATORvarchar2(16)合格标志VALID_FLAGY：
10、合格；N不合格varchar2(1)启用时间START_DATEdate停止时间END_DATEdate动态修改标志MODIFY_FLAGY：动态修改；N：没有动态修改varchar2(1)前身版本PRE_VERSION_NOvarchar2(8)排序序号ORDER_CODEvarchar2(32)描述信息DESCRIPTION_INFOvarchar2(255)模板日历CALENDAR_TYPE1：默认日历；2:7*24小时日历varchar2(1)3.2.2 实例及任务列表3.2.2.1 实例列表EP_WF_INSTANCE_LIST：存放工作流系统中的实例信息。字段说明：列名代码说明类型
11、实例号INSTANCE_IDnumber(10)模板号TEMPLATE_NOnumber(8)版本号VERSION_NOvarchar2(8)调度状态STATE0 挂起 1 运行 2 正常结束 3 异常结束varchar2(1)实例开始时间START_TIME启动时间date实例结束时间END_TIME结束时间date实例启动人START_OPERATORvarchar2(32)所属部门DEPARTMENT实例的默认部门number(10)锁定标志LOCK_FLAGvarchar2(1)顶级部门TOP_DEPARTMENTnumber(10)备注REMARKvarchar2(255)3.2.2
12、.2 当前任务清单EP_WF_TASK_LIST：存放实例对应的当前任务列表信息。字段说明：列名代码说明类型实例号INSTANCE_ID当前任务的实例号，与任务号一起标识一当前任务number(10)活动实例ACTIVITY_INSTANCE_NO活动实例号number(4)任务号TASK_ID当前任务的任务号，与实例号一起标识一当前任务number(4)活动号ACTIVITY_NO当前任务的环节号number(4)标准环节号STD_TACHE_NO当前任务对应的标准环节number(10)活动名称ACTIVITY_NAME活动名称Varchar2(128)处理实体号ENTI_ID当前活动的处
13、理实体varchar2(255)处理实体类型ENTI_TYPE当前活动处理实体的类型，1:角色；2：人员；3：软模块；4：子流程varchar2(8)版本号VERSION_NO实例使用模板的版本号char(8)模板号TEMPLATE_NO实例使用模板的模板号number(8)任务状态TASK_STATE0 等待前驱计数完成； 7 待领取；8待处理；9正在处理 ;A 已提交 ;char(1)日历类型CALENDAR_TYPE1：默认日历2：724小时3: 组织日历4: 流程日历varchar(1)计时要求标志TIME_FLAG任务是否要求计时varchar2 (1)任务传来人员LAST_COMMITOR当存在并行流程时可以有多个varchar2(255)
