利用erp系統(tǒng)開發(fā)接口定制簡單外掛kf05-01

外掛程序介紹

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

外掛程序接口特點：

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

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

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

圖：外掛程序接口及系統(tǒng)集成位置

外掛程序?qū)崙?zhàn)

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

一、一個簡單的外掛程序

（1）編寫外掛程序

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

圖：新建項目

②在“新建項目”窗口，選擇【Visual C#】/【W(wǎng)indows 窗體應(yīng)用程序】，名稱為“W1”，如下圖。

圖：選擇Windows 窗體應(yīng)用程序

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

圖：拖一個標(biāo)簽到設(shè)計面板

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

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

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

{

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

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

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

}

圖：寫程序代碼

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

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

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

圖：設(shè)置項目屬性

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

圖：修改錯誤

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

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

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

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

（2）接口定義

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

外掛程序接口參數(shù)：

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

圖：外掛程序接口

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

（無需“幣加德ERP系統(tǒng)”源代碼）