MS CRM 2011的自定義和開發(11)——插件(plugin)開發(三)


    插件開發完成后,就需要注冊、調試、部署了。

    在注冊之前,需要着重指出的是,必須對插件程序集進行簽名,具體步驟是,在Visual Studio中,右鍵點擊項目名稱,快捷菜單中選擇“屬性”,在項目屬性對話框中,點擊“簽名”頁簽, 勾選“為程序集簽名”,在“選擇強名稱密鑰文件”下拉框中,選擇“新建”創建一個新的密鑰文件或者“瀏覽”選擇一個已有的密鑰文件。如下圖所示。

image

    注冊使用插件注冊工具PluginRegistrationTool了,該工具位於SDK\Tools\PluginRegistration目錄下,需要使用Visual Studio .Net 2010編譯一下pluginregistrationtool項目。

    使用插件注冊工具進行插件注冊的步驟非常簡單,

    1. 運行插件注冊工具,如果是初次運行,在Connections控制板中沒有任何內容,需要點擊工具條的“Create New Connection”按鈕,而后在“Connection Information”區域的Label文本框中輸入代表連接的注記名稱,在“Discovery Url”文本框中輸入服務器的地址(包括端口號),在“User Name”文本框中輸入包括域名在內的用戶名稱。如下圖所示。

image

 

    2. 點擊“Connect”按鈕,而后再在彈出的Windows登陸窗口中輸入密碼,注冊工具會去獲取目標部署中的所有組織。如下圖所示。

image

    3. 選擇需要連接的組織,而后點擊“Connect”按鈕。注冊工具獲取目標組織的消息、用戶、已經注冊的插件、步驟、映像等等所有信息,而后,將在右側的區域顯示出目標組織中的所有已經注冊插件程序集。如下圖所示。

SNAGHTML2af29924

    右側的區域主要分為四個部分,最上方的工具條、左上方的已注冊插件以及自定義工作流活動程序集列表,右上方的PropertyGrid顯示了列表中當前選擇項目的屬性,下方的區域是列表中當前選擇項的一些內容。

    如果需要注冊插件。點擊工具條中的“Register”按鈕,系統會彈出下拉菜單,如下圖所示。

image

    選擇“Register New Assembly”,就開始了注冊插件程序集。點擊該菜單項之后,系統彈出“Register New Plugin”窗口,點擊“Step #1:Specify the location of the Assembly  to Analyze”文本框旁的按鈕“…”,系統將彈出對話框,以便找到程序集。如下圖所示。

SNAGHTML2b0e8ec9

 

    選定程序集后,點擊“打開”按鈕,返回“Register New Plugin”窗口。會在“Step #2”的列表框中列出程序集中所有的插件類。如下圖所示。

image

    在“Step #3”中,可以選擇隔離模式Isolation Mode,有兩種模式:None以及沙盒Sandbox,如果是將插件放置在沙盒中,那么插件類將無法訪問服務器上的文件系統、應用程序日志以及注冊表等信息,而注冊為None模式則沒有這個限制。

    在“Step #4”中,設定程序集存放位置:數據庫Database、文件系統Disk以及全局緩存GAC中,如果正式生產環境部署,那么推薦部署在數據庫中,如果是開發環境,推薦部署在Disk上,以方便調試。

    點擊“Register Selected”按鈕,完成插件程序集的注冊工作。返回主界面,對比之前的程序集列表,可以看出,新增的插件的相關內容已赫然在目。如下圖紅色方框區域所示。

image

    下面開始完成對事件的訂閱工作。

     選擇需要訂閱事件的插件類 –〉 點擊“Register” –〉 “Register New Step”,系統彈出“Register New Step”窗口。由於是以前一篇文章中的AccountNumberPlugin舉例,所以,需要訂閱的消息是客戶Accont實體的Create消息的前置事件,所以,在“Register New Step”窗口,做出如下的設置:

    消息Message文本框內容:Create;

    主要實體Primary Entity文本框內容:account;

    階段Eventing pipeline Stage of Execution: Pre-Operation(CRM 2011 Only)

    模式Execution Mode:Synchronous

    部署Deployment:Server

    最終效果如下圖所示:

image

 

 

    點擊“Register New”按鈕,完成步驟注冊,返回注冊工具主界面。可以看出在插件列表中又多出一行新內容,對應了剛剛注冊的Step,效果如下圖的紅色方框區域所示。

image

    如果某個插件類中使用了映像Image,那么需要針對相應步驟設定Image信息,點擊“Register” –〉 “Register New Image”,系統彈出“Register New Image”窗口,在“Step列表”中選擇需要添加Image的步驟,而后設定前期映像、后期映像的信息。效果如下圖所示。

image

    經過以上的幾個步驟,即完成了插件程序集的注冊、步驟的注冊以及映像Image的注冊。下面即開始進行測試,看看是否能夠滿足業務要求,如果出現了錯誤需要進行調試等等內容,在后續章節中再進行介紹。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM