Delen via

Connected Field Service voor Azure IoT Hub installeren en configureren

  • Artikel

Volg de stappen in dit artikel om Connected Field Service in te stellen voor gebruik met Azure IoT Hub.

Opmerking

Time Series Insights wordt na maart 2025 afgeschaft. Connected Field Service gaat over naar Azure Data Explorer. Meer informatie over de overgang volgt binnenkort.

Vereisten

Fooi

Afbeeldingen met een pictogram dat er zo uitziet: kunnen worden uitgevouwen om meer details weer te geven. Selecteer de afbeelding om deze uit te vouwen. Druk op de Esc-toets om deze te sluiten.

Implementeer Connected Field Service en Azure-resources vanuit een ARM-sjabloon

Gebruik een Azure Resource Management-sjabloon (Azure Resource Manager) om Azure IoT Hub te implementeren en te verbinden met uw Field Service-omgeving.

  1. Selecteer Implementeren in Azure op de pagina https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

  2. Selecteer uw Azure-abonnement.

  3. Selecteer een resourcegroep of maak er een.

  4. Stel de regio in op dezelfde regio als die van uw Field Service-omgeving.

    Schermopname van de Azure Resource Manager-sjabloon om IoT Hub voor Connected Field Service te implementeren.

  5. Voer de unieke naam van uw organisatie in en de organisatie-URL van de Field Service-omgeving.

  6. Selecteer de optionele resources die u wilt implementeren.

    • Selecteer Simulator implementeren (optioneel) om IoT-scenario's te testen en te valideren met voorbeeldgegevens.
    • Selecteer Azure Time Series Insights (optioneel) om visualisaties van apparaatmetingen en overzichtstegels mogelijk te maken.
    • Selecteer Implementeer SQL Server voor Power BI (optioneel) en voer de SQL-server en inloggegevens in om uw eigen rapporten te maken in Power BI.

  7. Selecteer Controleren en maken.

Zorg ervoor dat de implementatie is voltooid voordat u doorgaat.

Een exemplaar van een IoT-provider maken

  1. Meld u aan bij Dynamics 365 en open de app Connected Field Service.

  2. Ga in Connected Field Service naar het gebied Instellingen.

  3. Selecteer Providers en selecteer vervolgens Nieuw.

  4. Voer de volgende informatie in:

    Schermopname van een nieuwe IoT-hub-providerexemplaar met voorbeeldgegevens.

    • Naam: De naam van de resourcegroep in Azure waar u IoT-resources hebt geïmplementeerd
    • IoT-provider: De IoT-provider voor IoT Hub
    • Provider-exemplaar-id: De naam van de IoT Hub-resource die u in uw resourcegroep in Azure hebt geïmplementeerd
    • URL: De URL van het overzicht voor de resourcegroep in de Azure Portal, bijvoorbeeld https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

  5. Selecteer Opslaan.

U moet nu de instellingen voor het nieuwe provider-exemplaar bijwerken.

  1. Selecteer in het gebied Instellingen de optie IoT-instellingen>Instellingen voor IoT-provider.

    Schermopname van de pagina IoT-instellingen.

  2. Selecteer voor Standaard IoT-provider het IoT-provider-exemplaar dat u hebt gemaakt.

  3. Selecteer Opslaan en sluiten.

  4. Zoek voor een latere stap de rij IoT-provider-exemplaar in de tabel msdyn_iotproviderinstance en kopieer de GUID.

Stel een IoT-eindpunt in

Voor deze stap moet u de hostnaam voor de Service Bus-naamruimte weten die naar uw resourcegroep is geïmplementeerd.

  1. Download de Power Platform-CLI en installeer deze.

  2. Open de CLI en start de Plugin Registration Tool (PRT) met behulp van de opdracht pac tool prt.

  3. Selecteer Nieuwe verbinding maken in het PRT-venster.

  4. Selecteer in Lijst met beschikbare organisaties weergeven de optie Office 365.

  5. Selecteer Een lijst met beschikbare organisaties weergeven en vervolgens Geavanceerd weergeven.

  6. Selecteer de regio van uw Field Service-omgeving, voer uw Field Service-referenties in en selecteer Aanmelden.

    Als u toegang hebt tot meerdere Dynamics 365-organisaties, selecteert u de naam van de organisatie waarmee u wilt werken.

Nu moet u het service-eindpunt voor de IoT-berichten bijwerken.

  1. Nadat u bent verbonden met de organisatie, zoekt en selecteert u het service-eindpunt voor IoT-berichten.

  2. Selecteer Bijwerken.

  3. Voer bij Adres NameSpace de hostnaam van de Service Bus-naamruimte in de Plug-in Registration Tool in, voorafgegaan door sb://, bijvoorbeeld sb://myServiceBusNamespace.servicebus.windows.net.

  4. Ga in de resource Service Bus-naamruimte naar Wachtrijen en zoek de wachtrij met een naam die eindigt op -crm. Kopieer de volledige naam en voer deze in als de onderwerpnaam in de Plug-in Registration Tool.

  5. Voor Berichtindeling kiest u XML.

  6. Ga in de resource Service Bus-naamruimte naar Beleidsregels voor gedeelde toegang>RootManageSharedAccessKey.

  7. Kopieer de naam en plak deze in Naam van SaS-sleutel.

  8. Kopieer de primaire sleutel en plak deze in SAS-sleutel.

  9. Selecteer Opslaan.

    Schermopname van de pagina Service-eindpuntregistratie.

Autoriseer de Azure-app-verbinding

  1. Meld u aan bij uw Azure-account en ga naar de Azure Portal.

  2. Ga naar Resourcegroepen en zoek de resourcegroep waar u de IoT Hub naar hebt geïmplementeerd.

  3. Selecteer en bewerk de API-verbinding resource commondataservice.

  4. Selecteer onder Algemeen de optie API-verbinding bewerken en selecteer vervolgens Autoriseren.

  5. Meld u aan met de Dynamics 365-referenties die u gebruikt om u aan te melden bij uw Connected Field Service-omgeving.

    Deze kunnen afwijken van de referenties die u gebruikt om u aan te melden bij de Azure Portal.

  6. Selecteer Opslaan.

Werk devicerules.json bij

De taak Stream Analytics die in uw resourcegroep is geïmplementeerd, verwijst naar een bestand met de naam devicerules.json. Dit bestand definieert een regel die IoT-waarschuwingen maakt wanneer u de optionele apparaatsimulator gebruikt.

Om de regel te gebruiken, uploadt u het bestand devicerules.json. U moet de exacte mapstructuur reproduceren om de voorbeeldwaarschuwing te laten werken.

  1. Download het devicerules.json-bestand uit de GitHub-opslagplaats.

  2. Open de resourcegroep in de Azure-beheerportal en selecteer het opslagaccount dat is geïmplementeerd voor uw resourcegroep.

  3. Selecteer Containers en maak vervolgens een container met de naam devicerules.

  4. Open de nieuwe container devicerules en selecteer Uploaden.

  5. Zoek naar en selecteer devicerules.json.

  6. Vouw de sectie Geavanceerd uit. Voer in het veld Uploaden naar map, voer 2016-05-30 in en selecteer vervolgens Uploaden.

  7. Open de nieuwe map 2016-05-30 en selecteer Uploaden.

  8. Zoek naar en selecteer devicerules.json.

  9. Vouw de sectie Geavanceerd uit. Voer in het veld Uploaden naar map22-40 in en selecteer vervolgens Uploaden.

Start de Azure Stream Analytics-taken

  1. Ga in de Azure Portal naar Resourcegroepen en zoek de resourcegroep waar u IoT Hub naar hebt geïmplementeerd.

  2. Selecteer elke Stream Analytics-taak en selecteer op het tabblad Overzicht de optie Starten.

Gefeliciteerd! U bent nu klaar om gegevens door te geven tussen Azure IoT Hub en Dynamics 365 om Connected Field Service te gebruiken.

Stel de Azure Time Series Insights-verbinding in

Gebruik Azure Time Series Insights om visualisaties te maken. Voor deze stap moet u uw Azure-tenant-id kennen.

  1. Open in Dynamics 365 de app Connected Field Service.

  2. Start de ontwikkelingshulpmiddelen voor browsers en ga naar de console.

  3. Typ of plak het volgende script in de console en voer het uit. Vervang de parameter Value door uw Azure-tenant-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. Voer het script nogmaals uit. Vervang dit keer Key door TSI_PLUGIN_CLIENT_APPLICATION_ID en Value door de toepassings-client-id van de Time Series Insights-app-registratie die u hebt gemaakt als voorwaarde.

  2. Voer het script nog een keer uit. Vervang dit keer Key door TSI_PLUGIN_CLIENT_SECRET en Value door het clientgeheim van de Time Series Insights-app-registratie die u hebt gemaakt als voorwaarde.

  3. Voer het volgende script uit met behulp van uw Time Series Insights-URL en de GUID van de IoT-provider-exemplaarrij in de tabel msdyn_iotproviderinstance voor het IoT-provider-exemplaar dat u eerder hebt gemaakt.

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

(Optioneel) Stel de simulator in

Met de simulator kunt u Connected Field Service testen zonder dat u fysieke hardware hoeft aan te sluiten. Door IoT-apparaten en -gegevens te simuleren, krijgt u inzicht in de verschillende onderdelen van het systeem die bijdragen aan het omzetten van IoT-gegevens in werkorders.

Voor deze stap hebt u de simulator-URL en de primaire sleutel voor het iothubowner-beleid nodig.

Haal de toegangssleutel op

  1. Meld u aan bij uw Azure-account en ga naar de Azure Portal.

  2. Ga naar Resourcegroepen en zoek de resourcegroep waar u de IoT Hub naar hebt geïmplementeerd.

  3. Selecteer de IoT-hub.

  4. Selecteer Beleid voor gedeelde toegang en kopieer vervolgens de primaire sleutel voor iothubowner.

    Schermopname van het beleid voor gedeelde toegang voor Azure IoT Hub-resource voor iothubowner, waarbij de primaire sleutel is gemarkeerd.

Haal de simulator-URL op

  1. In de Azure Portal resourcegroep waarin u IoT Hub hebt geïmplementeerd, selecteert u het App Service-resourcetype dat begint met Simulator en kopieert u de URL in de rechter bovenhoek.

  2. Plak de URL in de adresbalk van uw browser en laad de pagina.

  3. Selecteer Verbinding.

  4. Voer de hostnaam van de IoT Hub-resource en iothubowner als de beleidsnaam in. Plak in het veld Sleutel de primaire sleutel die u eerder hebt gekopieerd.

    Schermopname van het venster Verbinding configureren in Azure.

  5. Let erop dat VerbindingsstatusVerbonden is en sluit vervolgens het verbindingsvenster.

Stuur een testopdracht via de simulator. Selecteer bijvoorbeeld de temperatuur en verhoog deze tot meer dan 70 graden. De simulator is voorgeprogrammeerd om een IoT-waarschuwing te maken als de temperatuur stijgt tot boven 70 graden.

Volgende stappen