欢迎来到天天文库
浏览记录
ID:13730053
大小:345.50 KB
页数:8页
时间:2018-07-24
《u810.0插件开发和注册》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库。
1、U810.0插件开发和注册U8API和插件框架U810.0插件开发和注册袁昌龙U8平台及公共开发部2011-02-23目录1插件开发21.1插件事件定义21.2插件上下文21.3特别注意32插件注册32.1注册同步插件42.2注册异步插件7第8页,共8页U810.0插件开发和注册U8API和插件框架1插件开发按照设计时约定,U8插件事件定义采用如下规范:包括一个errMsg参数(最后一个),同时返回值一般为bool类型。1.1插件事件定义典型插件事件定义如下:boolPluginEventInterf
2、ace(...,stringerrMsg)插件最后一个参数为返回错误信息,参数名可以不为errMsg,可定义为其他任何名称并且大小写不受限制;插件执行成功与否,通过返回Bool类型值判断。其他参数,不同档案或单据不一样,可以在“UAP”目录下的“U8API资源管理器”中,请选择关注的档案或单据的事件节点下查看,在此不赘述。1.2插件上下文插件事件接口参数中,没有定义Login、连接对象等环境参数,但在插件内部可以通过上下文对象获取这些信息,如下代码(VB)所示:第8页,共8页U810.0插件开发和注册
3、U8API和插件框架'**********获取插件上下文信息:登录对象、连接、事件ID***************'请引用TLB文件:U8SOFTUFMOMU8APIFrameworkUFIDA.U8.MomServiceCommon.tlb'获取插件上下文DimenvCtxCacheAsNewUFIDA_U8_MomServiceCommon.MomCallContextCacheDimenvCtxAsUFIDA_U8_MomServiceCommon.MomCallContextSeten
4、vCtx=envCtxCache.CurrentMomCallContext'从上下文获取U8Login对象DimloginAsObjectSetlogin=envCtx.U8Login'从上下文获取帐套库连接对象DimconnAsADODB.ConnectionSetconn=envCtx.BizDbConnection'从上下文获取事件IDDimeventIdAsStringeventId=envCtx.EventIdentity'获取其它用户自定义上下文'IfenvCtx.HasEnvConte
5、xt("用户自定义上下文ID")Then'userCtxValue=envCtx.GetEnvContext("用户自定义上下文ID")'EndIf'***********end*****************************************************1.3特别注意插件开发特别需要注意:1)开发的插件接口必须与相应的档案或单据的插件事件定义相匹配。如果不匹配,则不允许注册在该插件事件下;一个插件事件下可以定义多个插件,而一个插件则必须属于某个插件事件;2)插件事件接口参
6、数中,没有定义Login、连接对象等环境参数,但在插件内部可以通过上下文对象获取这些信息,按如上代码所示。2插件注册在“开始”->“程序”->“用友ERP-U8”->“UAP”目录下找到“U8API资源管理器”,单击,登录,进入“U8API资源管理器”。为方便统一管理,在注册插件之前,先查找插件所属的业务模块,然后找到相应的插件事件。在插件事件节点下,可以看到第8页,共8页U810.0插件开发和注册U8API和插件框架两种类型的插件节点:同步插件和异步插件。在“同步插件”下注册插件,会注册同步插件;在
7、“异步插件”下注册插件,会注册异步插件。2.1注册同步插件右键单击“同步插件”,选择“所有任务”->“注册同步插件”,弹出“注册新的同步插件”对话框,填入插件编码和插件名称(注意插件编码不要和已有的插件编码重复,会自动检验!)。然后选择该插件关联的帐套,如果不选,默认关联所有的帐套,即“ALL”,如下图1所示:图1注册同步插件另外,需要重点说明的是,对同步插件而言,支持按顺序执行插件。在注册的时候,可以设置插件的执行顺序,比如,有三个插件:同步插件1、同步插件2和同步插件3,现在需要将它们的执行顺序调
8、整为:先执行同步插件2,然后执行同步插件1,最后执行同步插件3。可以单击同步插件2的“设置插件执行顺序”,弹出对话框,通过方向键和调整同步插件2的执行顺序,将同步插件2的调整至同步插件1前执行即可,如下图2所示:第8页,共8页U810.0插件开发和注册U8API和插件框架图2调整同步插件执行顺序设置完插件的基本信息后,需要进行重要的“插件定义”,单击“插件定义/描述”页签,单击“修改”,选择“插件类型”(即是.net插件,还是Com插件),如下图3所示:
此文档下载收益归作者所有