三、K3 Cloud 開發插件《K3 Cloud插件開發新手指導 + K3 Cloud插件開發代碼調試》

本文轉載自查看原文 2017-12-03 19:16 15356 Z：金蝶開發實施(K3Cloud)

案例需求：在銷售訂單上新增一個按鈕，在訂單明細中新增一個字段，命名[即時庫存]。

點擊按鈕，彈出“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 = 0; i < docCGSQIds.Count; i++)
                {
                    jskc = 0;
                    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(), "0", null);
                    sb.Remove(0, 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[0]);
                        }
                    }
                    sb.Remove(0, sb.Length);//清空StringBuilder的方法

                    this.View.Model.SetValue("F_Dnk_JSKC", jskc, i); --單據體即時庫存賦值
                }
                this.View.UpdateView("F_Dnk_JSKC");
            }
        }

    }
}