Installare e configurare Connected Field Service per l'hub IoT di Azure

Seguire i passaggi contenuti in questo articolo per configurare Connected Field Service per l'uso con l'hub IoT di Azure.

• Passaggio 1: distribuire le risorse di Azure e Connected Field Service da un modello di ARM
• Passaggio 2: creare un'istanza del provider IoT
• Passaggio 3. Configurare un endpoint IoT
• Passaggio 4: autorizzare la connessione dell'app Azure
• Passaggio 5: aggiornare devicerules.json
• Passaggio 6: avviare i processi di Analisi di flusso di Azure
• Passaggio 7: configurare la connessione ad Azure Time Series Insights
• Passaggio 8: configurare il simulatore (facoltativo)

Nota

Time Series Insights sarà deprecato dopo marzo 2025. Connected Field Service sta passando ad Esplora dati di Azure. Maggiori informazioni sulla transizione arriveranno presto.

Prerequisiti

• Dynamics 365 Field Service è installato.

• Assicurati di disporre del ruolo di sicurezza Amministratore di sistema e Amministratore IoT.

• Hai un abbonamento di Azure attivo con privilegi per creare risorse e servizi.

• Hai creato una registrazione dell'app per Azure Time Series Insights nel portale di Azure e disponi dell'ID applicazione (client) e dell'ID oggetto. Aggiungi un segreto client e registra il valore. Questi valori sono necessari più volte in questa procedura.

Suggerimento

Le immagini che includono un'icona simile a questa: possono essere espanse per mostrare più dettagli. Seleziona l'immagine per espanderla. Per chiuderla, premi il tasto ESC.

Distribuire le risorse di Azure e Connected Field Service da un modello di ARM

Usa un modello di gestione delle risorse di Azure (Azure Resource Manager) per distribuire l'hub IoT di Azure e connetterlo all'ambiente Field Service.

1. Seleziona Distribuisci in Azure nella pagina https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

2. Seleziona la tua sottoscrizione di Azure.

3. Seleziona un gruppo di risorse o creane uno.

4. Imposta l'area geografica sulla stessa regione del tuo ambiente Field Service.

   

5. Inserisci il nome univoco della tua organizzazione e l'URL dell'organizzazione dell'ambiente Field Service.

6. Seleziona le risorse facoltative che desideri distribuire.

   • Seleziona Simulatore di distribuzione (facoltativo) per testare e validare scenari IoT con dati campione.
   • Seleziona Azure Time Series Insights (facoltativo) per abilitare la visualizzazione delle letture del dispositivo e dei riquadri riepilogativi.
   • Seleziona Distribuire SQL Server per Power BI (opzionale) e inserisci il server SQL e le credenziali per creare i tuoi report Power BI.

7. Seleziona Rivedi e crea.

Assicurati che la distribuzione sia completa prima di procedere.

Creazione di un'istanza del provider IoT

1. Accedi a Dynamics 365 e apri l'app Connected Field Service.

2. In Connected Field Service, accedi all'area Impostazioni.

3. Seleziona Provider, quindi seleziona Nuovo.

4. Immettere le informazioni seguenti:

   

   • Nome: il nome del gruppo di risorse in Azure dove si sono distribuite le risorse di IoT
   • Provider IoT: il provider IoT per l'hub IoT
   • ID istanza provider: il nome della risorsa dell'hub IoT distribuita nel gruppo di risorse in Azure
   • URL: l'URL della panoramica per il gruppo di risorse nel portale di Azure, ad esempio, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

5. Seleziona Salva.

Ora devi aggiornare le impostazioni per la nuova istanza del provider.

1. Nell'area Impostazioni, seleziona Impostazioni IoT>Impostazioni provider IoT.

   

2. Per Provider IoT predefinito, seleziona l'istanza del provider IoT creata.

3. Selezionare Salva e chiudi.

4. Per un passaggio successivo, trova la riga Istanza del provider IoT nella tabella msdyn_iotproviderinstance e copia il GUID.

Configurazione di un endpoint IoT

Per questo passaggio è necessario conoscere il nome host dello Spazio dei nomi del bus di servizio distribuito nel gruppo di risorse.

1. Scarica la Power Platform CLI e installala.

2. Apri la CLI e avvia Plugin Registration Tool (PRT) utilizzando il comando pac tool prt.

3. Nella finestra PRT, seleziona Crea nuova connessione.

4. In Visualizza l'elenco delle organizzazioni disponibili, seleziona Office 365.

5. Seleziona Visualizza elenco delle organizzazioni disponibili e Mostra avanzate.

6. Seleziona l'area geografica dell'ambiente Field Service, inserisci le tue credenziali Field Service e seleziona Accedi.

   Se hai accesso a più organizzazioni Dynamics 365, seleziona il nome dell'organizzazione con cui desideri collaborare.

Ora devi aggiornare l'endpoint del servizio Messaggi IoT.

1. Dopo esserti connesso all'organizzazione, trova e seleziona l'endpoint del servizio Messaggio dell'IoT.

2. Selezionare Aggiorna.

3. Per Indirizzo spazio dei nomi, immetti il nome host dello spazio dei nomi del bus di servizio nello strumento di registrazione del plug-in, con il prefisso sb://; ad esempio, sb://myServiceBusNamespace.servicebus.windows.net.

4. Nella risorsa Spazio dei nomi del bus di servizio, vai a Code e trova la coda con un nome che termina con -crm. Copia il nome completo e inseriscilo come Nome argomento nello strumento per la registrazione di plug-in.

5. Per Formato messaggio, scegli XML.

6. Nella risorsa Spazio dei nomi del bus di servizio, vai a Criteri di accesso condivisi>RootManageSharedAccessKey.

7. Copia il nome e incollalo in Nome chiave SaS.

8. Copia la chiave primaria e incollala in Chiave SAS.

9. Seleziona Salva.

   

Autorizzare la connessione dell'app Azure

1. Accedi al tuo account Azure e vai al portale di Azure.

2. Vai a Gruppi di risorse e cerca il gruppo di risorse su cui hai distribuito di recente l'hub IoT.

3. Seleziona e modifica la risorsa Connessione APIcommondataservice.

4. In Generale, seleziona Modifica connessione API, quindi seleziona Autorizza.

5. Accedi con le credenziali di Dynamics 365 che si usano per accedere all'ambiente Connected Field Service.

   Potrebbero essere diverse dalle credenziali usate per accedere al portale di Azure.

6. Seleziona Salva.

Aggiornamento di devicerules.json

Il processo Analisi di flusso distribuito nel tuo gruppo di risorse fa riferimento a un file denominato devicerules.json. Questo file definisce una regola usata per creare avvisi IoT quando si usa il simulatore del dispositivo facoltativo.

Per utilizzare la regola, carica il file devicerules.json. È necessario riprodurre l'esatta struttura della directory affinché l'avviso di esempio funzioni.

1. Scarica il file devicerules.json dal Repository di GitHub.

2. Apri il gruppo di risorse nel portale di amministrazione di Azure e seleziona l'account di archiviazione distribuito nel gruppo di risorse.

3. Seleziona Contenitori e crea un contenitore chiamato devicerules.

4. Apri il nuovo contenitore devicerules e seleziona Carica.

5. Accedi e seleziona devicerules.json.

6. Espandi sezione Avanzate. Nel campo Carica nella cartella, inserisci 2016-05-30, quindi seleziona Carica.

7. Apri la nuova cartella 2016-05-30 e seleziona Carica.

8. Accedi e seleziona devicerules.json.

9. Espandi sezione Avanzate. Nel campo Carica nella cartella, inserisci 22-40, quindi seleziona Carica.

Avviare i processi di Analisi di flusso di Azure

1. Nel portale di Azure, vai a Gruppi di risorse e cerca il gruppo di risorse su cui hai distribuito l'hub IoT.

2. Seleziona ogni processo di Analisi di flusso distribuito, nella scheda Panoramica seleziona Avvia.

Congratulazioni. A questo punto sei pronto per trasferire i dati tra l'hub IoT di Azure e Dynamics 365 per utilizzare Connected Field Service.

Configurare la connessione ad Azure Time Series Insights

Usa Azure Time Series Insights per creare visualizzazioni. Per questo passaggio, devi conoscere il tuo ID tenant di Azure.

1. In Dynamics 365 apri l'app Connected Field Service.

2. Avvia gli strumenti per sviluppatori di browser e accedi alla console.

3. Digita o incolla il seguente script nella console ed eseguilo. Sostituisci il parametro Value con l'ID tenant di 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. Esegui nuovamente lo script. Questa volta, sostituisci Key con TSI_PLUGIN_CLIENT_APPLICATION_ID e Value con l'ID client dell'applicazione dalla registrazione dell'app Time Series Insights creata come prerequisito.

2. Esegui lo script un'altra volta. Questa volta, sostituisci Key con TSI_PLUGIN_CLIENT_SECRET e Value con il segreto del client dalla registrazione dell'app Time Series Insights creata come prerequisito.

3. Esegui lo script seguente, utilizzando l'URL di Time Series Insights e il GUID della riga dell'istanza del provider IoT nella tabella msdyn_iotproviderinstance per l'istanza del provider IoT creata in precedenza.

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

(Facoltativo) Configurare il simulatore

Il simulatore ti consente di testare Connected Field Service senza la necessità di connettere hardware fisico. Simulando dati e dispositivi IoT, puoi comprendere tutte le diverse parti del sistema che contribuiscono a trasformare i dati IoT in ordini di lavoro.

Per questo passaggio sono necessari l'URL del simulatore e la chiave primaria per i criteri iothubowner.

Ottieni la chiave di accesso

1. Accedi al tuo account Azure e vai al portale di Azure.

2. Vai a Gruppi di risorse e cerca il gruppo di risorse su cui hai distribuito di recente l'hub IoT.

3. Seleziona l'hub IoT.

4. Seleziona Criteri di accesso condiviso, quindi copia la chiave primaria per iothubowner.

   

Ottieni l'URL del simulatore

1. Nel gruppo di risorse portale di Azure in cui hai distribuito l'hub IoT, seleziona il tipo di risorsa del servizio app che inizia con Simulator e copia l'URL nell'angolo in alto a destra.

2. Incolla l'URL nella barra degli indirizzi del browser e carica la pagina.

3. Selezionare Connessione.

4. Immetti il nome host dalla risorsa dell'hub IoT e iothubowner come nome criterio. Nel campo Chiave, incolla la chiave primaria che hai copiato in precedenza.

   

5. Verifica che l'opzione Stato di connessione sia Collegato quindi chiudi la finestra di dialogo della connessione.

Invia un comando di prova usando il simulatore. Ad esempio, seleziona la temperatura e aumentala fino a un valore superiore a 70 gradi. Il simulatore è preprogrammato per creare un avviso IoT se la temperatura è superiore a 70 gradi.

Passaggi successivi

• Registrare i dispositivi
• Esegui pull dei dati del dispositivo
• Visualizzare le letture dei dispositivi