如何在插件中调用WebApi（保存、提交、审核、反审核、禁用、删除）

ctx

Context

系统全局信息，这里主要使用全局信息中的数据库连接信息

dataObject

DynamicObject

待保存的数据对象

businessInfo

BusinessInfo

待保存数据对象的元数据信息

option

OperateOption

自定义额外参数对象，服务端服务和服务端插件都能持有此对象

operationNumber

string

当前操作的操作码

using   Kingdee.BOS.Core.Bill.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.ServiceHelper;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyDynamicFormPlugIn

{

      [System.ComponentModel.Description("区分当前类应用在哪个模型上")]

      public class Class2 : AbstractBillPlugIn

      {

        public override void ButtonClick(ButtonClickEventArgs e)

        {

            //直接调用Orm保存，把数据保存到数据库

            BusinessDataServiceHelper.Save(this.Context, this.View.Model.DataObject);

            //执行保存服务端服务和保存操作的服务端插件

            BusinessDataServiceHelper.Save(this.Context, this.View.BusinessInfo, this.View.Model.DataObject);

        }

      }

}

using   Kingdee.BOS.Contracts;

using   Kingdee.BOS.Core.DynamicForm.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.Core.Metadata;

using   Kingdee.BOS.Orm.DataEntity;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyOperaionServicePlugIn

{

      [System.ComponentModel.Description("区分当前类应用在哪个操作上")]

      public class Class1 : AbstractOperationServicePlugIn

      {

        public override void BeforeExecuteOperationTransaction(

BeforeExecuteOperationTransaction e)

        {

            //例如：保存id为10001的物料

            //获取元数据服务

            IMetaDataService metadataService = Kingdee.BOS.App.ServiceHelper.GetService<IMetaDataService>();

            //获取保存服务

            ISaveService saveService = Kingdee.BOS.App.ServiceHelper.GetService<ISaveService>();

            //获取加载数据服务

            IViewService viewService = Kingdee.BOS.App.ServiceHelper.GetService<IViewService>();

            //获取物料元数据

            FormMetadata materialMetadata = metadataService.Load(this.Context,"BD_Material") as FormMetadata;

            //获取id为10001的物料数据

            DynamicObject[] objs = viewService.Load(

                this.Context,

                new object[] { 10001 },

                  materialMetadata.BusinessInfo.GetDynamicObjectType());

            //保存id为10001的物料

            saveService.Save(this.Context, objs);

            saveService.Save(this.Context, materialMetadata.BusinessInfo, objs);

        }

      }

}

ctx

Context

系统上下文全局信息，此处主要使用数据库链接信息

businessInfo

BusinessInfo

待执行提交服务的数据元数据描述信息

Ids

object[]

待执行提交服务的数据主键值数组

operationNumber

string

提交操作编码

option

OperateOption

业务控制额外参数集合，提交服务端服务和服务端插件都能持有此参数

using   Kingdee.BOS.Core.Base.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.ServiceHelper;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyDynamicFormPlugIn

{

      [System.ComponentModel.Description("区分当前类应用在哪个模型上")]

      public class Class3 : AbstractBasePlugIn

      {

        public override void ButtonClick(ButtonClickEventArgs e)

        {

            //例如：提交当前单据数据

            BusinessDataServiceHelper.Submit(

                this.Context,

                this.View.BusinessInfo,

                new object[] { this.View.Model.DataObject["Id"] },

                "Submit");

        }

      }

}

using   Kingdee.BOS.Contracts;

using   Kingdee.BOS.Core.DynamicForm.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.Core.Metadata;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyOperaionServicePlugIn

{

      public class Class2 : AbstractOperationServicePlugIn

      {

        public override void BeforeExecuteOperationTransaction(

BeforeExecuteOperationTransaction e)

        {

            //例如：提交id为10001的物料数据

            //获取提交服务

            ISubmitService submitService = Kingdee.BOS.App.ServiceHelper.GetService<ISubmitService>();

            //获取元数据服务

            IMetaDataService metadataService = Kingdee.BOS.App.ServiceHelper.GetService<IMetaDataService>();

            //获取物料元数据

            FormMetadata materialMetadata = metadataService.Load(this.Context, "BD_Material") as FormMetadata;

            //执行提交服务

            submitService.Submit(

                this.Context,

                  materialMetadata.BusinessInfo,

                new object[] { 10001 },

                "Submit");

        }

      }

}

ctx

Context

系统上下文全局信息

businessInfo

BusinessInfo

待审核\反审核数据的元数据描述信息

pkEntryIds

List<KeyValuePair<object, object>>

待审核\反审核数据的id集合，此场景key和value都是id的值

paras

List<object>

审核\反审核时附加的参数，包含两个值，第一个，同意与否，0：驳回；1：通过；2：反审核；第二个，审核意见，此参数默认可以为空

operationNumber

string

审核\反审核操作的操作码

option

OperateOption

额外业务选项，审核\反审核服务端服务和服务端插件都持有此对象

using   Kingdee.BOS.Core.DynamicForm;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.Core.List.PlugIn;

using   Kingdee.BOS.ServiceHelper;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyDynamicFormPlugIn

{

      [System.ComponentModel.Description("区分当前类应用在哪个模型上")]

      public class Class4 : AbstractListPlugIn

      {

        public override void ButtonClick(ButtonClickEventArgs e)

        {

            List<KeyValuePair<object,object>> lstKeyValuePairs = new List<KeyValuePair<object,object>>();

            KeyValuePair<object, object> keyValuePair = new KeyValuePair<object, object>(10001, "");

              lstKeyValuePairs.Add(keyValuePair);

            //审核id为10001的当前单据

            IOperationResult auditResult = BusinessDataServiceHelper.SetBillStatus(

                this.Context,

                this.View.BusinessInfo,

                lstKeyValuePairs,

                null,

                "Audit");

            //反审核id为10001的当前单据

            IOperationResult unAuditResult = BusinessDataServiceHelper.SetBillStatus(

                this.Context,

                this.View.BusinessInfo,

                lstKeyValuePairs,

                null,

                "UnAudit");

        }

      }

}

using   Kingdee.BOS.Contracts;

using   Kingdee.BOS.Core.DynamicForm;

using   Kingdee.BOS.Core.DynamicForm.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.Core.Metadata;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyOperaionServicePlugIn

{

      public class Class3 : AbstractOperationServicePlugIn

      {

        public override void BeforeExecuteOperationTransaction(

BeforeExecuteOperationTransaction e)

        {

            //审核\反审核id为10001的物料数据

            //获取单据状态转换服务

            ISetStatusService setStatusService = Kingdee.BOS.App.ServiceHelper.GetService<ISetStatusService>();

            //获取元数据服务

            IMetaDataService metaDataService = Kingdee.BOS.App.ServiceHelper.GetService<IMetaDataService>();

            //构建id为10001的数据集合

            List<KeyValuePair<object, object>> lstKeyValuePairs = new List<KeyValuePair<object, object>>();

            KeyValuePair<object, object> keyValuePair = new KeyValuePair<object, object>(10001, "");

              lstKeyValuePairs.Add(keyValuePair);

            //获取物料元数据

            FormMetadata materialMetaData = metaDataService.Load(this.Context, "BD_Material") as FormMetadata;

            //审核

            IOperationResult auditResult = setStatusService.SetBillStatus(

                this.Context,

                  materialMetaData.BusinessInfo,

                lstKeyValuePairs,

                null,

                "Audit");

            //反审核

            IOperationResult unAuditResult = setStatusService.SetBillStatus(

                this.Context,

                  materialMetaData.BusinessInfo,

                lstKeyValuePairs,

                null,

                "UnAudit");

        }

      }

}

ctx

Context

系统上下文全局信息

tableName

string

待执行update指令的表名

fieldName

string

待禁用的状态字段的字段名

fieldValue

string

待禁用的状态字段的目标值

pkFieldName

string

当前表的唯一标识字段名

pkFieldValues

object[]

当前表的唯一标示字段值集合

using   Kingdee.BOS.Core.DynamicForm.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.ServiceHelper;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyDynamicFormPlugIn

{

      public class Class5 : AbstractDynamicFormPlugIn

      {

        public override void ButtonClick(ButtonClickEventArgs e)

        {

            //禁用物料id为10001和10002的数据

            BusinessDataServiceHelper.SetState(

                this.Context,

                "T_BD_Material",

                "FForbidStatus",

                "B",

                "FMaterialdId",

                new object[] { 10001, 10002 });

        }

      }

}

using   Kingdee.BOS.Contracts;

using   Kingdee.BOS.Core.DynamicForm.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyOperaionServicePlugIn

{

      public class Class4 : AbstractOperationServicePlugIn

      {

        public override void BeforeExecuteOperationTransaction(

BeforeExecuteOperationTransaction e)

        {

            //获取数据服务

            IBusinessDataService businessDataService =

                Kingdee.BOS.App.ServiceHelper.GetService<IBusinessDataService>();

            businessDataService.SetState(

                this.Context,

                "T_BD_Material",

                "FForbidStatus",

                "B",

                "FMaterialId",

                new object[] { 10001, 10002 });

        }

      }

}

ctx

Context

系统上下文全局信息

Ids

object[]

待删除数据的id集合

dynamicObjectType

DynamicObjectType

待删除数据的动态实体类型

businessInfo

BusinessInfo

待删除数据的元数据描述信息

option

OperateOption

业务控制额外选项，删除的服务端服务和插件都能持有此对象

operationNumber

string

删除操作的操作码

using   Kingdee.BOS.Core.DynamicForm.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.Core.Metadata;

using   Kingdee.BOS.ServiceHelper;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyDynamicFormPlugIn

{

      public class Class6 : AbstractDynamicFormPlugIn

      {

        public override void ButtonClick(ButtonClickEventArgs e)

        {

            //删除id为10001和10002的物料

            //获取物料元数据

            FormMetadata materialMetadata =

                MetaDataServiceHelper.Load(this.Context,"BD_Material") as FormMetadata;

            // 模拟删除服务端操作完整过程

            BusinessDataServiceHelper.Delete(

                this.Context,

                  materialMetadata.BusinessInfo,

                new object[] { 10001, 10002 });

        }

      }

}

using   Kingdee.BOS.Contracts;

using   Kingdee.BOS.Core.DynamicForm.PlugIn;

using   Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using   Kingdee.BOS.Core.Metadata;

using   System;

using   System.Collections.Generic;

using   System.Linq;

using   System.Text;

using   System.Threading.Tasks;

namespace   MyOperaionServicePlugIn

{

      public class Class5 : AbstractOperationServicePlugIn

      {

        public override void BeforeExecuteOperationTransaction(

BeforeExecuteOperationTransaction e)

        {

            //获取删除服务

            IDeleteService deleteService =

                Kingdee.BOS.App.ServiceHelper.GetService<IDeleteService>();

            //获取元数据服务

            IMetaDataService metaDataService =

                Kingdee.BOS.App.ServiceHelper.GetService<IMetaDataService>();

            //获取物料元数据

            FormMetadata materialMetadata =

                metaDataService.Load(this.Context,"BD_Material") as FormMetadata;

            //执行删除服务的完整过程（推荐方式）

            deleteService.Delete(

                this.Context,

                  materialMetadata.BusinessInfo,

                new object[] { 10001, 10002 });

            // 直接执行数据删除 (风险极高，仅适用于未定义单据，只是利用ORM模型存取数据的情况）

// 调用此服务会跳过删除校验，仅删除ORM模型内含表格的数据，其他相关数据不会处理，如果有上下游单据及反写，不会撤销关联及回滚反写，从而造成数据错误！

            deleteService.Delete(

                this.Context,

                new object[] { 10001, 10002 },

                  materialMetadata.BusinessInfo.GetDynamicObjectType());

        }

      }

}