Instalacja i konfiguracja rozwiązania Connected Field Service dla centrum Azure IoT Hub

Wykonaj kroki opisane w tym artykule, aby skonfigurować usługę Connected Field Service do użytku z usługą Azure IoT Hub.

• Krok 1: Wdrażanie rozwiązania Connected Field Service i zasobów Azure z szablonu usługi ARM
• Krok 2: Utwórz instancję dostawcy IoT
• Krok 3: Konfigurowanie profilu trybu offline
• Krok 4: Autoryzuj połączenie aplikacji Azure
• Krok 5: Aktualizacja devicerules.json
• Krok 6: Utwórz zadanie Analizy strumienia Azure
• Krok 7: Skonfiguruj połączenie Azure Time Series Insights
• Krok 8: (Opcjonalnie) Skonfiguruj symulator

Uwaga

Funkcja Time Series Insights będzie przestarzała po marcu 2025 r. Connected Field Service przechodzi na platformę Azure Data Explorer. Więcej informacji na temat przejścia już wkrótce.

Wymagania wstępne

• Usługa Dynamics 365 Field Service jest zainstalowana.

• Masz role zabezpieczeń System Administrator i IoT Administrator.

• Masz aktywną subskrypcję Azure z uprawnieniami do tworzenia zasobów i usług.

• Utworzono rejestrację aplikacji dla Azure Time Series Insights w Azure Portal i masz identyfikator aplikacji (klienta) oraz identyfikator obiektu. Dodaj klucz tajny klienta i zapisz wartość. W tej procedurze te wartości będą potrzebne wielokrotnie.

Porada

Obrazy z ikoną, która wygląda tak: mogą być powiększone w celu pokazania większej liczby szczegółów. Wybierz obraz, aby go powiększyć. Aby go zamknąć, naciśnij klawisz Esc.

Wdrażanie rozwiązania Connected Field Service i zasobów Azure z szablonu usługi ARM

Użyj szablonu Azure Resource Management (Azure Resource Manager), aby wdrożyć usługę Azure IoT Hub i połączyć ją ze środowiskiem Field Service.

1. Wybierać Wdróż na platformie Azure na stronie https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

2. Wybierz subskrypcję platformy Azure.

3. Utwórz lub wybierz grupę zasobów.

4. Ustaw region w tym samym regionie, co środowisko Field Service.

   

5. Wprowadź unikatową nazwę organizacji i adres URL organizacji środowiska Field Service.

6. Wybierz opcjonalne zasoby, które chcesz wdrożyć.

   • Wybierać Wdróż symulator (opcjonalnie) aby przetestować i zweryfikować scenariusze IoT na podstawie przykładowych danych.
   • Wybierać Wgląd w szeregi czasowe platformy Azure (opcjonalnie) aby umożliwić wizualizację odczytów urządzeń i kafelków podsumowań.
   • Wybierać Wdróż SQL Server dla Power BI (opcjonalny) i wprowadź serwer SQL oraz dane uwierzytelniające, w których chcesz tworzyć własne raporty Power BI.

7. Wybierz Przejrzyj i utwórz.

Przed kontynuowaniem upewnij się, że wdrożenie zostało ukończone.

Utwórz wystąpienie dostawcy IoT

1. Zaloguj się do Dynamics 365 i otwórz aplikację Connected Field Service.

2. W Connected Field Service, przejdź do obszaru Ustawienia.

3. Wybierz pozycję Dostawcy, a następnie wybierz pozycję Nowe.

4. Wprowadź następujące informacje:

   

   • Nazwa : nazwa grupy zasobów na platformie Azure, w której wdrożono zasoby IoT
   • Dostawca IoT : Dostawca IoT dla IoT Hub
   • Identyfikator instancji dostawcy : nazwa zasobu IoT Hub wdrożonego w grupie zasobów na platformie Azure
   • Adres URL : adres URL przeglądu grupy zasobów w Azure Portal; Na przykład, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

5. Wybierz pozycję Zapisz.

Teraz musisz zaktualizować ustawienia nowej instancji dostawcy.

1. W obszarze Ustawienia wybierz Ustawienia IoT>Ustawienia dostawcy IoT.

   

2. Dla Domyślny dostawca IoT wybierz utworzoną instancję dostawcy IoT.

3. Zaznacz Zapisz i zamknij.

4. Aby wykonać późniejszy krok, znajdź plik Instancja dostawcy IoT rząd w msdyn_iotproviderinstance table i skopiuj identyfikator GUID.

Konfigurowanie punktu końcowego IoT

Na potrzeby tego kroku musisz znać nazwę hosta dla przestrzeni nazw Service Bus wdrożonej w Twojej grupie zasobów.

1. Pobierz i zainstaluj Interfejs wiersza polecenia Power Platform.

2. Otwórz interfejs CLI i uruchom Plugin Registration Tool (PRT) za pomocą polecenia pac tool prt.

3. W oknie PRT wybierz opcję Utwórz nowe połączenie.

4. Z Wyświetl listę dostępnych organizacji wybierz Office 365.

5. Wybierz Wyświetl listę dostępnych organizacji, a następnie wybierz Pokaż zaawansowane.

6. Wybierz region swojego środowiska Field Service, wprowadź swoje poświadczenia Field Service, a następnie wybierz Zaloguj się.

   Jeśli masz dostęp do wielu organizacji Dynamics 365, wybierz nazwę organizacji, z którą chcesz współpracować.

Teraz musisz zaktualizować usługę komunikatów IoT punkt końcowy.

1. Po nawiązaniu połączenia z organizacją znajdź i wybierz Wiadomość IoT Usługa punkt końcowy.

2. Wybierz Aktualizuj.

3. W polu NameSpace Address wprowadź nazwę hosta przestrzeni nazw Service Bus w narzędziu rejestracji wtyczek, poprzedzoną sb://; na przykład sb://myServiceBusNamespace.servicebus.windows.net.

4. W zasobie Przestrzeń nazw magistrali usługi przejdź do Kolejki i znajdź kolejkę o nazwie kończącej się -crm. Skopiuj imię i nazwisko, a następnie wprowadź je jako Nazwa tematu w Narzędziu do rejestrowania dodatków plug-in.

5. Dla formatu wiadomości wybierz format XML.

6. Przestrzeń nazw magistrali usług przejdź do Zasady dostępu współdzielonego>RootManageSharedAccessKey.

7. Skopiuj nazwę i wklej ją w Nazwa klucza SaS.

8. Skopiuj klucz podstawowy i wklej go w kluczu SAS.

9. Wybierz pozycję Zapisz.

   

Autoryzuj połączenie aplikacji Azure

1. Zaloguj się na swoje konto Azure i przejdź do Azure Portal.

2. Przejdź do Grup zasobów i znajdź grupę zasobów, w której wdrożono IoT Hub.

3. Wybierz i edytuj zasób Połączenie interfejsu APIcommondataservice.

4. W sekcji Ogólne wybierz Edycja połączenia API, a następnie wybierz Autoryzacja.

5. Zaloguj się przy użyciu poświadczeń Dynamics 365 używanych do logowania się do środowiska Connected Field Service.

   Mogą się one różnić od poświadczeń używanych do logowania się do Azure Portal.

6. Wybierz pozycję Zapisz.

Aktualizacja devicerules.json

Zadanie analiza strumienia wdrożone w Twojej grupie zasobów odnosi się do pliku o nazwie devicerules.json. Ten plik definiuje regułę tworzącą alerty IoT w przypadku korzystania z opcjonalnego symulatora urządzenia.

Aby skorzystać z reguły, prześlij plik devicerules.json . Aby przykładowy alert zadziałał, należy odtworzyć dokładną strukturę katalogów.

1. Pobierz plik devicerules.json z repozytorium GitHub.

2. Otwórz grupę zasobów w portalu administracyjnym Azure i wybierz konto magazynu wdrożone w grupie zasobów.

3. Wybierz Kontenery, a następnie utwórz kontener o nazwie devicerules.

4. Otwórz nowy kontener devicerules i wybierz Prześlij.

5. Przeglądaj i wybierz devicerules.json.

6. Rozwiń sekcję zaawansowanych. W polu Prześlij do folderu wpisz 2016-05-30, a następnie wybierz Prześlij.

7. Otwórz nowy folder 2016-05-30 i wybierz Prześlij.

8. Przeglądaj i wybierz devicerules.json.

9. Rozwiń sekcję zaawansowanych. W polu Prześlij do folderu wpisz 22-40, a następnie wybierz Prześlij.

Utwórz zadanie Analizy strumienia Azure

1. Przejdź do portal Azure, przejdź do Grupy zasobów i znajdź grupę zasobów, w której wdrożono IoT Hub.

2. Wybierz każde zadanie analiza strumienia i z zakładki Przegląd wybierz Rozpocznij.

Gratulacje! Użytkownik jest teraz gotowy do przekazania danych między Azure IoT Hub a Dynamics 365, aby używać usługi Connected Field Service.

Skonfiguruj połączenie Azure Time Series Insights

Użyj Azure Time Series Insights do tworzenia wizualizacji. Aby wykonać ten krok, musisz znać identyfikator dzierżawy platformy Azure.

1. W Dynamics 365 i otwórz aplikację Connected Field Service.

2. Uruchom narzędzia dla deweloperów przeglądarek i przejdź do konsoli.

3. Wpisz lub wklej następujący skrypt w konsoli i uruchom go. Zastąp parametr Value identyfikatorem dzierżawy platformy 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. Ponownie uruchom skrypt. Tym razem zastąp Key na TSI_PLUGIN_CLIENT_APPLICATION_ID i Value identyfikatorem klienta aplikacji z rejestracji aplikacji Time Series Insights utworzonej jako warunek wstępny.

2. Uruchom skrypt jeszcze raz. Tym razem zastąp Key na TSI_PLUGIN_CLIENT_SECRET i Value identyfikatorem klienta aplikacji z rejestracji aplikacji Time Series Insights utworzonej jako warunek wstępny.

3. Uruchom następujący skrypt, używając adresu URL Time Series Insights i identyfikatora GUID wiersza wystąpienia dostawcy IoT w tabeli msdyn_iotproviderinstance dla utworzonej wcześniej instancji dostawcy IoT.

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);

(Opcjonalnie) Skonfiguruj symulator

Symulator pozwala testować usługę Connected Field Service bez konieczności podłączania sprzętu. Symulowane urządzenia i dane IoT pomagają zrozumieć części systemu, które przyczyniają się do przekształcania danych IoT w zlecenia pracy.

W tym kroku potrzebny jest adres URL symulatora i klucz podstawowy iothubowner polityki.

Otrzymaj klucz dostępu

1. Zaloguj się na swoje konto Azure i przejdź do Azure Portal.

2. Przejdź do Grup zasobów i znajdź grupę zasobów, w której wdrożono IoT Hub.

3. Wybierz IoT hub.

4. Wybierz Zasady dostępu współdzielonego, a następnie skopiuj klucz podstawowy dla iothubowner.

   

Uzyskaj adres URL symulatora

1. W Azure Portal grupie zasobów, w której wdrożono IoT Hub, wybierz typ zasobu App Service rozpoczynający się od Simulator i skopiuj adres URL w górnej części prawy róg.

2. Wklej adres URL do paska adresu przeglądarki i załaduj stronę.

3. Wybierz Połączenie.

4. Wprowadź nazwę hosta z zasobu IoT Hub i iothubowner jako nazwę zasady. W polu Klucz wklej skopiowany wcześniej klucz podstawowy.

   

5. Upewnij się, Stan połączenia to Połączono , a następnie zamknij okno połączenia.

Wyślij polecenie testowe za pomocą symulatora. Na przykład wybierz temperaturę i zwiększ ją do powyżej 70 stopni. Symulator jest wstępnie zaprogramowany, aby utworzyć alert IoT jeśli temperatura wzrośnie ponad 70 stopni.

Następne kroki

• Zarejestruj urządzenia
• Ściągnij dane urządzenia
• Wizualizowanie odczytów z urządzenia