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

Importante

Il grafico delle letture del dispositivo si basa su Azure Time Series Insights, la cui dismissione era inizialmente prevista per marzo 2025. Tuttavia, il servizio verrà ritirato il 7 luglio 2024 e dopo tale data il grafico non sarà più disponibile. Scopri di più: Il servizio Time Series Insights verrà ritirato il 7 luglio 2024.

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 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 API commondataservice.

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 che crea avvisi IoT.

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.

Passaggi successivi

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