Tutorial: Criar e implantar um modelo de aplicativo de análise na loja

Para criar a solução completa, use o modelo de aplicativo de checkout de análise na loja do IoT Central. Este modelo permite que você se conecte e monitore o ambiente de uma loja por meio de vários dispositivos de sensor. Esses dispositivos geram telemetria que você pode converter em insights de negócios para ajudar a reduzir os custos operacionais e criar uma ótima experiência para seus clientes.

Neste tutorial, irá aprender a:

• Usar o modelo de análise na loja do Azure IoT Central - checkout para criar um aplicativo de loja de varejo
• Personalizar as configurações do aplicativo
• Criar e personalizar modelos de dispositivos IoT
• Conectar dispositivos ao seu aplicativo
• Adicionar regras e ações para monitorar as condições

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

Para concluir este tutorial, você precisa instalar a ferramenta de linha de comando dmr-client em sua máquina local:

dotnet tool install --global Microsoft.IoT.ModelsRepository.CommandLine --version 1.0.0-beta.9

Arquitetura da aplicação

Para muitos retalhistas, as condições ambientais são uma forma fundamental de diferenciar as suas lojas das lojas dos seus concorrentes. Os varejistas mais bem-sucedidos fazem todos os esforços para manter condições agradáveis dentro de suas lojas para o conforto de seus clientes.

O modelo de aplicativo vem com um conjunto de modelos de dispositivo e usa um conjunto de dispositivos simulados para preencher o painel:

Conforme mostrado no diagrama de arquitetura de aplicativo anterior, você pode usar o modelo de aplicativo para:

• (1) Conecte vários sensores IoT a uma instância de aplicativo do IoT Central.

  Uma solução de IoT começa com um conjunto de sensores que capturam sinais significativos de dentro de um ambiente de loja de varejo. Os vários ícones na extremidade esquerda do diagrama de arquitetura representam os sensores.

• (2) Monitorizar e gerir o estado de funcionamento da rede de sensores e de quaisquer dispositivos de gateway no ambiente.

  Muitos sensores IoT podem alimentar sinais brutos diretamente para a nuvem ou para um dispositivo de gateway localizado perto deles. O dispositivo de gateway agrega dados na borda antes de enviar informações resumidas para um aplicativo do IoT Central. O dispositivo gateway também é responsável por transmitir as operações de comando e controle para os dispositivos de sensor, quando aplicável.

• (3) Crie regras personalizadas que usem as condições ambientais dentro de uma loja para disparar alertas para os gerentes da loja.

  O aplicativo Azure IoT Central ingere dados de vários sensores IoT e dispositivos de gateway no ambiente da loja de varejo e, em seguida, gera um conjunto de insights significativos.

  O Azure IoT Central também fornece uma experiência personalizada para operadores de loja que lhes permite monitorizar e gerir remotamente os dispositivos de infraestrutura.

• (4) Transformar as condições ambientais dentro das lojas em insights que a equipe da loja pode usar para melhorar a experiência do cliente.

  Você pode configurar um aplicativo do Azure IoT Central em uma solução para exportar insights brutos ou agregados para um conjunto de serviços PaaS (plataforma do Azure como serviço). Os serviços de PaaS podem realizar manipulação de dados e enriquecer esses insights antes de colocá-los em um aplicativo de negócios.

• (5) Exportar os conhecimentos agregados para aplicações comerciais existentes ou novas, a fim de fornecer informações úteis e atempadas ao pessoal retalhista.

  Os dados da IoT podem alimentar diferentes tipos de aplicativos de negócios implantados em um ambiente de varejo. Um gerente de loja de varejo ou membro da equipe pode usar esses aplicativos para visualizar insights de negócios e tomar medidas significativas em tempo real. Você aprende a criar um painel do Power BI em tempo real no tutorial Exportar dados do Azure IoT Central e visualizar insights no Power BI .

Criar uma aplicação de análise na loja

Para criar seu aplicativo IoT Central:

1. Navegue até a página Criar Aplicativo Central IoT no portal do Azure. Se lhe for pedido, inicie sessão com a sua conta do Azure.

2. Introduza as informações seguintes:

   Campo	Descrição
   Subscrição	A assinatura do Azure que você deseja usar.
   Grupo de recursos	O grupo de recursos que você deseja usar. Você pode criar um novo grupo de recursos ou usar um existente.
   Nome do recurso	Um nome de recurso válido do Azure.
   URL da Aplicação	O subdomínio URL do seu aplicativo. A URL de um aplicativo do IoT Central se parece com https://yoursubdomain.azureiotcentral.com.
   Template	Análise na loja - Checkout
   País/Região	A região do Azure que você deseja usar.
   Plano de preços	O plano de preços que pretende utilizar.

3. Selecione Rever + criar. Depois, selecione Criar.

Quando o aplicativo estiver pronto, você poderá navegar até ele no portal do Azure:

Para saber mais, consulte Criar um aplicativo do Azure IoT Central.

Percorra a aplicação

As seções a seguir descrevem os principais recursos do aplicativo.

Personalizar as configurações do aplicativo

Você pode alterar várias configurações para personalizar a experiência do usuário em seu aplicativo. Um tema personalizado permite que você defina as cores do navegador do aplicativo, o ícone do navegador e o logotipo do aplicativo que aparece no cabeçalho do aplicativo.

Para criar um tema personalizado, use as imagens de exemplo para personalizar o aplicativo. Baixe as quatro imagens de exemplo da Contoso do GitHub.

Para criar um tema personalizado:

1. No painel esquerdo, selecione Aparência de personalização>.

2. Para alterar o logótipo do masthead, selecione Alterar e, em seguida, selecione a imagem contoso_wht_mast.png a carregar. Opcionalmente, insira um valor para Logo alt text.

3. Para alterar o ícone do navegador, selecione Alterar e, em seguida, selecione a imagem contoso_favicon.png a ser exibida nas guias do navegador.

4. Substitua as cores padrão do navegador adicionando códigos de cores hexadecimais HTML:

   • Em Cabeçalho, digite #008575.
   • Em Acento, digite #A1F3EA.

5. Selecione Guardar. Depois de salvar as alterações, o aplicativo atualiza as cores do navegador, o logotipo no cabeçalho e o ícone do navegador.

Para atualizar a imagem do aplicativo que aparece no bloco do aplicativo na página Meus Aplicativos do site Meus aplicativos do Azure IoT Central:

1. Selecione Gerenciamento de aplicativos>.

2. Selecione Alterar e, em seguida, selecione a imagem contoso_main_lg.png a ser carregada como a imagem do aplicativo.

3. Selecione Guardar.

Criar os modelos de dispositivo

Os modelos de dispositivos permitem-lhe configurar e gerir dispositivos. Você pode criar um modelo personalizado, importar um arquivo de modelo existente ou importar um modelo da lista de modelos de dispositivo em destaque. Depois de criar e personalizar um modelo de dispositivo, use-o para conectar dispositivos reais ao seu aplicativo.

Opcionalmente, você pode usar um modelo de dispositivo para gerar dispositivos simulados para teste.

O modelo de aplicativo de análise na loja - checkout tem vários modelos de dispositivo pré-instalados. O modelo de dispositivo RuuviTag não está incluído no modelo de aplicativo de análise na loja - checkout .

Nesta seção, você adiciona um modelo de dispositivo para sensores RuuviTag ao seu aplicativo. Para tal:

1. Para baixar uma cópia do modelo de dispositivo RuuviTag do repositório de modelos, execute o seguinte comando:

   dmr-client export --dtmi "dtmi:rigado:RuuviTag;2" --repo https://raw.githubusercontent.com/Azure/iot-plugandplay-models/main > ruuvitag.json
   

2. No painel esquerdo, selecione Modelos de dispositivo.

3. Selecione + Novo para criar um novo modelo de dispositivo.

4. Selecione o bloco do dispositivo IoT e, em seguida, selecione Avançar: Personalizar.

5. Na página Personalizar, digite RuuviTag como o nome do modelo de dispositivo.

6. Selecione Next: Review.

7. Selecione Criar.

8. Selecione o bloco Importar um modelo . Em seguida, procure e importe o arquivo ruuvitag.json que você baixou anteriormente.

9. Após a conclusão da importação, selecione Publicar para publicar o modelo de dispositivo.

10. No painel esquerdo, selecione Modelos de dispositivo.

    A página exibe todos os modelos de dispositivo no modelo de aplicativo e o modelo de dispositivo RuuviTag que você acabou de adicionar.

Personalizar os modelos de dispositivo

Você pode personalizar os modelos de dispositivo em seu aplicativo de três maneiras:

• Personalize as interfaces nativas incorporadas nos seus dispositivos alterando as capacidades do dispositivo.

  Por exemplo, com um sensor de temperatura, você pode alterar detalhes como o nome de exibição e as unidades de medida.

• Personalize seus modelos de dispositivo adicionando propriedades de nuvem.

  As propriedades de nuvem são dados personalizados que seu aplicativo Azure IoT Central cria, armazena e associa aos seus dispositivos. Exemplos de propriedades de nuvem incluem:

  • Um valor calculado.
  • Metadados, como um local que você deseja associar a um conjunto de dispositivos.

• Personalize modelos de dispositivo criando modos de exibição personalizados.

  As visualizações fornecem uma maneira para os operadores visualizarem telemetria e metadados para seus dispositivos, como métricas e integridade do dispositivo.

Nesta seção, você usa os dois primeiros métodos para personalizar o modelo de dispositivo para seus sensores RuuviTag.

Para personalizar as interfaces internas do modelo de dispositivo RuuviTag:

1. No painel esquerdo, selecione Modelos de dispositivo.

2. Selecione RuuviTag.

3. Oculte o painel esquerdo. A vista de resumo do modelo apresenta as capacidades do dispositivo.

   

4. Selecione o modelo RuuviTag no menu de modelo de dispositivo RuuviTag.

5. Na lista de recursos, role para o tipo de telemetria RelativeHumidity . É o item de linha com o valor de nome de exibição editável de RelativeHumidity.

Nas etapas a seguir, você personaliza o tipo de telemetria RelativeHumidity para os sensores RuuviTag. Opcionalmente, você pode personalizar alguns dos outros tipos de telemetria.

Para o tipo de telemetria RelativeHumidity , faça as seguintes alterações:

1. Atualize o valor Nome para exibição de RelativeHumidity para um valor personalizado, como Humidity.

2. Altere a opção Tipo semântico de Humidade relativa para Humidade relativa.

   Opcionalmente, defina valores de esquema para o tipo de telemetria de umidade na visualização de esquema expandido. Ao definir valores de esquema, você pode criar requisitos de validação detalhados para os dados que seus sensores rastreiam. Por exemplo, você pode definir valores mínimos e máximos de intervalo operacional para uma interface especificada.

3. Selecione Guardar para guardar as alterações.

Para adicionar uma propriedade de nuvem a um modelo de dispositivo em seu aplicativo:

1. Selecione Adicionar capacidade.

2. Em Nome para Exibição, digite Local.

   Esse valor, que é um nome amigável para a propriedade, é copiado automaticamente para o Nome. Você pode usar o valor copiado ou alterá-lo.

3. Em Tipo de capacidade, selecione Propriedade da nuvem.

4. Selecione Expandir.

5. Na lista suspensa Esquema, selecione String.

   Essa opção permite associar um nome de local a qualquer dispositivo com base no modelo. Por exemplo, você pode associar uma área nomeada em uma loja a cada dispositivo.

6. Defina o comprimento mínimo como 2.

7. Defina Trim Whitespace como On.

8. Selecione Salvar para salvar sua propriedade de nuvem personalizada.

9. Selecione Publicar.

   A publicação de um modelo de dispositivo torna as atualizações visíveis para os operadores de aplicativos. Depois de publicar um modelo, use-o para gerar dispositivos simulados para teste ou para conectar dispositivos reais ao seu aplicativo. Se você já tiver dispositivos conectados ao seu aplicativo, a publicação de um modelo personalizado enviará as alterações para os dispositivos.

Adicionar dispositivos

Depois de criar e personalizar os modelos de dispositivo, é hora de adicionar dispositivos. Para este tutorial, você usa o seguinte conjunto de dispositivos simulados para criar o aplicativo:

• Um gateway Rigado C500.
• Dois sensores RuuviTag .
• Um sensor de ocupação . Este sensor simulado está incluído no modelo de aplicação, pelo que não precisa de o criar.

Para adicionar um dispositivo de gateway Rigado Cascade 500 simulado à sua aplicação:

1. No painel esquerdo, selecione Devices (Dispositivos).

2. Selecione C500 na lista de modelos de dispositivo disponíveis e, em seguida, selecione Novo.

3. Digite gateway C500 como o nome do dispositivo e gateway-001 como o ID do dispositivo.

4. Certifique-se de que C500 é o modelo de dispositivo selecionado e, em seguida, defina Simular este dispositivo? como Sim.

5. Selecione Criar. A sua aplicação contém agora um dispositivo de gateway Rigado Cascade 500 simulado.

Para adicionar um dispositivo de sensor RuuviTag simulado à sua aplicação:

1. No painel esquerdo, selecione Devices (Dispositivos).

2. Selecione RuuviTag na lista de modelos de dispositivos disponíveis e, em seguida, selecione Novo.

3. Digite RuuviTag 001 como o nome do dispositivo e ruuvitag-001 como o ID do dispositivo.

4. Certifique-se de que RuuviTag é o modelo de dispositivo selecionado e, em seguida, defina Simular este dispositivo? como Sim.

5. Selecione Criar. Seu aplicativo agora contém um dispositivo de sensor RuuviTag simulado.

Repita as etapas anteriores para adicionar um segundo dispositivo sensor RuuviTag simulado ao seu aplicativo. Digite RuuviTag 002 como o nome do dispositivo e ruuvitag-002 como o ID do dispositivo.

Para conectar os dois sensores RuuviTag e dispositivos de ocupação ao dispositivo gateway:

1. No painel esquerdo, selecione Devices (Dispositivos).

2. Na lista de dispositivos, selecione RuuviTag 001, RuuviTag 002 e Ocupação. Em seguida, na barra de comandos, selecione Anexar ao gateway.

3. No painel Anexar ao gateway, selecione C500 como o modelo de dispositivo e C500 - gateway como o dispositivo. Em seguida, selecione Anexar.

Se você navegar até o dispositivo C500 - gateway e selecionar a guia Dispositivos downstream , verá três dispositivos conectados ao gateway.

Adicionar regras e ações

Como parte do uso de sensores em seu aplicativo do Azure IoT Central para monitorar condições, você pode criar regras para executar ações quando determinadas condições forem atendidas.

Uma regra está associada a um modelo de dispositivo e a um ou mais dispositivos e contém condições que devem ser atendidas com base na telemetria ou nos eventos do dispositivo. Uma regra também tem uma ou mais ações associadas. As ações podem incluir o envio de notificações por e-mail ou acionar uma ação de webhook para enviar dados para outros serviços. O modelo de aplicativo de análise na loja - checkout inclui algumas regras predefinidas para os dispositivos no aplicativo.

Nesta seção, você cria uma nova regra que verifica o nível máximo de umidade relativa com base na telemetria do sensor RuuviTag. Você adiciona uma ação à regra para que, se a umidade exceder o máximo, o aplicativo envie uma notificação por e-mail.

Para criar uma regra:

1. No painel esquerdo, selecione Regras.

2. Selecione Novo.

3. Insira Nível de umidade como o nome da regra.

4. Para Modelo de dispositivo, selecione o modelo de dispositivo RuuviTag.

   A regra que você define se aplica a todos os sensores, com base nesse modelo. Opcionalmente, você pode criar um filtro que aplicaria a regra apenas a um subconjunto definido dos sensores.

5. Em Telemetria, selecione RelativeHumidity. É o recurso do dispositivo que você personalizou em uma etapa anterior.

6. Em Operador, selecione É maior que.

7. Em Valor, insira um nível de umidade interno típico da faixa superior para seu ambiente (por exemplo, 65).

   Esta condição aplica-se quando a humidade relativa em qualquer sensor RuuviTag excede o valor. Pode ser necessário ajustar o valor para cima ou para baixo, dependendo da faixa de umidade normal em seu ambiente.

Para adicionar uma ação à regra:

1. Selecione E-mail.

2. Para obter um Nome de exibição amigável para a ação, insira Notificação de alta umidade.

3. Em Para, insira o endereço de e-mail associado à sua conta.

   Se você usar um endereço de e-mail diferente, o que você usa deve ser para um usuário que foi adicionado ao aplicativo. O usuário também precisa entrar e sair pelo menos uma vez.

4. Opcionalmente, insira uma nota para incluir no texto do e-mail.

5. Selecione Concluído para concluir a ação.

6. Selecione Salvar para salvar e ativar a nova regra.

   Dentro de alguns minutos, a conta de e-mail especificada deve começar a receber mensagens. O aplicativo envia e-mail cada vez que um sensor indica que o nível de umidade excedeu o valor em sua condição.

Clean up resources (Limpar recursos)

Se você não planeja concluir mais tutoriais ou inícios rápidos do IoT Central, pode excluir seu aplicativo do IoT Central:

1. Em seu aplicativo IoT Central, navegue até Gerenciamento de Aplicativos>.
2. Selecione Excluir e confirme sua ação.

Próximo passo

Personalizar o painel