註冊外掛程式以使用您偏好的地理空間資料提供者

在使用外掛程式之前，必須在伺服器上註冊和部署該外掛程式。

建置外掛程式專案會產生外掛程式組件 (.dll)。本文提供相關資訊，讓您了解如何註冊和部署兩個地理空間動作的外掛程式組件，以便使用您偏好的地理空間資料提供者。如需有關撰寫外掛程式的詳細資訊，請參閱建立自訂外掛程式以使用偏好的地理空間資料提供者

註冊自訂外掛程式時的執行順序考量

當您註冊相同實體及訊息的多個外掛程式時，外掛程式的執行順序是由個別外掛程式的執行順序所定義。執行順序值較低的外掛程式會先執行，隨後執行的是執行順序值較高的外掛程式。

Field Service 和 Project Service 中使用 Bing 地圖服務進行地理編碼及距離矩陣動作的預設外掛程式，其執行順序設定為 1。您可以將自訂外掛程式的執行順序設定為在預設外掛程式之前 (小於 1) 或之後 (大於 1) 執行。

下表說明您可能需要視註冊外掛程式時所指定的執行順序以及參數條件而定，看待自訂外掛程式的方式。

Hierarchy	Description
主要	如果您想要將自訂外掛程式視為主要，而將預設 Bing 外掛程式視為次要，請將您的外掛程式的執行順序設定為 0。這會導致您的外掛程式在 Bing 外掛程式之前執行。 Bing 外掛程式會檢查自訂外掛程式傳回的 [緯度] 和 [經度] 值，只有在兩個傳回值都是 0 時，才會使用 Bing 繼續地理編碼。如果希望自訂外掛程式提供大部分地理編碼需要的服務，這會是優先選用方式。
次要	如果您想要將自訂外掛程式視為 Bing 外掛程式的次要外掛程式，只有在 Bing 無法地理編碼時，才會提供地理編碼服務，請將您的外掛程式的執行順序設定為 2。您也要撰寫自訂外掛程式的程式碼，此程式碼會先檢查 Bing 外掛程式傳回的 [緯度] 和 [經度] 值，只有在兩個傳回值都是 0 時，才會繼續執行。如果希望 Bing 提供大部分地理編碼需要的服務，這會是優先選用方式的執行方式。
完全覆寫	如果一定要自訂外掛程式做為地理編碼來源，並且完全覆寫 Bing (即使在自訂外掛程式無法地理編碼時也不讓它進行地理編碼)，就必須永遠傳回 0,0 以外的 [緯度] 和 [經度] 值。您可能需要判斷哪些例外情況擲回 .NET 例外狀況，以及哪些情況只是單純未傳回結果。如果不要傳回結果，也不允許任何後續外掛程式傳回結果時，您的自訂外掛程式就必須傳回像是 0.0001, 0.0001 這樣的值。

註冊和部署自訂外掛程式

使用外掛程式註冊工具或使用特定 SDK 類別撰寫註冊碼來註冊和部署外掛程式。

您可以使用 Plug-in Registration Tool，或使用特定 SDK 類別撰寫註冊程式碼以程式設計方式，來註冊和部署外掛程式。在註冊和部署外掛程式中深入瞭解。

下列步驟顯示「外掛程式註冊」工具，該工具提供圖形使用者介面，可輕鬆註冊及部署外掛程式。假設您正在使用範例自訂外掛程式，並具有範例專案來產生 CustomPlugin-FS-Geospatial.dll 元件。如果您開發了自己的自訂外掛程式，則元件和外掛程式名稱會有所不同，但請遵循相同的指示來註冊外掛程式。

小提示

如需深入瞭解，請參閱逐步解說：使用外掛程式註冊工具註冊外掛程式

取得 Plug-in Registration Tool。深入瞭解，請參閱從 NuGet 下載工具。
瀏覽至 [Your folder]\Tools\PluginRegistration 資料夾，並按兩下 PluginRegistration.exe 檔案以執行工具。
選取建立新連線。
在登入對話方塊中，指定要連線至 Dynamics 365 執行個體的認證，然後選取登入。
如果您有權存取 Dynamics 365 執行個體中的多個組織，則會出現組織清單供您選取。否則，工具會使用您的預設組織。
已註冊外掛程式或自訂工作流程活動組件的摺疊清單隨即顯示。選取註冊>註冊新組件。
輸入下列資訊：
- 步驟 1：選取省略符號（...），然後 選取CustomPlugin-FS-Geospatial.dll
- 第 2 步：選擇兩個插件。
- 第 3 步：選擇沙盒。
- 第 4 步：選擇 資料庫。
選取註冊選取的外掛程式。

CustomPlugin-FS-Geospatial.dll 元件以及msdyn_GeocodeAddress和msdyn_RetrieveDistanceMatrix的兩個外掛程式現在已註冊並部署至伺服器。
為每個動作登記一個步驟。步驟代表 SDK 訊息處理步驟實體，用來設定外掛程式何時以及如何執行。

在 [已註冊的外掛程式 & 自訂工作流程活動 ] 樹狀檢視中，展開 （元件） CustomPlugin-FS-Geospatial 節點，然後選取已註冊的外掛程式，例如 Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix。
以滑鼠右鍵按一下 Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix，並選取註冊新步驟。
輸入下列資訊：
- 訊息：msdyn_RetrieveDistanceMatrix
- 執行順序：視需要而定。在註冊自訂外掛程式時的執行順序考量中深入瞭解。
- 執行的事件管線階段：PostOperation
- 執行模式：同步的
將其餘欄位保留其預設值，然後選取 註冊新步驟。
以滑鼠右鍵按一下 Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress 外掛程式，然後選取 [註冊新步驟]。
輸入下列資訊：
- 訊息：msdyn_GeocodeAddress
- 執行順序：視需要而定。在註冊自訂外掛程式時的執行順序考量中深入瞭解。
- 執行的事件管線階段：PostOperation
- 執行模式：同步的
將其餘欄位保留其預設值，然後選取 註冊新步驟。