Condividi tramite

Esercitazione: Connettere Logic App alla soluzione preconfigurata Remote Monitoring di Azure IoT Suite

La soluzione preconfigurata di monitoraggio remoto di Microsoft Azure IoT Suite è un ottimo modo per iniziare rapidamente a usare un set di funzionalità end-to-end che esemplifica una soluzione IoT. Questa esercitazione illustra come aggiungere app per la logica alla soluzione preconfigurata di monitoraggio remoto di Microsoft Azure IoT Suite. Questi passaggi illustrano come è possibile portare ulteriormente la soluzione IoT connettendola a un processo aziendale.

Per una procedura dettagliata su come effettuare il provisioning di una soluzione preconfigurata di monitoraggio remoto, vedere Esercitazione: Introduzione alle soluzioni preconfigurate IoT.

Prima di iniziare questa esercitazione, è necessario:

  • Effettua il provisioning della soluzione preconfigurata di monitoraggio remoto nella sottoscrizione di Azure.
  • Creare un account SendGrid per consentire di inviare un messaggio di posta elettronica che attiva il processo aziendale. È possibile iscriversi per ottenere un account di valutazione gratuito in SendGrid facendo clic su Prova gratuitamente. Dopo aver eseguito la registrazione per l'account di valutazione gratuita, è necessario creare una chiave API in SendGrid che concede le autorizzazioni per inviare messaggi di posta elettronica. Questa chiave API è necessaria più avanti nell'esercitazione.

Per completare questa esercitazione, è necessario Visual Studio 2015 o Visual Studio 2017 per modificare le azioni nel back-end della soluzione preconfigurata.

Supponendo di aver già effettuato il provisioning della soluzione preconfigurata di monitoraggio remoto, passare al gruppo di risorse per tale soluzione nel portale di Azure. Il gruppo di risorse ha lo stesso nome del nome della soluzione scelto durante il provisioning della soluzione di monitoraggio remoto. Nel gruppo di risorse è possibile visualizzare tutte le risorse di Azure di cui è stato effettuato il provisioning per la soluzione. Lo screenshot seguente mostra un esempio di finestra gruppo di risorse per una soluzione di telemonitoraggio preconfigurata:

Per iniziare, configurare l'app logica da usare con la soluzione preconfigurata.

Configurare l'app logica

  1. Fare clic su Aggiungi nella parte superiore del pannello del gruppo di risorse nel portale di Azure.

  2. Cercare Logic App, selezionarla e quindi fare clic su Crea.

  3. Compilare il campo Nome e usare lo stesso abbonamento e gruppo di risorse che hai utilizzato quando hai fornito la soluzione di monitoraggio a distanza. Clicca su Crea.

  4. Al termine della distribuzione, è possibile vedere che l'app per la logica è elencata come risorsa nel gruppo di risorse.

  5. Fare clic su Logic App per passare al blocco Logic App, selezionare il modello Blank Logic App per aprire il Designer di Logic Apps.

  6. Selezionare Richiesta. Questa azione specifica che una richiesta HTTP in ingresso con un payload in formato JSON specifico funge da trigger.

  7. Incollare il codice seguente nello schema JSON del corpo della richiesta:

    {
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "/",
  "properties": {
    "DeviceId": {
      "id": "DeviceId",
      "type": "string"
    },
    "measuredValue": {
      "id": "measuredValue",
      "type": "integer"
    },
    "measurementName": {
      "id": "measurementName",
      "type": "string"
    }
  },
  "required": [
    "DeviceId",
    "measurementName",
    "measuredValue"
  ],
  "type": "object"
}

    Annotazioni

    È possibile copiare l'URL per il post HTTP dopo aver salvato l'app per la logica, ma è prima necessario aggiungere un'azione.

  8. Fare clic su + Nuovo passo sotto il trigger manuale. Fare quindi clic su Aggiungi un'azione.

  9. Cercare SendGrid - Invia messaggio di posta elettronica e fare clic su di esso.

  10. Immettere un nome per la connessione, ad esempio SendGridConnection, immettere la chiave API SendGrid creata durante la configurazione dell'account SendGrid e fare clic su Crea.

  11. Aggiungi gli indirizzi email che possiedi nei campi Da e A. Aggiungere un avviso di monitoraggio remoto [DeviceId] al campo Oggetto . Nel campo Corpo del messaggio di posta elettronica aggiungere Device [DeviceId] ha segnalato [measurementName] con valore [measuredValue]. È possibile aggiungere [DeviceId], [measurementName]e [measuredValue] facendo clic nella sezione È possibile inserire dati dai passaggi precedenti .

  12. Fare clic su Salva nel menu in alto.

  13. Fare clic sul trigger Richiesta e copiare il valore Http Post a questo URL. Questo URL sarà necessario più avanti in questa esercitazione.

Annotazioni

App per la logica consente di eseguire molti tipi diversi di azioni , incluse le azioni in Office 365.

Configurare il Web Job di elaborazione eventi

In questa sezione connetti la soluzione preconfigurata all'applicazione Logic che hai creato. Per completare questa attività, aggiungere l'URL per attivare la Logic App all'azione che viene avviata quando un valore del sensore del dispositivo supera una soglia.

  1. Usa il client git per clonare la versione più recente del repository GitHub azure-iot-remote-monitoring. Per esempio:

    git clone https://github.com/Azure/azure-iot-remote-monitoring.git

  2. In Visual Studio aprire il RemoteMonitoring.sln dalla copia locale del repository.

  3. Aprire il file ActionRepository.cs nella cartella Infrastructure\Repository .

  4. Aggiorna il dizionario actionIds con il Http Post a questo URL che hai annotato dalla tua Logic App come segue:

    private Dictionary<string,string> actionIds = new Dictionary<string, string>()
{
    { "Send Message", "<Http Post to this URL>" },
    { "Raise Alarm", "<Http Post to this URL>" }
};

  5. Salvare le modifiche nella soluzione e uscire da Visual Studio.

Eseguire la distribuzione dalla riga di comando

In questa sezione viene distribuita la versione aggiornata della soluzione di monitoraggio remoto per sostituire la versione attualmente in esecuzione in Azure.

  1. Seguendo le istruzioni di configurazione dell'ambiente di sviluppo per configurare l'ambiente per la distribuzione.

  2. Per eseguire la distribuzione in locale, seguire le istruzioni di distribuzione locali .

  3. Per eseguire la distribuzione nel cloud e aggiornare la distribuzione cloud esistente, seguire le istruzioni di distribuzione cloud . Utilizza il nome della distribuzione originale come nome della distribuzione. Ad esempio, se la distribuzione originale è stata chiamata demologicapp, usare il comando seguente:

    build.cmd cloud release demologicapp

    Quando viene eseguito lo script di compilazione, assicurarsi di usare lo stesso account Azure, la sottoscrizione, l'area e l'istanza di Active Directory usata al momento del provisioning della soluzione.

Guarda la tua Logic App in azione

La soluzione preconfigurata di monitoraggio remoto include due regole configurate per impostazione predefinita quando si effettua il provisioning di una soluzione. Entrambe le regole si trovano nel dispositivo SampleDevice001 :

  • Temperatura > 38,00
  • Umidità > 48,00

La regola di temperatura attiva l'azione Genera allarme e la regola Umidità attiva l'azione SendMessage . Supponendo che tu abbia utilizzato lo stesso URL per entrambe le azioni della classe ActionRepository, la tua app logica si attiva per ciascuna delle regole. Entrambe le regole usano SendGrid per inviare un messaggio di posta elettronica all'indirizzo A con i dettagli dell'avviso.

Annotazioni

L'app per la logica continua a essere attivata ogni volta che viene raggiunta la soglia. Per evitare messaggi di posta elettronica non necessari, è possibile disabilitare le regole nel portale della soluzione o disabilitare l'app per la logica nel portale di Azure.

Oltre a ricevere messaggi di posta elettronica, è anche possibile vedere quando l'app per la logica viene eseguita nel portale:

Passaggi successivi

Ora che è stata usata un'app per la logica per connettere la soluzione preconfigurata a un processo aziendale, è possibile ottenere altre informazioni sulle opzioni per personalizzare le soluzioni preconfigurate:

  • Last updated on