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

外掛程序介紹

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

外掛程序接口特點(diǎn)：

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

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

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

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

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

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

一、一個(gè)簡(jiǎn)單的外掛程序

（1）編寫外掛程序

①打開Visual Studio 2013,點(diǎn)【文件】/【新建】/【項(xiàng)目】，如下圖。

圖：新建項(xiàng)目

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

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

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

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

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

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窗體程序沒(méi)有任何區(qū)別。

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

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

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

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

圖：修改錯(cuò)誤

⑦再次點(diǎn)【啟動(dòng)】，系統(tǒng)會(huì)彈出無(wú)法直接啟動(dòng)類庫(kù)項(xiàng)目的錯(cuò)誤，這正是所要的，如下圖。

圖：彈出無(wú)法直接啟動(dòng)類庫(kù)項(xiàng)目的錯(cuò)誤

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

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

（2）接口定義

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

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

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

圖：外掛程序接口

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

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