金蝶雲星空之表單插件的開發

時間 2020-06-03

標籤星空表單插件開發欄目 HTML 简体版

原文原文鏈接

前言:

學習金蝶軟件過程當中學習到的東西，作總結，方便往後查閱！

新建開發解決方案、調試與值監視

\1. 新建解決方案。
名稱空間：命名要求表達準確，無歧義web

\2. 斷點調試。sql

\3. 值監控。數據庫

FCustomerID數組

this.View.Model.GetValue("FCustomerID")瀏覽器

表單插件的賦值與取值GetValue和SetValue

引用 using Kingdee.BOS.Core.Bill.PlugIn;
this.View.Model.SetValue this.View.Model.GetValue服務器

--插件說明 [Description("表單插件")]ide

--熱啓動 [Kingdee.BOS.Util.HotUpdate]學習

單據體取值和賦值GetValue和SetValue

表單插件
引用 using Kingdee.BOS.Core.Bill.PlugIn;測試

this.View.Model.SetValue this.View.Model.GetValuethis

--插件說明 [Description("表單插件")]

--熱啓動 [Kingdee.BOS.Util.HotUpdate]

--調用值更新事件 this.View.InvokeFieldUpdateService

表單插件的經常使用方法

經常使用的表單插件屬性

this.View.GetFormTitle()------獲取單據標題

this.View.Model.DataObject["Id"]---獲取表單Fid

this.View.Model.GetPKValue---獲取表單Fid

this.View.GetControl("F_PAEZ_Remarks ").SetFocus()-------設置焦點

this.View.GetControl("F_PAEZ_Remarks").Enabled = false; ----鎖定字段

this.View.GetFieldEditor("F_PAEZ_Remarks ", 0).Enabled = false;----單據體行鎖定字段

this.View.GetControl("F_PAEZ_Remarks").Visible = false; ----隱藏字段

this.View.GetMainBarItem("tbSave").Enabled = false;----鎖定按鈕

this.View.GetMainBarItem("tbSave").Visible = false;---- 隱藏按鈕

this.View.UpdateView("F_SB_SumOutAmount")前臺刷新，不和服務器交互。

this.View.Refresh----整個頁面刷新，要和服務器交互，把後臺數據庫數據刷新過來

this.View.InvokeFormOperation("Save")---調用表單事件

經常使用的單據體屬性插件

this.View.Model.DeleteEntryData("FEntity");--刪除單據體信息

this.View.Model.DeleteEntryRow("FEntity",0);--刪除單據體信息

this.View.Model.CreateNewEntryRow("FEntity");-建立新行

this.View.Model.CopyEntryRow("FEntity",0,1,false);--複製一行。

this.View.Model.GetEntryPKValue("FEntity", 0);--獲取單據體FENTRYID內碼

this.View.Model.GetEntryRowCount("FEntity")---獲取單據體行數。

表單插件的經常使用提示框

經常使用的提示信息框
\1.

this.View.ShowMessage("你好");

\2.

this.View.ShowErrMessage("錯誤信息提示");

\3.

引用using Kingdee.BOS.Core.DynamicForm;

this.View.ShowMessage("信息提示？",

MessageBoxOptions.YesNo, new Action<MessageBoxResult>((result) =>

{

if (result == MessageBoxResult.Yes)

{

}

else if (result == MessageBoxResult.No)

{

return;

}

}));

提示信息：

終止、重試、忽略

是、否、取消

\4. 警告

this.View.ShowWarnningMessage("不能對其進行操做，請確認。", action:(result) =>
{
this.View.Close();
});

表單插件之經常使用事件

BarItemClick點擊事件

public override void BarItemClick(Core.DynamicForm.PlugIn.Args.BarItemClickEventArgs e)

e.BarItemKey方法

e.Cancel方法

BeforeSave點擊事件

public override void BeforeSave (Core.DynamicForm.PlugIn.Args.BeforeSaveEventArgs e)

\1. e.Cancel方法

AfterSave點擊事件

public override void AfterSave(Kingdee.BOS.Core.Bill.PlugIn.Args.AfterSaveEventArgs e)

e.OperationResult.IsSuccess方法

引用using Kingdee.BOS.App.Data;

執行sql語句 /*dialect*/

DataChanged點擊事件

public override void DataChanged(DataChangedEventArgs e)

e.Field.Key---變化的值

e.NewValue---變化後的值

e.OldValue---變化前的值

e.Row----單據體變化的行。

AfterBindData事件

public override void AfterBindData(EventArgs e)

這個是一個數據綁定後事件。這個事件是單據新增，編輯，查詢加載後最後一個事件。

this.View.OpenParameter.Status.Equals(OperationStatus.ADDNEW)

這個方法是判斷單據狀態。有四種：ADDNEW、EDIT、VIEW、DISASSEMBLY

新增、編輯、查看、卸載

CustomEvents事件之簡單的條碼掃描實例：

---用到的事件

public override void CustomEvents(CustomEventsArgs e)

條碼示例：

[1.01.001@20190102@190102@TS00001](mailto:1.01.001@20190102@190102@TS00001)

1.01.002@20190202@190202@TS00002

1.01.231-0298-000@20181202@191202@TS00003

CH4441@20181202@191202@TS00004

用到如下方法：

e.Key.Equals("F_SB_TM")----判斷變動的是那個元素控件

e.EventName == "EnterKeyPressed"----捕獲回車事件

this.View.GetControl("F_SB_TM").SetFocus();----設置焦點

-----字符串拆分數組

string[] strArray = this.View.Model.GetValue("FScomOne").ToString().Trim().Split('@');

--獲取單據體行數

this.Model.GetEntryRowCount("FEntity");

-----建立新行

this.View.Model.CreateNewEntryRow("FEntity");

-----彈出錯誤提示，清空數據，指向焦點。

this.View.ShowMessage("條碼位數出錯，請檢查。。。", MessageBoxOptions.OK,

new Action<MessageBoxResult>((result) =>

{

this.Model.SetValue("F_SB_TM", "");

this.View.GetControl("F_SB_TM").SetFocus();

}));

表單插件之讀寫數據庫

引用dll
Kingdee.BOS.dll

Kingdee.BOS.Core.dll

Kingdee.BOS.App.dll

Kingdee.BOS.Orm.DataEntity.dll

使用using

using System;

using System.Collections.Generic;

using Kingdee.BOS.Core.Bill.PlugIn;

using Kingdee.BOS.Core.DynamicForm;

using Kingdee.BOS.App.Data;

using System.Data;

using Kingdee.BOS.Orm.DataEntity;

**一．執行sql語句返回Int，表示影響了多少行**

DBUtils.Execute(this.Context, "/*dialect*/update T_SAL_OUTSTOCKENTRY set FNOTE='測試'");

**二．執行sql語句返回DataSet**

DataTable dt = DBUtils.ExecuteDataSet(this.Context, "/*dialect*/select FMATERIALID,FNumber from T_BD_MATERIAL where FUSEORGID=100006").Tables[0];

for (int i = 0; i < dt.Rows.Count; i++)

{

this.View.Model.CreateNewEntryRow("FEntity");

this.View.Model.SetValue("FMaterialID", dt.Rows[i]["FMATERIALID"].ToString(), i);

this.View.InvokeFieldUpdateService("FMaterialID", i);

this.View.Model.SetValue("FEntrynote", dt.Rows[i]["FNumber"].ToString(), i);

}

this.View.UpdateView("FEntity");

**三．執行sql語句返回IEnumerable**

IEnumerable<IDataRecord> itemDataTable = DBUtils.ExecuteEnumerable(this.Context, "/*dialect*/select FMATERIALID,FNumber from T_BD_MATERIAL where FUSEORGID=100006");

int i = 0;

foreach (IDataRecord drItem in itemDataTable)

{

this.View.Model.CreateNewEntryRow("FEntity");

this.View.Model.SetValue("FMaterialID", drItem["FMATERIALID"].ToString(), i);

this.View.InvokeFieldUpdateService("FMaterialID", i);

this.View.Model.SetValue("FEntrynote", drItem["FNumber"].ToString(), i);

i++;

}

this.View.UpdateView("FEntity");

**四．執行sql語句返回DynamicObjectCollection**

DynamicObjectCollection Dyobj = DBUtils.ExecuteDynamicObject(this.Context, "/*dialect*/select FMATERIALID,FNumber from T_BD_MATERIAL where FUSEORGID=100006");

int j = 0;

foreach(DynamicObject obj in Dyobj)

{

this.View.Model.CreateNewEntryRow("FEntity");

this.View.Model.SetValue("FMaterialID", obj["FMATERIALID"].ToString(), j);

this.View.InvokeFieldUpdateService("FMaterialID", j);

this.View.Model.SetValue("FEntrynote", obj["FNumber"].ToString(), j);

j++;

}

this.View.UpdateView("FEntity");

表單插件之Context屬性

上下文，記錄一些公用的信息，好比當前登錄用戶、組織、鏈接的數據庫、區域等等信息，只要是基於Cloud的開發，基本不多有不用的時候。

CurrentOrganizationInfo

當前組織信息

CurrentOrganizationInfo.ID

當前登陸組織id

CurrentOrganizationInfo.Name

當前登陸組織的名稱

CurrentUserTimeZone

當前用戶時區

DatabaseType

數據庫類型

IsMultiOrg

是不是多組織數據中心

UserId

當前用戶Id

UserName

當前用戶名稱

DBId

數據庫ID

UserEmail

登陸用戶郵箱

UserPhone

登陸用戶移動電話

調用系統單據列表界面並返回數據

引用：
Kingdee.BOS.dll

Kingdee.BOS.Core.dll

Kingdee.BOS.DataEntity

使用

using System;

using Kingdee.BOS;

using Kingdee.BOS.Core.Bill.PlugIn;

using System.ComponentModel;

using Kingdee.BOS.Core.List;

using Kingdee.BOS.Core.Enums;

using Kingdee.BOS.Core.DynamicForm;

新建一個listShowParameter實例

ListShowParameter listShowParameter = new ListShowParameter();

\1. FormId你要調用那個單據的列表。

listShowParameter.FormId = "SAL_SaleOrder";

\2. IsLookUp彈出的列表界面是否有「返回數據」按鈕

listShowParameter.IsLookUp = true;

\3. 列表顯示類型

顯示基本信息

listShowParameter.ListType = Convert.ToInt32(BOSEnums.Enu_ListType.BaseList);

所有顯示

listShowParameter.ListType = Convert.ToInt32(BOSEnums.Enu_ListType.List);

\4. 是否顯示覆選框。默認是true，若是false就是不顯示

listShowParameter.MultiSelect = false;

\5. 接受返回值

this.View.ShowForm(listShowParameter, delegate(FormResult result)

{

object returnData = result.ReturnData;

if (returnData is ListSelectedRowCollection)

{

ListSelectedRowCollection listSelectedRowCollection = returnData as ListSelectedRowCollection;

if (listSelectedRowCollection != null)

{

DynamicObjectDataRow datarow = (DynamicObjectDataRow)listSelectedRowCollection[0].DataRow;

this.View.Model.SetValue("F_PAEZ_Text",datarow.DynamicObject["FID"].ToString()) ;

}

}

});

表單插件之打開外部頁面

JSONObject webobj = new JSONObject();
webobj["source"] = @"http://www.baidu.com";

webobj["height"] = 600;

webobj["width"] = 910;

webobj["isweb"] = false; //是否新彈出一個瀏覽器窗（or選項卡）打開網頁地址金蝶軟件學習總結

前言: