共用方式為

安裝和設定適用於 Azure IoT 中樞的 Connected Field Service

  • 發行項

依照本文中的步驟，設定 Connected Field Service 以便與 Azure IoT 中樞搭配使用。

注意

時間序列深入解析將於 2025 年 3 月之後被取代。 Connected Field Service 正在轉換至 Azure 資料總管。 關於轉換的詳細資訊即將發佈。

先決條件

提示

包含如下所示圖示的影像： 可能會展開以顯示更多詳細資料。 選取影像以展開它。 若要關閉它，請按 Esc 鍵。

從 ARM 範本部署 Connected Field Service 和 Azure 資源

使用 Azure 資源管理 (Azure Resource Manager) 範本，部署 Azure IoT 中樞並將其連接至 Field Service 環境。

  1. 選取頁面 https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment 上的部署至 Azure。

  2. 選取您的 Azure 訂閱。

  3. 選取或建立資源群組。

  4. 將區域設定為與您的 Field Service 環境相同的區域。

    用來為 Connected Field Service 部署 IoT 中樞之 Azure Resource Manager 範本的螢幕截圖。

  5. 輸入您組織的唯一名稱，以及 Field Service 環境的組織 URL。

  6. 選取您要部署的選擇性資源。

    • 選取部署模擬器 (選用)以使用範例資料測試並驗證 IoT 案例。
    • 選取 Azure 時間序列深入解析 (選用) 以啟用裝置讀數和摘要圖標的視覺效果。
    • 選取部署適用於 Power BI 的 SQL Server (選用)，並輸入 SQL Server 和認證以在 Power BI 中建立您自己的報表。

  7. 選取檢閱 + 建立。

先確定部署已完成，再繼續。

建立 IoT 提供者執行個體

  1. 登入 Dynamics 365，並開啟 Connected Field Service 應用程式。

  2. 在 Connected Field Service 中，移至設定區域。

  3. 選取提供者，然後選取新增。

  4. 輸入下列資訊：

    具有範例資料的新 IoT 中樞提供者執行個體的螢幕截圖。

    • 名稱：Azure 中已部署 IoT 資源之資源群組的名稱
    • IoT 提供者：IoT 中樞的 IoT 提供者
    • 提供者執行個體識別碼：Azure 中已部署至的資源群組之 IoT 中樞資源的名稱
    • URL：Azure 入口網站中資源群組概觀的 URL；例如，https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview。

  5. 選取儲存。

您現在需要對新提供者執行個體的設定進行更新。

  1. 在設定區域中，選取IoT 設定>IoT 提供者設定。

    IoT 設定頁面的螢幕擷取畫面。

  2. 對於預設 IoT 提供者，選取您已建立的 IoT 提供者執行個體。

  3. 選取儲存並關閉。

  4. 在後續步驟中，尋找 msdyn_iotproviderinstance 資料表的 IoT 提供者執行個體資料列，並複製 GUID。

設定 IoT 端點

對於此步驟，您需要知道已部署至您資源群組之服務匯流排命名空間的主機名稱。

  1. 下載 Power Platform CLI 並安裝。

  2. 開啟 CLI，並使用命令 pac tool prt 來啟動 Plugin Registration Tool (PRT)。

  3. 在 PRT 視窗中，選取建立新的連接。

  4. 在顯示可用組織清單中，選取 Office 365。

  5. 選取顯示可用組織的清單，然後選取顯示進階。

  6. 選取您的 Field Service 環境所在地區、輸入 Field Service 認證，然後選取登入。

    如果您有權存取多個 Dynamics 365 組織，請選取您要使用的組織的名稱。

現在需要更新 IoT 訊息服務端點。

  1. 連接至組織之後，尋找並選取 IoT 訊息服務端點。

  2. 選取更新。

  3. 對於命名空間位址，在外掛程式註冊工具中輸入服務匯流排命名空間的主機名稱，並加上首碼 sb://；例如，sb://myServiceBusNamespace.servicebus.windows.net。

  4. 在服務匯流排命名空間資源中，移至佇列，並尋找名稱結尾為 -crm 的佇列。 複製完整名稱，並在 Plug-in Registration Tool 中輸入此名稱做為主題名稱。

  5. 訊息格式請選擇 XML。

  6. 在服務匯流排命名空間資源中，移至共用存取原則>RootManageSharedAccessKey。

  7. 複製名稱並在 SAS 金鑰名稱中貼上。

  8. 複製主索引鍵並在 SAS 金鑰中貼上。

  9. 選取儲存。

    服務端點註冊頁面的螢幕擷取畫面。

授權 Azure App 連接

  1. 登入 Azure 帳戶並前往 Azure 入口網站。

  2. 移至資源群組，並尋找最近部署 IoT 中樞所至的目標資源群組。

  3. 選取及編輯 API 連線資源 commondataservice。

  4. 在一般底下，選取編輯 API 連接，然後選取授權。

  5. 使用您用於登入 Connected Field Service 環境的 Dynamics 365 認證登入。

    這些認證可能與您用於登入 Azure 入口網站的認證不同。

  6. 選取儲存。

更新 devicerules.json

已部署至資源組的串流分析工作會參考名為 devicerules.json 的檔案。 此檔案定義您使用選用裝置模擬器時建立 IoT 警示的規則。

若要使用該規則，請上傳 devicerules.json 檔案。 您必須重現確切的目錄結構才能讓範例警示正常運作。

  1. 從 GitHub 儲存庫下載 devicerules.json 檔案。

  2. 在 Azure 管理員入口網站中打開資源群組，並選取已部署至您源群組的儲存體帳戶。

  3. 選取容器，然後建立名為 devicerules 的容器。

  4. 開啟新容器 devicerules，並選取上傳。

  5. 瀏覽至 devicerules.json 並加以選取。

  6. 展開進階區段。 在上傳至資料夾欄位中，輸入 2016-05-30，然後選取上傳。

  7. 開啟新資料夾 2016-05-30，並選取上傳。

  8. 瀏覽至 devicerules.json 並加以選取。

  9. 展開進階區段。 在上傳至資料夾欄位中，輸入 22-40，然後選取上傳。

開始 Azure 串流分析工作

  1. 在 Azure 入口網站中，移至資源群組，並尋找部署 IoT 中樞所至的目標資源群組。

  2. 選取每個串流分析工作，並從概觀索引標籤中選取開始。

恭喜！ 您現已準備好在 Azure IoT 中樞與 Dynamics 365 之間傳遞資料，以使用 Connected Field Service。

設定 Azure 時間序列深入解析連接

使用 Azure 時間序列深入解析來建立視覺化效果。 在此步驟中，您需要知道您的 Azure 租用戶識別碼。

  1. 在 Dynamics 365 中，開啟 Connected Field Service 應用程式。

  2. 啟動瀏覽器開發人員工具，並移至控制台。

  3. 在主控台中鍵入或貼上以下指令碼並執行該指令碼。 將 Value 參數取代為您的 Azure 租用戶識別碼。

var req = {};

req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"Key": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"Value": {
"typeName": "Edm.String",
"structuralProperty": 1
},
},
operationType: 0,
operationName: "msdyn_IoTSetConfiguration"
};
};

req["Key"]="TSI_PLUGIN_AZURE_TENANT_ID";
req["Value"]="REPLACE";

Xrm.WebApi.online.execute(req).then( 
function (data) { 
console.log("Success Response Status: " + data.status);
}, 
function (error) { 
console.log("Error: " + error.message);
}
);

  1. 重新執行指令碼。 這次，將 Key 取代為 TSI_PLUGIN_CLIENT_APPLICATION_ID，並將 Value 取代為您依照先決條件所建立之時間序列深入解析應用程式註冊中的應用程式用戶端識別碼。

  2. 再一次執行指令碼。 這次，將 Key 取代為 TSI_PLUGIN_CLIENT_SECRET，並將 Value 取代為您依照先決條件所建立之時間序列深入解析應用程式註冊中的用戶端密碼。

  3. 使用您先前所建立 IoT 提供者執行個體之 msdyn_iotproviderinstance 資料表中 IoT 提供者執行個體資料列的時間序列深入解析 URL 及 GUID 來執行下列指令碼。

var data = {"msdyn_timeseriesinsightsurl": "Enter Data Access FQDN found on Time Series Insights environment overview"};
Xrm.WebApi.updateRecord("msdyn_iotproviderinstance", "Copy the value for msdyn_iotproviderinstanceid from the json object returned with the API call https://[your-environment-name].crm.dynamics.com/api/data/v9.2/msdyn_iotproviderinstances", data);

(選用) 設定模擬器

模擬器可讓您測試 Connected Field Service，而不需要連接實際硬體。 模擬的 IoT 裝置和資料可協助您了解參與將 IoT 資料轉換成工單的系統組件。

在此步驟中，您需要模擬器 URL 以及 iothubowner 原則的主索引鍵。

取得存取金鑰

  1. 登入 Azure 帳戶並前往 Azure 入口網站。

  2. 移至資源群組，並尋找最近部署 IoT 中樞所至的目標資源群組。

  3. 選取 IoT 中樞。

  4. 選取共用存取原則，然後複製 iothubowner 的主索引鍵。

    Iothubowner 的 Azure IoT 中樞資源共用存取原則螢幕擷取畫面，其中反白顯示主索引鍵。

取得模擬器 URL

  1. 在已部署 IoT 中樞的 Azure 入口網站資源群組中，選取以 Simulator 開頭的應用程式服務資源類型，然後複製右上角的 URL。

  2. 在瀏覽器的網址列中貼上 URL，並載入頁面。

  3. 選取連接。

  4. 輸入 IoT 中樞資源中的主機名稱，並輸入 iothubowner 做為原則名稱。 在索引鍵欄位中，貼上您先前複製的主索引鍵。

    Azure 中 [設定連接] 視窗的螢幕擷取畫面。

  5. 確定連接狀態是已連接，然後關閉連接視窗。

使用模擬器傳送測試命令。 例如，選取溫度，將其提高至 70 度以上。 模擬器已預先編製程式，如果溫度上升超過 70 度，就會建立 IoT 警示。

後續步驟