Connected Field Servicen asentaminen ja määrittäminen Azure IoT Hubia varten

Määritä Connected Field Service käytettäväksi Azure IoT Hubin kanssa noudattamalla tämän artikkelin ohjeita.

• Vaihe 1: Connected Field Servicen ja Azure-resurssien käyttöönotto ARM-mallista
• Vaihe 2: Luo IoT-palveluntarjoajan esiintymä
• Vaihe 3: IoT-päätepisteen määrittäminen
• Vaihe 4: Azure-sovelluksen yhteyden valtuuttaminen
• Vaihe 5: Päivitä devicerules.json
• Vaihe 6: Käynnistä Azure Stream Analytics -työt
• Vaihe 7: Määritä Azure Time Series Insights -yhteys
• Vaihe 8: (valinnainen) Simulaattorin määrittäminen

Muistiinpano

Aikasarjojen tiedot (Time Series Insights, TSI) vanhentuu maaliskuun 2025 jälkeen. Connected Field Service siirtyy Azure Data Explorerin käyttöön. Lisätietoa siirrosta on tulossa pian.

edellytykset

• Dynamics 365 Field Service on asennettuna.

• Sinulla on Järjestelmänvalvoja- ja IoT-järjestelmänvalvoja-käyttöoikeusroolit.

• Sinulla on aktiivinen Azure-tilaus, jolla on oikeudet luoda resursseja ja palveluita.

• Olet luonut sovellusrekisteröinnin Azure Time Series Insightsille Azure-portaalissa ja sinulla on sovelluksen (asiakasohjelman) tunnus ja objektitunnus. Lisää asiakassalaisuus ja tallenna arvo. Tarvitset näitä arvoja useita kertoja tässä menettelyssä.

Vihje

Kuvat, joissa on kuvake: voidaan laajentaa tarkempien yksityiskohtien näyttämiseksi. Valitse kuva laajentamista varten. Voit sulkea sen painamalla Esc-näppäintä.

Connected Field Servicen ja Azure-resurssien käyttöönotto ARM-mallista

Ota Azure IoT Hub käyttöön ja yhdistä se Field Service -ympäristöösi Azure Resource Management (Azure Resource Manager) -mallin avulla.

1. Valitse Ota käyttöön Azuressa sivulla https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

2. Valitse Azure-tilaus.

3. Valitse resurssiryhmä tai luo uusi.

4. Määritä alueeksi sama alue kuin Field Service -ympäristöllesi.

   

5. Syötä organisaatiosi yksilöllinen nimi ja Field Service -ympäristön organisaatio-URL-osoite.

6. Valitse valinnaiset resurssit, jotka haluat ottaa käyttöön.

   • Valitse Ota simulaattori käyttöön (valinnainen) testataksesi ja validoidaksesi IoT-skenaarioita esimerkkitietojen avulla.
   • Valitse Azure Time Series Insights (valinnainen) ottaaksesi käyttöön laitelukemien ja yhteenvetoruutujen visualisoinnit.
   • Valitse Ota käyttöön SQL Server Power BI:lle (valinnainen) ja anna SQL Serverin tiedot sekä kirjautumistiedot luodaksesi omia raporttejasi Power BI:ssä.

7. Valitse Tarkista ja luo.

Varmista, että käyttöönotto on valmis, ennen kuin jatkat.

IoT-tarjoajan esiintymän luonti

1. Kirjaudu sisään Dynamics 365 -sovellukseen ja avaa Connected Field Service -sovellus.

2. Siirry Connected Field Servicessa Asetukset-alueeseen.

3. Valitse Toimittajat ja sitten Uusi.

4. Anna seuraavat tiedot:

   

   • Nimi: Sen resurssiryhmän nimi Azuressa, jossa otit käyttöön IoT-resurssit
   • IoT-palveluntarjoaja : IoT Hubin IoT-palveluntarjoaja
   • Palveluntarjoajan ilmentymän tunnus: IoT Hub -resurssin nimi, jonka otit käyttöön resurssiryhmääsi Azuressa
   • URL-osoite: Azure-portaalin resurssiryhmän yleiskatsauksen URL-osoite, esimerkiksi https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

5. Valitse Tallenna.

Sinun on nyt päivitettävä uuden palveluntarjoajan esiintymän asetukset.

1. Valitse Asetukset-alueessa IoT-asetukset>IoT-tarjoajan asetukset.

   

2. Valitse IoT-oletustarjoaja -kohdassa luomasi IoT-palveluntarjoajan ilmentymä.

3. Valitse Tallenna ja sulje.

4. Etsi myöhempää vaihetta varten IoT-palveluntarjoajan ilmentymä -rivi msdyn_iotproviderinstance-taulukosta ja kopioi GUID.

IoT-päätepisteen määrittäminen

Tätä vaihetta varten sinun on tiedettävä palvelimen isäntänimi palveluväylän nimiavaruudelle, joka on otettu käyttöön resurssiryhmääsi.

1. Lataa Power Platform CLI ja asenna se.

2. Avaa CLI ja käynnistä Plugin Registration Tool (PRT) komennolla pac tool prt.

3. Valitse PRT-ikkunassa Luo uusi yhteys.

4. Valitse kohdassa Näytä käytettävissä olevien organisaatioiden luetteloOffice 365.

5. Valitse Näytä käytettävissä olevien organisaatioiden luettelo ja sitten Näytä lisäasetukset.

6. Valitse Field Service -ympäristön alue, anna Field Service -tunnistetietosi ja valitse Kirjaudu.

   Jos sinulla on pääsy useisiin Dynamics 365 -organisaatioihin, valitse sen organisaation nimi, jossa haluat työskennellä.

Nyt sinun on päivitettävä IoT-viestipalvelun päätepiste.

1. Kun olet muodostanut yhteyden organisaatioon, etsi ja valitse IoT-viesti -palvelun päätepiste.

2. Valitse Päivitä.

3. Kirjoita Plug-in Registration Tool -työkalussa Nimitilan osoite -kohtaan palveluväylän nimitilan isäntänimi, jonka etuliitteenä on sb://, esimerkiksi sb://myServiceBusNamespace.servicebus.windows.net.

4. Siirry Palveluväylän nimitila -resurssissa Jonot-kohtaan ja etsi jono, jonka nimi päättyy -crm. Kopioi koko nimi ja kirjoita se aiheen nimenä laajennuksen rekisteröintityökalussa.

5. Valitse SanomamuodoksiXML.

6. Siirry Palveluväylän nimitila -resurssissa kohtaan Jaetut käyttöoikeuskäytännöt>RootManageSharedAccessKey.

7. Kopioi nimi ja liitä se SaS-avaimen nimi -kohtaan.

8. Kopioi perusavain ja liitä se SAS-avain-kohtaan.

9. Valitse Tallenna.

   

Azure-sovelluksen yhteyden valtuuttaminen

1. Kirjaudu sisään Azure-tiliisi ja siirry Azure-portaaliin.

2. Siirry kohtaan Resurssiryhmät ja etsi resurssiryhmä, johon olet ottanut IoT Hubin käyttöön.

3. Valitse API-yhteysresurssicommondataservice.

4. Valitse Yleiset-kohdassa Muokkaa ohjelmointirajapintayhteyttä ja valitse sitten Valtuuta.

5. Kirjaudu sisään Dynamics 365 -tunnistetiedoilla, joilla kirjaudut Connected Field Service -ympäristöön.

   Ne voivat poiketa valtuustiedoista, joita käytät kirjautuessasi Azure-portaaliin.

6. Valitse Tallenna.

Päivitä devicerules.json

Resurssiryhmääsi käyttöön otettu Stream Analytics -työ viittaa tiedostoon, jonka nimi on devicerules.json. Tämä tiedosto määrittää säännön, joka luo IoT-hälytyksiä, kun käytät valinnaista laitesimulaattoria.

Voit käyttää sääntöä lataamalla devicerules.json-tiedoston. Sinun on toistettava hakemistorakenne tarkasti, jotta esimerkkihälytys toimii.

1. Lataa devicerules.json-tiedosto GitHub-säilöstä.

2. Avaa resurssiryhmä Azure-hallintaportaalissa ja valitse resurssiryhmälläsi käyttöön otettu tallennustilatili.

3. Valitse Säilöt ja luo sitten säilö nimeltä devicerules.

4. Avaa uusi säilö devicerules ja valitse Lataa palvelimeen.

5. Selaa ja valitse devicerules.json.

6. Laajenna lisäasetusten osa. Kirjoita Lataa kansioon -kenttään 2016-05-30 ja valitse sitten Lataa palvelimeen.

7. Avaa uusi kansio 2016-05-30 ja valitse Lataa palvelimeen.

8. Selaa ja valitse devicerules.json.

9. Laajenna lisäasetusten osa. Kirjoita Lataa kansioon -kenttään 22-40 ja valitse sitten Lataa palvelimeen.

Käynnistä Azure Stream Analytics -työt

1. Siirry Azure-portaalissa kohtaan Resurssiryhmät ja etsi resurssiryhmä, johon olet äskettäin ottanut IoT Hubin käyttöön.

2. Valitse kukin Stream Analytics -työ ja valitse Yleiskatsaus-välilehdestä Aloita.

Onnittelut! Nyt voit siirtää tietoja Azure IoT Hub- ja Dynamics 365 -järjestelmän välillä käyttämällä Connected Field Serviceä.

Määritä Azure Time Series Insights -yhteys

Käytä Azure Time Series Insightsisa visualisointien luomiseen. Tätä vaihetta varten sinun on tiedettävä Azure-vuokraajatunnuksesi.

1. Avaa Dynamics 365:ssä Connected Field Service -sovellus.

2. Käynnistä selaimen kehittäjätyökalut ja siirry konsoliin.

3. Kirjoita tai liitä seuraava komentosarja konsoliin ja suorita se. Korvaa Value-parametri Azure-vuokraajatunnuksellasi.

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. Suorita komentosarja uudelleen. Korvaa tällä kertaa Key arvolla TSI_PLUGIN_CLIENT_APPLICATION_ID ja Value sovelluksen asiakastunnuksella Time Series Insights -sovellusrekisteröinnistä, jonka loit edellytyksenä.

2. Suorita skripti vielä kerran. Korvaa tällä kertaa Key arvolla TSI_PLUGIN_CLIENT_SECRET ja Value asiakassalaisuudella Time Series Insights -sovellusrekisteröinnistä, jonka loit edellytyksenä.

3. Suorita seuraava komentosarja käyttämällä Time Series Insights -URL-osoitettasi ja IoT-palveluntarjoajan ilmentymän rivin GUID-tunnusta msdyn_iotproviderinstance-taulukossa aiemmin luomasi IoT-palveluntarjoajan ilmentymälle.

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

(Valinnainen) Simulaattorin määrittäminen

Simulaattorin avulla voit testata Connected Field Servicen ilman fyysistä laitteistoa. IoT-laitteiden ja -tietojen simuloinnin avulla saat lisätietoja järjestelmän osista, jotka osallistuvat IoT-tietojen muuttamisessa työtilauksiksi.

Tätä vaihetta varten tarvitset simulaattorin URL-osoitteen ja iothubowner-käytännön perusavaimen.

Hanki käyttöoikeusavain

1. Kirjaudu sisään Azure-tiliisi ja siirry Azure-portaaliin.

2. Siirry kohtaan Resurssiryhmät ja etsi resurssiryhmä, johon olet ottanut IoT Hubin käyttöön.

3. Valitse IoT Hub.

4. Valitse Jaetut käyttöoikeuskäytännöt ja kopioi sitten iothubowner-perusavain.

   

Hanki simulaattorin URL-osoite

1. Valitse Azure-portaalin resurssiryhmästä, jossa otit käyttöön IoT Hubin, Sovelluspalvelu-resurssityyppi, jonka alussa on Simulator , ja kopioi URL-osoite oikeassa yläkulmassa.

2. Lataa sivu liittämällä URL-osoite selaimen osoiteriville.

3. Valitse Yhteys.

4. Kirjoita isäntänimi IoT Hub -resurssista ja käytännön nimeksi iothubowner. Liitä Avain-kenttään perusavain, jonka kopioit aiemmin.

   

5. Varmista, että Yhteystila on Yhdistetty ja sulje sitten yhteysikkuna.

Voit lähettää testikomennon simulaattorin avulla. Napsauta esimerkiksi lämpötilaa ja nosta se yli 70 asteeseen. Simulaattori on esiohjelmoitu niin, että se luo IoT-hälytyksen, jos lämpötila nousee yli 70 asteen.

Seuraavat vaiheet

• Rekisteröi laitteita
• Nouda laitteen tiedot
• Laitteen lukemien visualisointi