利用erp系統開發接口定制簡單外掛kf05-01

外掛程序介紹

外掛程序作用：擴充ERP功能。滿足企業的行業化、個性化需求。

外掛程序接口特點：

• 無需系統程序源碼。外掛程序集成到ERP中，并且會把登錄的用戶ID傳遞給外掛程序；
• 多種編程語言支持。可用.NET平臺任一編程語言，只需指定文件名、類名、方法名即可；
• 外掛程序分門別類。所有外掛程序放置目錄固定，都在ERP根目錄下的“外掛程序”子目錄下，并且子目錄與子系統一一對應，比如：“W1.采購系統”外掛程序的目錄如下：

ERP根目錄\外掛程序\W1\

外掛程序集成在幣加德ERP的菜單欄中，如下圖。

圖：外掛程序接口及系統集成位置

外掛程序實戰

本節使用Visual Studio 2013（速成版、社區版、專業版、高級版、旗艦版都可以，前面2個版本是免費的）來開發外掛程序，如果你使用的是其他版本的Visual Studio，也可以參照學習，大同小異。本節先用完整詳細的步驟介紹一個最簡單的外掛程序的開發，通過此外掛的學習，可以完全掌握外掛的開發方法。然后用較簡潔的步驟介紹如何開發報表外掛，這個案例很實用，企業的程序開發人員或ERP代理服務商經常需要從企業ERP中取數，開發分析報表或開發定制格式的打印單據。

一、一個簡單的外掛程序

（1）編寫外掛程序

①打開Visual Studio 2013,點【文件】/【新建】/【項目】，如下圖。

圖：新建項目

②在“新建項目”窗口，選擇【Visual C#】/【Windows 窗體應用程序】，名稱為“W1”，如下圖。

圖：選擇Windows 窗體應用程序

③從“工具箱”中拖一個Label到窗體設計界面，如下圖。

圖：拖一個標簽到設計面板

④雙擊設計面板，打開代碼編輯窗口，輸入以下代碼，如下圖。

public?string?_userID =?“”; ????//登錄用戶ID

public?void?ShowMe(string?userID,?string?serverIP,?string?dbName,?string?saPassword,?string?curDir)//鉤子方法

{

_userID = userID; ??????????//傳遞用戶登錄ID

label1.Text =?“登錄用戶ID:”?+ _userID;//標簽顯示

base.Show();//顯示窗體

}

圖：寫程序代碼

提醒：不管寫什么類型的外掛程序，都需要上面的代碼，相當于ERP與外掛程序之間約定的一種協議，目的在于把ERP系統當前的登錄用戶ID傳遞給外掛程序，并打開外掛程序的主窗體。除此之外，外掛程序與普通的Windows窗體程序沒有任何區別。

外掛程序可以查詢ERP的后臺數據表，但千萬別修改（刪除）數據，這是一個基本的原則。否則出錯后無法核查是ERP的問題，還是外掛程序的問題。

⑤鼠標右鍵項目名稱，在上下文菜單中選【屬性】，在打開的窗口中，“目標框架”選擇“.NET Framework 2.0”（為了兼容老電腦），“輸出類型”選“類庫”（如果選“Windows應用程序”，用戶可以越過權限設置，直接運行外掛程序），如下圖。

圖：設置項目屬性

⑥再次點【啟動】，系統會報錯（因上一步中改變了目標框架），修正錯誤，如下圖。

圖：修改錯誤

⑦再次點【啟動】，系統會彈出無法直接啟動類庫項目的錯誤，這正是所要的，如下圖。

圖：彈出無法直接啟動類庫項目的錯誤

⑧打開外掛程序的輸出目錄（參見“圖30-3 選擇Windows 窗體應用程序”選定的位置），并把外掛程序復制到ERP的外掛程序目錄，如下圖。

圖：拷貝外掛程序至ERP外掛目錄

（2）接口定義

①打開【系統設置】/【外掛程序接口】，選擇子系統，配置外掛程序接口參數，測試是否可以正常打開外掛程序，最后點【保存并應用】，如下圖。

外掛程序接口參數：

• 模塊代碼：外掛子系統代碼 + 3位流水碼。
• 模塊名稱：最簡潔的文字介紹外掛程序。“模塊代碼、模板名稱”會顯示在ERP系統的外掛菜單中，參見“圖30-1 外掛程序接口及系統集成位置”。
• 文件名稱：不含路徑，含擴展名。
• 類名稱：類名稱必須是“命名空間.類名”。
• 方法名稱：方法名稱必須是公有的，否則無法正常調用。
• 備注：較詳盡的文字介紹外掛程序。

圖：外掛程序接口

提醒：外掛程序?+ ERP數據字典?=?無限擴展?ERP?功能！

（無需“幣加德ERP系統”源代碼）