共用方式為


分析外掛程式效能

 

發行︰ 2017年1月

適用於: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

Plug-in Profiler 是一種設定可以顯示外掛程式執行和工作流程活動的工具,可增強 Microsoft Visual Studio 偵錯時的體驗。 此工具可從命令提示字元視窗或從 Plug-in Registration 工具中執行,讓開發自訂 Microsoft Dynamics 365 (線上和內部部署) 程式碼更快速且更輕鬆。 此外,使用者在編寫程式碼時可能會發生錯誤,並傳送結果到程式碼開發者端或是獨立軟體廠商 (ISV) 進行分析。 開發人員可以重新執行外掛程式或自訂工作流程活動執行,以及遠端偵測程式碼錯誤,即使已從 Microsoft Dynamics 365 伺服器中斷連線。

此工具可用於偵錯或重新執行模式。 後續章節將會逐一說明這些模式。

本主題內容

使用外掛程式設定機為外掛程式偵錯

重新執行外掛程式

執行獨立外掛程式設定機

使用外掛程式設定機為外掛程式偵錯

  1. 執行 Plug-in Registration 工具。 您可以在 SDK 的 Tools\PluginRegistration 資料夾中找到工具的可執行檔。下載 Microsoft Dynamics CRM SDK 套件。

  2. 按一下 [建立新連線] 連至 Microsoft Dynamics 365 伺服器和組織。 如需連線至伺服器和組織的詳細資訊,請參閱 SDK 主題:逐步解說:利用外掛程式註冊工具來註冊外掛程式

  3. 登錄外掛程式並進入 Microsoft Dynamics 365 伺服器。 在您執行此工具的電腦上保留一份偵錯編譯過的外掛程式組件。

  4. 在目標組織的工具列選擇 [安裝設定機]。 你將會在清單中看到一個 [外掛程式設定機] 節點。

  5. 選擇一個外掛程式步驟,並在工具列中按一下 [開始設定] 啟動設定過程。 您可以選擇設定機在顯示的 [設定機設定] 對話視窗中執行的方式。

  6. 在使外掛程式執行的 Microsoft Dynamics 365 中執行作業。 例如,如果步驟是為了客戶更新而設定的話,就請更新客戶。

  7. 如果您選擇了 [設定器] 對話方塊中的 [例外],在外掛程式傳回例外和顯示 [商務程序錯誤] 對話視窗的時候,按一下 [下載記錄檔] 然後儲存此檔案。 或者,如果外掛程式沒有傳回發生例外的訊息,請按一下 [停止設定]。

  8. 在 Plug-in Registration 工具中,請按一下 [偵錯]。

  9. 在 [為現有外掛程式偵錯] 對話視窗中,在 [設定] 索引標籤中提供請求資訊。設定檔欄位輸入先前儲存紀錄檔的位置。 輸入或選取外掛程式組件的位置,以及執行的外掛程式類別名稱。

  10. 啟動 Microsoft Visual Studio 並附加偵測工具至 PluginRegistration.exe 程序。

  11. 在外掛程式的程式碼中設定一個中斷點。

  12. 在 [為現有外掛程式偵錯] 對話視窗中,按一下 [開始執行]。

  13. 在少許的延誤之後,外掛程式會執行,由 Microsoft Dynamics 365 伺服器使用傳遞至其中的相同執行內容,而偵錯工具會在先前設定的中斷點處停止執行。

  14. 如你平常的程序執行此外掛程式。 任何外掛程式輸出的資訊會顯示在 [為現有外掛程式偵錯] 對話視窗中。

此時,您可以改變外掛程式的程式碼、建構,重新依附偵錯工具至 PluginRegistration.exe 程序,然後按一下 [開始執行] 繼續您的偵測工作階段。 在執行這些作業時,您不需要關閉 [為現有外掛程式偵錯] 表單。

在您修正了程式碼中的問題之前,您不需要重新將外掛程式部署到 Microsoft Dynamics 365 伺服器中。 此偵錯方案可以在即便伺服器上有一個最佳化版本的外掛程式,以及您進行偵錯的電腦中擁有另一個偵錯版本的外掛程式的狀況下運作。

重新執行外掛程式

重新執行外掛程式不需要連線至 Microsoft Dynamics 365 伺服器和組織。 此方法的優點在於,您可以從客戶和遠端為外掛程式偵錯時獲得此外掛程式的執行設定檔。 重新執行功能的限制為,您無法在偵錯模式下改變偵錯工具外掛程式碼的呼叫順序。

重新執行功能提供外掛程式的呼叫資料和事件執行內容的快照集 (來自 Microsoft Dynamics 365 伺服器)。 您將會從對組織服務的呼叫收到相同的事件、GUID,以及其他項目,但是伺服器資料在為外掛程式偵錯時不會變更。 在上一個偵錯程序期間,外掛程式其實會連線到伺服器,並即時呼叫。

重新執行外掛程式

  1. 啟動 Microsoft Visual Studio 並附加偵測工具至 PluginRegistration.exe 程序。

  2. 按一下 [重新執行外掛程式]。

  3. 在對話方塊中輸入紀錄與外掛程式組件位置。

  4. 按一下 [開始執行]。

  5. 如你平常的程序為外掛程式偵錯。

執行獨立外掛程式設定機

設定機可以在工具命令提示字元視窗中獨立執行 Plug-in Registration 工具。 這有助於從客戶的 Microsoft Dynamics 365 伺服器的取得外掛程式紀錄,來為發生錯誤的外掛程式。 使用者可隨後使用該紀錄並在 Plug-in Registration 工具中重新執行外掛程式,並使用 Microsoft Visual Studio 外掛工具進行偵錯。

從命令提示字元執行外掛程式設定器

  1. 開啟命令提示字元視窗並設定工作目錄為 SDK 下載的 Tools\PluginRegistration 資料夾。

  2. 輸入指令:PluginProfiler.Debugger.exe /?.

  3. 檢閱支援參數表並重新執行具有適當參數的 PluginProfiler.Debugger.exe 程式。

另請參閱

開發人員工具
團隊開發的解決方案工具
外掛程式開發
註冊和部署外掛程式
偵錯外掛程式

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有,並保留一切權利。 著作權