Connected Field Service für Azure IoT Hub installieren und konfigurieren

  • Artikel

Gehen Sie wie in diesem Artikel beschrieben vor, um Connected Field Service für die Verwendung mit Azure IoT Hub einzurichten.

Anmerkung

Time Series Insights wird nach März 2025 eingestellt. Connected Field Service wird auf Azure Data Explorer umgestellt. Weitere Informationen zur Umstellung folgen demnächst.

Anforderungen

Tipp

Bilder mit einem Symbol der folgenden Art können erweitert werden, um mehr Details anzuzeigen. Klicken Sie auf das Bild, um es zu erweitern. Um es zu schließen. drücken Sie die ESC-Taste.

Connected Field Service- und Azure-Ressourcen von einer ARM-Vorlage aus bereitstellen

Verwenden Sie eine Azure-Ressourcenmanagementvorlage (Azure Resource Manager), um Azure IoT Hub bereitzustellen und mit Ihrer Field Service-Umgebung zu verbinden.

  1. Wählen Sie Für Azure bereitstellen auf der Seite https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment aus.

  2. Wählen Sie Ihr Azure Abonnement.

  3. Wählen Sie eine Ressourcengruppe aus oder erstellen Sie eine.

  4. Stellen Sie die Region auf dieselbe Region wie Ihre Field Service-Umgebung ein.

    Screenshot der Azure Resource Manager-Vorlage zum Bereitstellen der IoT Hub für Connected Field Service.

  5. Geben Sie den eindeutigen Namen Ihrer Organisation und die Organisations-URL der Field Service-Umgebung ein.

  6. Wählen Sie die optionalen Ressourcen aus, die Sie bereitstellen möchten.

    • Wählen Sie Simulator bereitstellen (optional), um IoT-Szenarien mit Beispieldaten zu testen und zu validieren.
    • Wählen Sie Azure Time Series Insights (optional), um Visualisierungen von Geräteauslesungen und Zusammenfassungskacheln zu ermöglichen.
    • Wählen Sie SQL Server für Power BI bereitstellen (optional) aus und geben Sie den SQL-Server und die Anmeldeinformationen ein, um Ihre eigenen Berichte in Power BI zu erstellen.

  7. Wählen Sie Überprüfen und erstellen.

Stellen Sie sicher, dass die Bereitstellung abgeschlossen ist, bevor Sie fortfahren.

Eine IoT-Anbieterinstanz erstellen

  1. Melden Sie sich bei Dynamics 365 an und öffnen Sie die Connected Field Service-App.

  2. Gehen Sie in Connected Field Service zum Bereich Einstellungen.

  3. Wählen Sie erst Anbieter und dann Neu aus.

  4. Geben Sie die folgenden Informationen ein:

    Screenshot einer neuen IoT-Hub-Anbieterinstanz mit Beispieldaten.

    • Name: Der Name der Ressourcengruppe in Azure, in der Sie IoT-Ressourcen bereitgestellt haben
    • IoT-Anbieter: Der IoT-Anbieter für IoT Hub
    • Anbieterinstanz-ID: Der Name der IoT Hub-Ressource, die Sie in Ihrer Ressourcengruppe in Azure bereitgestellt haben
    • URL: Die URL der Ressourcengruppenübersicht im Azure-Portal, zum Beispiel: https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

  5. Wählen Sie Speichern.

Sie müssen nun die Einstellungen für die neue Anbieterinstanz aktualisieren.

  1. In dem Bereich Einstellungen wählen Sie IoT-Einstellungen>IoT-Anbieter-Einstellungen.

    Screenshot der Seite mit den IoT-Einstellungen.

  2. Wählen Sie für Standard-IoT-Anbieter die von Ihnen erstellte IoT-Anbieterinstanz aus.

  3. Wählen Sie Speichern und schließen aus.

  4. Suchen Sie für einen späteren Schritt nach der Reihe IoT-Anbieterinstanz in der Tabelle msdyn_iotproviderinstance und kopieren Sie die GUID.

Einen IoT-Endpunkt einrichten

Für diesen Schritt müssen Sie den Hostnamen für den Service Bus-Namespace kennen, der für Ihre Ressourcengruppe bereitgestellt wurde.

  1. Wählen Sie Power Platform CLI aus und installieren Sie sie.

  2. Öffnen Sie die CLI und starten Sie das Plugin Registration Tool (PRT) mit dem Befehl pac tool prt.

  3. Wählen Sie im PRT-Fenster Neue Verbindung erstellen aus.

  4. Wählen Sie in Liste der verfügbaren Organisationen anzeigenOffice 365 aus.

  5. Wählen Sie Liste der verfügbaren Organisationen anzeigen und dann Erweitert anzeigen aus.

  6. Wählen Sie die Region Ihrer Field Service-Umgebung aus, geben Sie Ihre Field Service-Anmeldeinformationen ein und wählen Sie dann Anmelden aus.

    Wenn Sie Zugriff auf mehrere Dynamics 365-Organisationen haben, wählen Sie den Namen der Organisation aus, mit der Sie arbeiten möchten.

Jetzt müssen Sie den IoT-Nachrichtendienstendpunkt aktualisieren.

  1. Nachdem Sie mit der Organisation verbunden sind, suchen Sie nach dem IoT-Nachrichtendienstendpunkt und wählen Sie ihn aus.

  2. Wählen Sie Aktualisieren aus.

  3. Geben Sie für NameSpace-Adresse den Hostnamen des Service Bus-Namespace im Plug-In-Registrierungstool mit dem Präfix sb:// ein, zum Beispiel sb://myServiceBusNamespace.servicebus.windows.net.

  4. Wechseln Sie in der Service Bus-Namespace-Ressource zu Warteschlangen und finden Sie die Warteschlange mit einem Namen, der auf -crm endet. Kopieren Sie den vollständigen Namen und geben Sie ihn als ein Themaname im Plug-In-Registrierungstool ein.

  5. Wählen Sie für NachrichtenformatXML.

  6. Wechseln Sie in der Service Bus-Namespace-Ressource zu Freigegebene Zugangsrichtlinien>RootManageSharedAccessKey.

  7. Kopieren Sie den Namen und fügen Sie ihn in SAS-Schlüsselnamen ein.

  8. Kopieren Sie den ersten Schlüssel und fügen Sie ihn in SAS-Schlüssel ein.

  9. Wählen Sie Speichern.

    Screenshot der Seite für die Dienstendpunktregistrierung.

Die Azure-App-Verbindung autorisieren

  1. Melden Sie sich in Ihrem Azure-Konto an und gehen Sie zu Azure-Portal.

  2. Gehen Sie zu Ressourcengruppen und suchen Sie die Ressourcengruppe, in der Sie IoT-Hub bereitgestellt haben.

  3. Wählen und bearbeiten Sie API-Verbindung Ressource commondataservice.

  4. Wählen Sie unter AllgemeinAPI-Verbindung bearbeiten und dann Autorisieren aus.

  5. Melden Sie sich mit den Dynamics 365-Anmeldeinformationen an, mit denen Sie sich in Ihrer Connected Field Service-Umgebung angemeldet haben.

    Sie unterscheiden sich eventuell von den Anmeldeinformationen, die Sie für die Anmeldung beim Azure-Portal verwenden.

  6. Wählen Sie Speichern.

devicerules.json aktualisieren

Der für Ihre Ressourcengruppe bereitgestellte Stream Analytics-Auftrag bezieht sich auf eine Datei namens devicerules.json. Diese Datei legt eine Regel fest, mit der die IoT-Warnungen erstellt werden, wenn Sie den optionalen Gerätesimulator verwenden.

Um die Regel zu verwenden, laden Sie die devicerules.json-Datei hoch. Sie müssen die genaue Verzeichnisstruktur reproduzieren, damit die Beispielwarnung funktioniert.

  1. Laden Sie die devicerules.json-Datei aus dem GitHub-Repository herunter.

  2. Öffnen Sie die Ressourcengruppe im Azure-Administratorportal und wählen Sie das für Ihre Ressourcengruppe bereitgestellte Speicherkonto aus.

  3. Wählen Sie Container aus und erstellen Sie dann einen Container namens devicerules.

  4. Öffnen Sie den neuen Container devicerules und wählen Sie Hochladen.

  5. Gehen Sie zu devicerules.json und wählen Sie es aus.

  6. Erweitern Sie den Abschnitt Erweitert. Geben Sie im Feld In Ordner hochladen2016-05-30 ein und wählen Sie dann Hochladen aus.

  7. Öffnen Sie den neuen Ordner 2016-05-30 und wählen Sie Hochladen.

  8. Gehen Sie zu devicerules.json und wählen Sie es aus.

  9. Erweitern Sie den Abschnitt Erweitert. Geben Sie im Feld In Ordner hochladen22-40 ein und wählen Sie dann Hochladen aus.

Azure Stream Analytics-Aufträge starten

  1. Wechseln Sie im Azure-Portal zu Ressourcengruppen und suchen Sie die Ressourcengruppe aus, an die Sie die IoT Hub bereitgestellt haben.

  2. Wählen Sie für jeden der Stream Analytics-Aufträge auf der Registerkarte Übersicht die Option Starten aus.

Herzlichen Glückwunsch! Sie sind jetzt bereit, Daten zwischen Azure IoT Hub und Dynamics 365 weiterzugeben, um Connected Field Service zu verwenden.

Die Azure Time Series Insights-Verbindung einrichten

Verwenden Sie Azure Time Series Insights, um Visualisierungen zu erstellen. Für diesen Schritt müssen Sie Ihre Ihre Azure-Mandanten-ID kennen.

  1. Öffnen Sie in Dynamics 365 die Connected Field Service-App.

  2. Starten Sie die Entwicklertools des Browsers und gehen Sie zur Konsole.

  3. Geben oder fügen Sie das folgende Skript in die Konsole ein und führen Sie es aus. Ersetzen Sie den Value-Parameter durch Ihre Azure-Mandanten-ID.

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. Führen Sie das Skript erneut aus. Ersetzen Sie dieses Mal Key durch TSI_PLUGIN_CLIENT_APPLICATION_ID und Value durch die Anwendungs-Client-ID aus der Time Series Insights-App-Registrierung, die Sie als eine Voraussetzung erstellt haben.

  2. Führen Sie das Skript noch einmal aus. Ersetzen Sie dieses Mal Key durch TSI_PLUGIN_CLIENT_SECRET und Value durch den geheimen Clientschlüssel aus der Time Series Insights-App-Registrierung, den Sie als eine Voraussetzung erstellt haben.

  3. Führen Sie das folgende Skript aus und verwenden Sie dabei Ihre Time Series Insights-URL und die GUID der Zeile der IoT-Anbieterinstanz in der Tabelle msdyn_iotproviderinstance für die IoT-Anbieterinstanz, die Sie zuvor erstellt haben.

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

(Optional) Simulator einrichten

Mit dem Simulator können Sie den Connected Field Service testen, ohne physische Hardware anschließen zu müssen. Simulierte IoT-Geräte und -Daten helfen Ihnen, die Teile des Systems zu verstehen, die dazu beitragen, IoT-Daten in Arbeitsaufträge umzuwandeln.

Für diesen Schritt benötigen Sie die Simulator-URL und den Primärschlüssel für die iothubowner-Richtlinie.

Den Zugriffsschlüssels abrufen

  1. Melden Sie sich in Ihrem Azure-Konto an und gehen Sie zu Azure-Portal.

  2. Gehen Sie zu Ressourcengruppen und suchen Sie die Ressourcengruppe, in der Sie IoT-Hub bereitgestellt haben.

  3. Wählen Sie die IoT Hub aus.

  4. Wählen Sie SAS-Richtlinien aus und kopieren Sie dann den Primärschlüssel für iothubowner.

    Screenshot der SAS-Richtlinie für Azure IoT Hub-Ressourcen für iothubowner, wobei der Primärschlüssel hervorgehoben ist.

Die Simulator-URL abrufen

  1. Wählen Sie in der Azure-Portal-Ressourcengruppe, in der Sie die IoT Hub bereitgestellt haben, dann den App Service-Ressourcentyp aus, der mit Simulator beginnt, und kopieren Sie die URL in die obere rechte Ecke.

  2. Fügen Sie die URL in die Adressleiste des Browsers ein und laden Sie die Seite.

  3. Wählen Sie Verbindung aus.

  4. Geben Sie den Hostnamen aus der IoT Hub-Ressource und iothubowner als Richtliniennamen ein. Fügen Sie im Feld Schlüssel den Primärschlüssel ein, den Sie zuvor kopiert haben.

    Screenshot des Fensters „Verbindung konfigurieren“ in Azure.

  5. Stellen Sie sicher, dass der VerbindungsstatusVerbunden lautet, und schließen Sie das Verbindungsfenster.

Senden Sie einen Testbefehl mithilfe des Simulators. Wählen Sie beispielsweise die Temperatur und erhöhen Sie diese auf über 70 Grad. Der Simulator ist vorprogrammiert, sodass er einen IoT-Alarm erstellt, wenn die Temperatur auf über 70 Grad steigt.

Nächste Schritte,