三、K3 Cloud 开发插件《K3 Cloud插件开发新手指导 + K3 Cloud插件开发代码调试》

2023-08-21 09:00:40

案例需求：在销售订单上新增一个按钮，在订单明细中新增一个字段，命名[即时库存]。

点击按钮，弹出“Hello World！”，并获取订单明细物料的即时库存，填入字段[即时库存]。

开发工具：Visual Studio 2012

开发语言：Asp.net C#

=================================

1、BOS单据加按钮 - -【测试按钮】

2、BOS单据加字段 - -[即时库存]

3、创建Visual C#类库

4、引入命名空间

5、编写按钮点击事件，建议用不带任何代码的空白事件进行测试

6、编译代码，生成DLL文件

7、插件注册

8、IIS重启

9、代码调试，确保事件是否成功触发

10、代码调试过程分析

=================================

1、BOS单据加按钮 - - 【测试按钮】

打开【金蝶K3 Cloud BOS集成开发平台】，右键点击【销售订单】，选择扩展（在扩展/继承模板才可加字段），

在【销售订单属性】窗口，点击【菜单集合】，在单据头新增按钮【测试按钮】。

在菜单编辑中，右键点击【工具条】，新增按钮【测试按钮】，标识为 “HelloWorld”。标识在插件代码中识别。

2、BOS单据加字段 - - [即时库存]

3、创建Visual C#类库

打开Visual Studio 2012，在菜单【文件】 - - 【新建】，点击【项目】，新建Visual C# 类库。

4、引入命名空间

5、编写按钮点击事件，建议用不带任何代码的空白事件

没有代码的空白事件如下，并设置断点调试：

这是完全代码如下：

using System;

using System.Collections.Generic;

using System.Text;

using Kingdee.BOS.Core.Bill.PlugIn;

using Kingdee.BOS.Core.DynamicForm;

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

using Kingdee.BOS.Orm.DataEntity;

using Kingdee.BOS.Core.Metadata.EntityElement;

using Kingdee.BOS;

using Kingdee.K3.MFG.App;

using System.Data;

namespace MyTest.K3.FIN.SE.FirstPlugIn

{

    public class Class1:AbstractBillPlugIn

    {

        public override void BarItemClick(BarItemClickEventArgs e)

        {

            base.BarItemClick(e);

            if (e.BarItemKey == "HelloWorld")  --HelloWorld是测试按钮的标识

            {

                this.View.ShowMessage("Hello world!", MessageBoxType.Notice);

                decimal jskc; //及时库存量

                string FNumber;//物料代码

                string FBillNo = "";

                DynamicObject docSCDDIds1 = this.View.Model.DataObject;

                FBillNo = docSCDDIds1["Date"].ToString(); --单据头订单编号取值，BillNo是订单编号的标识，在BOS中查看
                --获取单据体对象，并循环取单据体字段。FSaleOrderEntry是销售订单明细的单据体标识，在BOS中查看

                EntryEntity entryEntity = this.View.BusinessInfo.GetEntryEntity("FSaleOrderEntry");

                DynamicObjectCollection docCGSQIds = this.View.Model.GetEntityDataObject(entryEntity);

                StringBuilder sb = new StringBuilder();

                OrganizationInfo og = this.Context.CurrentOrganizationInfo;--取当前组织机构

                for (int i = ; i < docCGSQIds.Count; i++)

                {

                    jskc = ;

                    FNumber = "";

                    //算出物料代码

                    sb.AppendLine("select FNumber from T_BD_Material ");

                    sb.AppendLine("where (1=1)  ");

                    sb.AppendLine(string.Format("and FMaterialID={0}", docCGSQIds[i]["MaterialId_Id"]));

                    FNumber = AppServiceContext.DbUtils.ExecuteScalar<string>(Context, sb.ToString(), "", null);

                    sb.Remove(, sb.Length);//清空StringBuilder的方法

                    //更新及时库存,排除报废仓、不良品仓、默认库存状态：不良

                    sb.AppendLine("select isnull(SUM(t1.FBASEQTY),0) from T_STK_INVENTORY t1 ");

                    sb.AppendLine("inner join t_BD_Material t2 on t1.FMaterialID=t2.FMaterialID  ");

                    sb.AppendLine("where (1=1)  ");

                    sb.AppendLine(string.Format("and t2.FNumber='{0}' and t1.FKEEPERID={1} ", FNumber, og.ID));

                    using (IDataReader dr = AppServiceContext.DbUtils.ExecuteReader(Context, sb.ToString()))

                    {

                        while (dr.Read())

                        {

                            //entity.DataEntity["F_Dnk_JSKC"] = dr[0];

                            jskc = Convert.ToDecimal(dr[]);

                        }

                    }

                    sb.Remove(, sb.Length);//清空StringBuilder的方法

                    this.View.Model.SetValue("F_Dnk_JSKC", jskc, i); --单据体即时库存赋值

                }

                this.View.UpdateView("F_Dnk_JSKC");

            }

        }

    }

}