Tutorial: conectar um aplicativo lógico à solução pré-configurada de monitoramento remoto do Azure IoT Suite

Artigo
11/02/2017

A solução pré-configurada de monitoramento remoto do Microsoft Azure IoT Suite é uma ótima maneira de começar rapidamente com um conjunto de recursos de ponta a ponta que é um exemplo de uma solução IoT. Este tutorial explica como adicionar um aplicativo lógico à sua solução pré-configurada de monitoramento remoto do Microsoft Azure IoT Suite. Essas etapas demonstram como é possível aproveitar ainda mais sua solução de IoT conectando-a a um processo empresarial.

Se você estiver procurando um passo a passo sobre como provisionar uma solução pré-configurada de monitoramento remoto, consulte Tutorial: introdução às soluções IoT pré-configuradas.

Antes de iniciar este tutorial, você deve:

Provisionar a solução pré-configurada de monitoramento remoto na sua assinatura do Azure.
Criar uma conta SendGrid para que você possa enviar um email que dispare o processo empresarial. Você pode se inscrever para uma conta de avaliação gratuita no SendGrid clicando em Teste gratuitamente. Depois de fazer o registro para sua conta de avaliação gratuita, você precisa criar uma chave de API no SendGrid, que concede permissões para enviar email. Você precisa dessa chave de API mais tarde no tutorial.

Para concluir este tutorial, você precisa do Visual Studio 2015 ou Visual Studio 2017 para modificar as ações no back-end da solução pré-configurada.

Supondo que você já tenha provisionado a solução pré-configurada de monitoramento remoto, navegue até o grupo de recursos dessa solução no Portal do Azure. O grupo de recursos tem o mesmo nome que o nome da solução que você escolheu quando provisionou sua solução de monitoramento remoto. No grupo de recursos, você pode ver todos os recursos do Azure provisionados para sua solução. A captura de tela a seguir mostra uma folha Grupo de recursos de exemplo para uma solução pré-configurada de monitoramento remoto:

Para começar, configure o aplicativo lógico a ser usado com a solução pré-configurada.

Configurar o aplicativo lógico

Clique em Adicionar na parte superior da folha de seu grupo de recursos no Portal do Azure.
Procure o Aplicativo Lógico, selecione-o e clique em Criar.
Preencha o Nome e use a mesma Assinatura e o Grupo de recursos que você usou ao provisionar sua solução de monitoramento remoto. Clique em Criar.
Quando a implantação for concluída, você verá que o Aplicativo Lógico estará listado como um recurso em seu grupo de recursos.
Clique no Aplicativo Lógico para navegar até a folha Aplicativo Lógico, escolha o modelo Aplicativo Lógico em Branco para abrir o Designer de Aplicativos Lógicos.
Selecione Solicitação. Essa ação especifica que uma solicitação HTTP de entrada com um carga no formato JSON específico atua como um gatilho.

Cole o seguinte código no esquema JSON do corpo da solicitação:

{
  "$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"
}

Observação

Você pode copiar a URL para o HTTP post após você salvar o aplicativo lógico, mas primeiro você deve adicionar uma ação.

Clique em + Nova etapa no gatilho manual. Em seguida, clique em Adicionar uma ação.
Procure SendGrid – Enviar email e clique nele.
Insira um nome para a conexão, como SendGridConnection, insira a Chave de API do SendGrid criada quando você configurou sua conta do SendGrid e clique em Criar.
Adicione endereços de email que você possui nos campos De e Para. Adicione Alerta de monitoramento remoto [DeviceId] ao campo Assunto. No campo Corpo do Email , adicionar Dispositivo [DeviceId] relatou [measurementName] com valor [measuredValue]. Você pode adicionar [DeviceId], [measurementName] e [measuredValue] clicando na seção Você pode inserir dados da seção de etapas anteriores .
Clique em Salvar no menu superior.
Clique no gatilho Solicitar e copie o valor Http Post para esta URL. Você precisará dessa URL mais tarde neste tutorial.

Observação

Aplicativos Lógicos permitem executar muitos tipos de ação diferentes, incluindo ações no Office 365.

Configurar o Trabalho Web EventProcessor

Nesta seção, você conecta sua solução pré-configurada ao Aplicativo Lógico criado. Para concluir essa tarefa, adicione a URL para disparar o Aplicativo Lógico à ação, que dispara quando um valor de sensor de dispositivo excede um limite.

Use seu cliente git para clonar a versão mais recente do repositório github azure-iot-remote-monitoring. Por exemplo:
```
git clone https://github.com/Azure/azure-iot-remote-monitoring.git
```
No Visual Studio, abra o RemoteMonitoring.sln da cópia local do repositório.
Abra o arquivo ActionRepository.cs na pasta Infrastructure\Repository .

Atualize o dicionário actionIds com o Http Post para esta URL que você anotou do seu Aplicativo Lógico, como se segue:

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

Salve as alterações na solução e saia do Visual Studio.

Implantar usando a linha de comando

Nesta seção, você implanta a versão atualizada da solução de monitoramento remoto para substituir a versão em execução atualmente no Azure.

Veja a seguir as instruções de configuração de desenvolvimento para configurar o ambiente para implantação.
Para implantar localmente, siga as instruções de implantação local.
Para implantar na nuvem e atualizar sua implantação de nuvem existente, siga as instruções de implantação de nuvem. Use o nome de sua implantação original como o nome da implantação. Por exemplo, se a implantação original foi chamada de demologicapp, use o seguinte comando:
```
build.cmd cloud release demologicapp
```
Quando o script de compilação for executado, certifique-se de usar a mesma conta, assinatura e região do Azure e a mesma instância do Active Directory que você usou ao provisionar a solução.

Ver seu aplicativo lógico em ação

A solução pré-configurada de monitoramento remoto tem duas regras configuradas por padrão ao provisionar uma solução. Ambas as regras estão no dispositivo SampleDevice001 :

Temperatura > 38,00
Umidade > 48.00

A regra de temperatura dispara a ação Gerar Alarme, enquanto a regra de Umidade dispara a ação SendMessage. Pressupondo que você usou a mesma URL para ambas as ações, a classe ActionRepository , seu aplicativo lógico é disparado para uma regra ou outra. Ambas as regras usam SendGrid para enviar um email ao endereço Para com detalhes do alerta.

Observação

O Aplicativo Lógico continua disparando toda vez que o limite é atingido. Para evitar emails desnecessários, você pode desabilitar as regras no portal da solução ou desabilitar o Aplicativo Lógico no Portal do Azure.

No portal, além de receber emails, você também pode ver quando o aplicativo lógico é executado:

Próximas etapas

Agora que você já usou um aplicativo lógico para conectar a solução pré-configurada a um processo empresarial, saiba mais sobre as opções de personalização das soluções pré-configuradas:

Compartilhar via

Tutorial: conectar um aplicativo lógico à solução pré-configurada de monitoramento remoto do Azure IoT Suite

Configurar o aplicativo lógico

Configurar o Trabalho Web EventProcessor

Implantar usando a linha de comando

Ver seu aplicativo lógico em ação

Próximas etapas

Recursos adicionais