NCV-后台任务开发参考文档.doc

NCV6后台任务平台开发参考文档 NC-UAP 6.0 用友NC-UAP 2010-06-18 目 录 概述 3 功能节点 3 后台任务类型注册： 3 后台任务条目配置 4 后台任务监控 6 后台任务日志 6 后台任务插件类接口 6 BgWorkingContext 6 附录 7 数据库表 7 插件类示例 8 其他说明 9 变更单 版本号 变更日期 功能点 变更内容 提出人 变更人 V1 2010-5-25 后台任务插件接口 后台任务插件接口返回值类型，以便支持消息模板 盖井芬 概述 NCV6后台任务平台的开发模式与V5相同，首先需要注册后台任务类型，然后建立某后台任务类型下的后台任务条目，同样提供了对后台任务任务监控、后台任务日志管理、后台任务消息查询的功能。 区别于V5的部分包括： V6支持消息模板，根据后台任务条目配置的消息模板生成消息文件。消息模板在插件类中解析，由平台提供解析消息模板的接口（消息模板及接口未完成） 增加基于天数的周期性后台任务模式。应用场景类似于资产中的定期保养； 节点位置变更：其中后台任务类型注册，后台任务类型注册位于：开发平台——开发配置工具）内，其他节点位置参见下节。 功能节点 后台任务类型注册： 后台任务类型就是一种后台任务的一个插件类型（由开发人员开发，具体如何开发插件见（后台任务插件类接口）。它目的是对某个业务或操作的抽象，其可以定义一系列阈值。(这里也只是定义，真正的值还是由条目来设置的)。 定义一个后台任务类型需要提供：名称、所属系统、业务插件、描述、阈值名称、编辑类型、参照名称(如果编辑类型为参照)。 后台任务类型注册节点位置:开发平台——开发配置工具——后台任务类型注册 后台任务类型注册的信息包括名称，所属开发模块，业务插件实现类，以及阈值条件定义。其中业务查询类是要求实现了nc.bs.pub.taskcenter.IBackgroundWorkPlugin接口的实现类的完整类名。条件区域，组织类型用于限定阈值的参照取值范围，这样在该类型后台任务条目的新增时，通过选择相应的组织，来缩小参照类型阈值的取值。 后台任务条目配置 后台任务条目一般由实施人员或用户根据具体的业务环境和需要来定义。通过选择后台任务类型，并设置该后台任务类型中需要用户设置的阈值变量，以及定义后台任务方式来实现具体的后台任务任务。后台任务方式包括产生方式和发送方式。产生方式控制后台任务的发生时间，有即时和定时两种。发送方式是定义后台任务以何种方式发送给用户。 后台任务条目是具体的后台任务任务，是后台任务平台调度执行的单位。一个后台任务类型可以根据不同的业务情况定义多个后台任务条目。 后台任务条目保存后台任务信息的产生条件及发送方式设置，基于后台任务类型进行编辑。后台任务平台的后台服务线程定时读取后台任务条目信息，根据条目中设置的条件，调用相应的后台任务类型与业务信息相比较，当符合后台任务条件时，就会产生后台任务信息，并根据相应配置进行信息发送。 后台任务条目配置节点位于：企业建模平台——后台任务平台——后台任务条目配置 后台任务条目的注册于V5类似，主要分为3个页签的信息，其中后台任务条件页签中，可选择已配置的消息模板，用于对消息文件内容的定义。组织单元字段，用于限定阈值参照的范围，组织单元参照的数组，由注册的后台任务类型决定。 如：A后台任务类型在注册时，指定了其组织类型为公司，则在注册A类型的后台任务条目a时，其组织单元参照的取值为公司参照，当指定组织单元数据，如公司1时，其相关的后台任务取值，均为公司1下的相关数据。 附：消息模板参照未完成（不可用） 后台任务监控 后台任务监控显示了所有在调度中，未执行完成的业务后台任务任务，其中执行按钮，可强制执行选中的任务，提前了下次执行的时间。 后台任务日志 后台任务日志显示了任务的每次执行结果，其中结果列显示了该次执行的结果（成功/失败） 后台任务插件类接口 public interface nc.bs.pub.taskcenter.IBackgroundWorkPlugin{ /** * 任务插件执行体 * @param context 执行环境 * @return * @throws BusinessException */ PreAlertObject executeTask(BgWorkingContext context) throws BusinessException; } executeTask(BgWorkingContext context)接口 BgWorkingContext /** 当前登录日期*/ private UFDate loginDate = null; /** 备份数据源 */