【Python插件入门】第10篇(完结篇)：插件常用工具类分享
往期回顾：
【Python插件入门】第1篇：Python插件入门讲解
【Python插件入门】第2篇：基本开发过程介绍
【Python插件入门】第3篇：插件中如何进行数据操作
【Python插件入门】第4篇：单据表单插件
【Python插件入门】第5篇：单据列表插件
【Python插件入门】第6篇：操作服务插件
【Python插件入门】第7篇：简单账表服务插件
【Python插件入门】第8篇：账表表单插件
【Python插件入门】第9篇：单据转换插件
前面9篇已经把Python插件常用的插件类型介绍完了，相信大家对Python插件开发以及各种插件的属性成员和事件已经有了一个整体的认识和了解，我们在插件开发中经常还会用到一些通用的工具类，来帮助我们实现功能逻辑，这一篇作为【Python插件入门讲解】的完结篇，分享一些常用工具类的使用代码，供大家参考。
这里用一个服务插件作为示例，演示一下这些工具类的使用，示例代码已上传附件！
一、读取单据的数据包
MetaDataServiceHelper.Load:读取单据的元数据
需要添加相关引用:
clr.AddReference('Kingdee.BOS.ServiceHelper')
from Kingdee.BOS.ServiceHelper import *
formID="PUR_PurchaseOrder";#单据FormId
meta = MetaDataServiceHelper.Load(this.Context, formID);#读取单据的元数据
QTWLMeta=MetaDataServiceHelper.GetFormMetaData(this.Context, formID);#读取单据元数据
BusinessDataServiceHelper.Load:读取单据的完整数据包
需要添加相关引用:
clr.AddReference('Kingdee.BOS.ServiceHelper')
from Kingdee.BOS.ServiceHelper import *
pkIds = List[object]();#需要获取的单据ID集合
pkIds.Add(10001);
objType=meta.BusinessInfo.GetDynamicObjectType();#获取单据数据包的对象类型
#这里顺带提一下,如果是修改单据数据包中的基础资料/辅助资料字段*******************************************
#读取基础资料字段数据包赋值给基础资料字段时，不能使用meta.BusinessInfo.GetDynamicObjectType()
baseFld=this.BusinessInfo.GetField("字段标识");
#应该按此方法获取objType，这样获取到的基础资料不是完整的数据包
#而是根据单据字段引用属性加载的字段,这样的数据包赋值给单据中的资料字段才合适
objType=baseFld.RefFormDynamicObjectType;
#***********************************************************************************************************
#根据单据内码集合读取多个单据的完整数据包
billObjs=BusinessDataServiceHelper.Load(this.Context, pkIds.ToArray(),objType);
#根据单据内码读取一个单据的完整数据包
obj=BusinessDataServiceHelper.LoadSingle(this.Context, "10001", objType);
QueryServiceHelper.GetDynamicObjectCollection:根据需要的字段读取单据数据包
需要添加相关引用:
clr.AddReference('Kingdee.BOS.Core')
from Kingdee.BOS.Core.SqlBuilder import *
from Kingdee.BOS.Core.Metadata import*
#通过构建QueryBuilderParemeter取数****************************************************************
queryParam=QueryBuilderParemeter();
queryParam.FormId=formID;
queryParam.BusinessInfo=meta.BusinessInfo;
billId=SelectorItemInfo(meta.BusinessInfo.GetForm().PkFieldName);#单据内码
queryParam.SelectItems.Add(billId);
billNo=SelectorItemInfo("FBillNo");#单据编号
queryParam.SelectItems.Add(billNo);
supplierId=SelectorItemInfo("FSupplierId");#供应商内码
queryParam.SelectItems.Add(supplierId);
supplierName=SelectorRefItemInfo("FSupplierId.FName");#取基础资料属性字段写法不一样,要注意
supplierName.PropertyName="FSupplierId_FName";#后台是SQL取数，字段名不能有".",要重命名
queryParam.SelectItems.Add(supplierName);
entity=meta.BusinessInfo.GetEntity("单据体标识");
queryParam.FilterClauseWihtKey="过滤条件";
#按单据体ID过滤，关键字要写成"单据体标识_FEntryId"
queryParam.FilterClauseWihtKey=("{0}_{1}={2}").format(entity.Key,entity.EntryPkFieldName,entryId);
dataRows=QueryServiceHelper.GetDynamicObjectCollection(this.Context, queryParam);#获取数据结果数据包
for r in dataRows:#循环获取结果数据包中的字段值
billNoValue=r["FBillNo"];
#QueryServiceHelper示例结束***********************************************************************
二、保存单据的数据包，调用单据保存、提交、审核等操作
BusinessDataServiceHelper.Save:调用单据保存操作，将单据数据包保存到数据库，会触发操作服务插件
需要添加相关引用:
clr.AddReference('Kingdee.BOS')
from Kingdee.BOS.Orm.DataEntity import *
ObjList=List[DynamicObject]();#单据的数据包集合
ObjList.Add(billObjs[0]);
#注意！调用保存时，传入的必须是完整的单据数据包
#Q:既然是Save方法，为什么还要传操作代码"Save"呢？
#A:Save方法调用的是单据操作列表中,"操作类型=保存"的操作，可以为单据添加多个"操作类型=保存"的操作。
#例如,可以添加一个"OnlySave",这个操作不注册任何服务插件和服务端服务，仅用于保存单据数据到数据库
saveRslt=BusinessDataServiceHelper.Save(this.Context, meta.BusinessInfo,ObjList.ToArray(), None, "Save");
if(saveRslt.IsShowMessage):#读取保存操作结果数据
OperationResultExt.MergeValidateErrors(saveRslt);
msg="";
for rst in saveRslt.OperateResult:
msg=("{0}\r\n{1}").format(msg,rst.Message);#拼接提示信息
BusinessDataServiceHelper.Submit:调用单据提交操作，不会触发审批流，提交触发审批流参考传送门
if (saveRslt.SuccessDataEnity<>None):#存在保存成功的数据
ids=List[object]();#单据内码集合
for newBillObj in saveResult.SuccessDataEnity:
newBillId=newBillObj["Id"];
ids.Add(newBillId);
subRslt=BusinessDataServiceHelper.Submit(this.Context,meta.BusinessInfo,ids.ToArray(),"Submit",None);
BusinessDataServiceHelper.Audit:调用单据审核操作，会触发操作服插件和服务端服务
if (subRslt.IsSuccess == True):
BusinessDataServiceHelper.Audit(this.Context,meta.BusinessInfo,ids.ToArray(),None);
BusinessDataServiceHelper.DoNothing:调用单据空操作，会触发操作服插件和服务端服务
#假设单据配置了一个自定义空操作，空操作配置了自动下推服务，就可以调用空操作实简单实现调用单据下推。
optCode="DoNothing-AutoPush";#自定义空操作代码
PkIds=List[object]();#执行空操作的单据内码集合
PkIds.Add("10001");
BusinessDataServiceHelper.DoNothing(this.Context, meta.BusinessInfo, PkIds.ToArray(), optCode, None);
三、插件构建新单据的数据包，生成单据
看了前面BusinessDataServiceHelper工具类的介绍，我们可以先Load单据数据包，然后修改数据包之后，调用Save方法，实现通过修改单据数据包的方式来修改单据，由于是后台，这种方法的缺点是，不会触发单据界面服务(实体服务规则、值更新事件、表单插件等)，当我们修改单个字段，或者可以传入相关的所有字段时，可以使用。
既然可以通过这种方法来修改单据，那当然也可以用来生成单据，下面介绍插件中生成单据的2种方法。
①构建一个新的空白单据数据包，然后通过数据包操作赋值后，调用Save方法生成单据。不会触发单据界面服务
formID="FIN_OTHERS";
QTWLMeta=MetaDataServiceHelper.GetFormMetaData(this.Context, formID);#读取其他往来单位元数据
QTWLType = QTWLMeta.BusinessInfo.GetDynamicObjectType();
QTWLBillObj = DynamicObject(QTWLType);
QTWLBillObj["Number"]="Test001";#编码赋值
QTWLBillObj["Name"]="测试其他往来单位";#名称赋值
Orgmeta = MetaDataServiceHelper.Load(this.Context, "ORG_Organizations");#获取组织员数据
orgId="1";#创建组织和使用组织一致，使用同一个组织ID
createOrgFld=QTWLMeta.BusinessInfo.GetField("FCreateOrgId");
useOrgFld=QTWLMeta.BusinessInfo.GetField("FUseOrgId");
createOrgObj=BusinessDataServiceHelper.LoadSingle(this.Context, orgId, createOrgFld.RefFormDynamicObjectType);
useOrgObj = BusinessDataServiceHelper.LoadSingle(this.Context, orgId, useOrgFld.RefFormDynamicObjectType);
QTWLBillObj["CreateOrgId"]=createOrgObj;#创建组织赋值
QTWLBillObj["CreateOrgId_Id"]=orgId;
QTWLBillObj["UseOrgId"]=useOrgObj;#使用组织赋值
QTWLBillObj["UseOrgId_Id"]=orgId;
QTWLObjList=List[DynamicObject]();
QTWLObjList.Add(QTWLBillObj)
saveRslt=BusinessDataServiceHelper.Save(this.Context, QTWLMeta.BusinessInfo,QTWLObjList.ToArray(), None, "Save");
②构建一个单据视图View，通过View操作单据数据包，就可以触发界面服务了，修改单据同样适用！
需要添加相关引用:
clr.AddReference('Kingdee.BOS.Core')
clr.AddReference('Kingdee.BOS.ServiceHelper')
from Kingdee.BOS.Core.Metadata import*
from Kingdee.BOS.ServiceHelper import *
from Kingdee.BOS.Core.Metadata.FormElement import*
from Kingdee.BOS.Core.Bill import *
from Kingdee.BOS.Core.DynamicForm import *
from Kingdee.BOS.Core.DynamicForm.PlugIn import *
from Kingdee.BOS.Core.DynamicForm.PlugIn.Args import *
from Kingdee.BOS.Core.DependencyRules import *#触发实体服务规则需要添加此引用
#自定义方法：创建单据视图View
def CreateBillView(ctx,formId,billId):
#读取元数据
meta = MetaDataServiceHelper.Load(ctx, formId);
form = meta.BusinessInfo.GetForm();
#创建用于引入数据的单据view
tp = Type.GetType("Kingdee.BOS.Web.Import.ImportBillView,Kingdee.BOS.Web");
billView = Activator.CreateInstance(tp);
openParam = CreateOpenParameter(meta, ctx,billId);#调用自定义方法获得单据打开参数
provider = form.GetFormServiceProvider();
billView.Initialize(openParam, provider);
return billView;
#自定义方法：构建单据打开参数
def CreateOpenParameter(meta, ctx,billId):
form = meta.BusinessInfo.GetForm();
openParam = BillOpenParameter(form.Id, meta.GetLayoutInfo().Id);
openParam.Context = ctx;
openParam.ServiceName = form.FormServiceName;
openParam.PageId = Guid.NewGuid().ToString();#随机产生一个不重复的PageId，作为视图的标识
openParam.FormMetaData = meta;
#单据ID为空是新增，不为空则认为是修改,若是修改方式EDIT打开单据，会触发网控，注意后面要释放
openParam.Status = OperationStatus.ADDNEW if(billId==None) else OperationStatus.EDIT;
if(billId<>None):#若传入了具体单据ID，将ID传入单据打开参数
openParam.PkValue = billId;
openParam.CreateFrom = CreateFrom.Default;
openParam.DefaultBillTypeId = "";
openParam.SetCustomParameter("ShowConfirmDialogWhenChangeOrg", False);#主业务组织改变时，不用弹出提示界面
plugs = form.CreateFormPlugIns();
openParam.SetCustomParameter(FormConst.PlugIns, plugs);
args = PreOpenFormEventArgs(ctx, openParam);
for plug in plugs:
plug.PreOpenForm(args);
if (args.Cancel == True):
s="不处理";#不理会插件PreOpenForm事件中的诉求,也就是说会强制打开单据
return openParam;
#自定义方法：演示创建一个二开的单据,通过View构建单据数据包
def CreateBillObj():
formID="ORA_TestBill";#单据FormId
meta=MetaDataServiceHelper.GetFormMetaData(this.Context, formID);
#创建一个新单据View,billId传空，若为修改单据，可传具体单据ID
billView = CreateBillView(this.Context, formID,None);
billView.LoadData();
dynamicFormView =billView;
dynamicFormView.SetItemValueByID("F_RBSU_OrgId",orgId,0);#给表头组织赋值
dynamicFormView.UpdateValue("FBillNo",0,"Test001");#给单据编号赋值
dynamicFormView.UpdateValue("F_RBSU_Remark",0,"测试插件创建");#给表头备注赋值
#通过View获取单据的完
【Python插件入门】第10篇(完结篇)：插件常用工具类分享
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
