流程插件开发系列1:审批动作服务插件,可输出审批人到单据
背景:
流程审批过程中,用户希望同时做一些其他的数据处理,比如将当前审批节点的审批人、审批意见等信息输出到单据上,就可以通过审批动作服务插件实现。
此前比较遗憾的是在服务插件中无法获取流程信息;很高兴地告诉各位伙伴们,在K/3 Cloud_V6.X补丁(2017-04-21)、以及预计V7.0,支持在服务插件获取流程任务信息。新版本的工作流将逐步开放插件体系,以增强个性化定制开发。
1. 如何开发审批动作服务插件
审批动作服务插件,开发过程和通用的服务插件一样,本文主要介绍如何在插件中与流程进行交互;在K/3 Cloud_V6.X补丁(2017-04-21)、新版本V7.0支持从服务插件获取流程任务信息。
服务插件开发请参考K3Cloud在线SDK文档,http://open.kingdee.com/K3Cloud/SDK/webframe.html:使用教程> 插件开发 > 单据插件开发 > 创建一个业务单据操作服务插件。
1.1. 示例插件代码
以下示例插件,举例说明在用户审批的时候,如何获取一级审批节点的审批人、审批意见信息,并输出到单据上,示例未经测试仅供参考思路。首先到K/3 Cloud安装目录的WebSite\Bin子目录,引用如下基本组件(其他组件按需引用):
Kingdee.BOS.dll
Kingdee.BOS.Contracts.dll
Kingdee.BOS.Core.dll
Kingdee.BOS.DataEntity.dll
Kingdee.BOS.ServiceHelper.dll
2017-06-21 14:51 上传
using Kingdee.BOS.Contracts;
using Kingdee.BOS.Core.Const;
using Kingdee.BOS.Core.DynamicForm.PlugIn;
using Kingdee.BOS.Core.Metadata;
using Kingdee.BOS.Orm.DataEntity;
using Kingdee.BOS.Workflow.Interface;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace Demo.Workflow.ServicePlugIn
{
/// <summary>
/// 输出审批人、审批意见到单据上
/// </summary>
[Description("服务插件,输出审批人、审批意见到单据上")]
public class ApprovalInfoServicePlugIn : AbstractOperationServicePlugIn
{
private const string KEY_User1 = "FUserId1_Id";
private const string KEY_Opinion1 = "FRemarks1";
private const string KEY_TaskTitle1 = "FTaskTitle1";
private const int KEY_FirstNodeId = 5;
public override void EndOperationTransaction(Kingdee.BOS.Core.DynamicForm.PlugIn.Args.EndOperationTransactionArgs e)
{
base.EndOperationTransaction(e);
// 获取流程任务信息
var activityCollection = this.Option.GetVariableValue<ObjectActivityInstanceCollection>(BOSConst.CST_KEY_WfActivityInstance, null);
if (activityCollection != null)
{
IMetaDataService metaService = ServiceFactory.GetMetaDataService(this.Context);
IViewService viewService = ServiceFactory.GetViewService(this.Context);
List<DynamicObject> rowList = new List<DynamicObject>();
// 每个任务传入一个ObjectActivityInstance对象,批量审批任务时会传入多个对象
foreach (ObjectActivityInstance actRow in activityCollection)
{
// 本例演示获取当前处理人的信息(每个任务可能有多个处理人,所有处理人存储在ReceiverList属性中)
IActivityInstance actInstance = actRow.ActivityInstance;
var currentReceiver =actInstance.CurrentReceiver;
// 加载单据数据
FormMetadata rowMeta = metaService.Load(this.Context, actRow.ObjectFormId, true) as FormMetadata;
var rowData = viewService.LoadSingle(this.Context, actRow.ObjectKeyValue,rowMeta.BusinessInfo.GetDynamicObjectType());
// 根据节点ID把审批人等信息输出到相应字段上,比如一级审核节点(如何查询节点ID参见下文)的审批人输出到FUserId1字段上
if (actInstance.ActivityDefineId ==KEY_FirstNodeId && currentReceiver != null)
{
// 可以输出审批人、意见、所选审批项、审批时间、任务标题信息
rowData[KEY_User1] = currentReceiver.ReceiverUserId;
rowData[KEY_Opinion1] = currentReceiver.ActionOpinion;
rowData[KEY_TaskTitle1] = currentReceiver.TaskTitle;// 任务标题属性,预计在8月后的补丁支持
}
rowList.Add(rowData);
}
if (rowList.Count > 0)
{
ISaveService saveService = ServiceFactory.GetSaveService(this.Context);
saveService.Save(this.Context, rowList.ToArray());
}
}
}
}
}
1.2. 如何查询节点ID
首先在流程设计页面双击空白处,在弹出的“流程设置”页面勾选“显示节点ID”:
2017-06-21 14:52 上传
然后双击目标节点打开“节点设置”页面,就可以看到节点ID:
2017-06-21 14:55 上传
2. 如何注册审批动作服务插件
熟悉的伙伴可以略过下文。
先在操作上配置服务插件,然后在节点的审批项上配置操作。
对于有审核操作的终审节点,可以在审核操作上配置服务插件。
打开BOS设计器中目标单据的操作列表,在审核操作上配置服务插件:
2017-06-21 14:56 上传
在终审节点审批项上配置审核操作:
2017-06-21 14:57 上传
对于没有审核操作的普通节点,可以在审批项上配置空操作,然后在空操作上配置服务插件。
打开BOS设计器中目标单据的操作列表,新增用于输出审批人的空操作,并配置服务插件:
2017-06-21 14:57 上传
在普通节点审批项上配置该空操作:
2017-06-21 14:58 上传
流程插件开发系列1:审批动作服务插件,可输出审批人到单据
本文2024-09-23 03:36:57发表“云星空知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-k3cloud-159984.html