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

Para criar uma solução de ponta a ponta, use o modelo de aplicativo Análise na loja – finalização de compra do IoT Central. Esse modelo permite conectar e monitorar o ambiente de uma loja através de vários sensores. 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, você aprenderá como:

Se você não tiver uma assinatura 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 seu computador local:

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

Arquitetura do aplicativo

Para muitos varejistas, as condições ambientais são uma maneira fundamental de diferenciar suas lojas das lojas de 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 do aplicativo anterior, você pode usar o modelo de aplicativo para:

• (1) Conecte vários sensores de 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 à esquerda do diagrama de arquitetura representam os sensores.

• (2) Monitore e gerencie a integridade da rede do sensor e de todos os dispositivos de gateway no ambiente.

  Muitos sensores de 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 de resumo para um aplicativo do IoT Central. O dispositivo de gateway também é responsável por retransmitir operações de comando e controle para os dispositivos de sensor quando aplicável.

• (3) Criar regras personalizadas que usam condições ambientais em um repositório para disparar alertas para gerentes de repositório.

  O aplicativo Azure IoT Central coleta dados dos vários sensores de IoT e dispositivos de gateway dentro do 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 repositório que permitem que eles monitorem e gerenciem remotamente os dispositivos de infraestrutura.

• (4) Transforme as condições ambientais nas 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 de PaaS (plataforma como serviço) do Azure. Os serviços de PaaS podem executar a manipulação de dados e enriquecer esses insights antes de aterrissá-los em um aplicativo de negócios.

• (5) Exporte os insights agregados em aplicativos de negócios existentes ou novos para fornecer informações úteis e oportunas para a equipe de varejo.

  Os dados de 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ê aprenderá a criar um painel do Power BI em tempo real na exportação de dados do Azure IoT Central e visualizar insights no tutorial do Power BI .

Criar um aplicativo de análise na loja

Para criar seu aplicativo do IoT Central:

1. Navegue até a página Criar Aplicativo do IoT Central no portal do Azure. Se solicitado, entre com sua conta do Azure.

2. Insira as seguintes informações:

   Campo	Description
   Subscription	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 do aplicativo	O subdomínio de 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
   Região	A região do Azure que você deseja usar.
   Plano de preços	O plano de preços que você deseja usar.

3. Selecione Examinar + criar. Em seguida, selecione Criar.

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

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

Percorrer o aplicativo

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 definir as cores do navegador do aplicativo, o ícone do navegador e o logotipo do aplicativo que aparece no mastro.

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 logotipo do mastro, selecione Alterar e selecione a imagem contoso_wht_mast.png a ser carregada. Opcionalmente, insira um valor para o texto alt de logotipo.

3. Para alterar o ícone do navegador, selecione Alterar e 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 cor hexadecimal HTML:

   • Para Cabeçalho, insira #008575.
   • Para Accent, insira #A1F3EA.

5. Clique em Salvar. Depois de salvar as alterações, o aplicativo atualiza as cores do navegador, o logotipo no mastro 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 Meus aplicativos :

1. Selecione Gerenciamento de Aplicativos>.

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

3. Clique em Salvar.

Criar os modelos de dispositivo

Os modelos de dispositivo permitem que você configure e gerencie dispositivos. Você pode criar um modelo personalizado, importar um arquivo de modelo existente ou importar um modelo da lista de modelos de dispositivos 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 Análise na loja – finalização de compra tem vários modelos de dispositivos pré-instalados. O modelo de dispositivo RuuviTag não está incluído no modelo de aplicativo Análise na loja – finalização de compra.

Nesta seção, você adicionará um modelo de dispositivo para sensores RuuviTag ao seu aplicativo. Para fazer isso:

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 selecione Avançar: Personalizar.

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

6. Selecione Avançar: Revisão.

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 integradas em 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 do 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 exibições personalizadas.

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

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

Para personalizar as interfaces integradas do modelo de dispositivo RuuviTag:

1. No painel esquerdo, selecione Modelos de Dispositivo.

2. Selecione RuuviTag.

3. Oculte o painel esquerdo. A exibição de resumo do modelo exibe os recursos 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 igual a 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 de exibição de RelativeHumidity para um valor personalizado, como Umidade.

2. Altere a opção Tipo Semântico de Umidade Relativa para Umidade.

   Opcionalmente, defina valores de esquema para o tipo de telemetria de umidade no modo de exibiçã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 Salvar para salvar as alterações.

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

1. Selecione Adicionar funcionalidade.

2. Para o Nome de Exibição, insira Local.

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

3. Para o Tipo de Funcionalidade, selecione Propriedade de 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 um repositório a cada dispositivo.

6. Defina o comprimento mínimo como 2.

7. Defina Remover Espaços em Branco como Ativado.

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 aplicativo. 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á por push 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ê usará o seguinte conjunto de dispositivos simulados para criar o aplicativo:

• Um gateway Rigado C500.
• Dois sensores RuuviTag .
• Um sensor de ocupação . Esse sensor simulado é incluído no modelo de aplicativo, portanto, você não precisa criá-lo.

Para adicionar um dispositivo de gateway do Rigado Cascade 500 simulado ao seu aplicativo:

1. No painel esquerdo, selecione Dispositivos.

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

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

4. Verifique se C500 é o modelo de dispositivo selecionado e, em seguida, defina Simular este dispositivo? para Sim.

5. Selecione Criar. Agora, seu aplicativo contém um dispositivo simulado de gateway Rigado Cascade 500.

Para adicionar um dispositivo de sensor RuuviTag simulado ao seu aplicativo:

1. No painel esquerdo, selecione Dispositivos.

2. Selecione RuuviTag na lista de modelos de dispositivo disponíveis e selecione Novo.

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

4. Verifique se RuuviTag é o modelo de dispositivo selecionado e, em seguida, defina Simular esse dispositivo? para Sim.

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

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

Para conectar os dois dispositivos de Ocupação e sensor RuuviTag ao dispositivo de gateway:

1. No painel esquerdo, selecione 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 , agora verá três dispositivos anexados ao gateway.

Adicionar regras e ações

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

Uma regra é 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 eventos do dispositivo. Uma regra também tem uma ou mais ações associadas. As ações podem incluir enviar notificações por email ou disparar uma ação de webhook para enviar dados para outros serviços. O modelo de aplicativo de Análise na loja – finalização de compra inclui algumas regras predefinidas para os dispositivos no aplicativo.

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

Para criar uma regra:

1. No painel esquerdo, selecione Regras.

2. Selecione Novo.

3. Insira o nível de Umidade como o nome da regra.

4. Para o 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ê poderia criar um filtro que aplicaria a regra apenas a um subconjunto definido dos sensores.

5. Para Telemetria, selecione RelativeHumidity. É a funcionalidade do dispositivo que você personalizou em uma etapa anterior.

6. Em Operador, selecione Maior que.

7. Para Valor, insira um nível típico de umidade interna de intervalo superior para seu ambiente (por exemplo, 65).

   Essa condição se aplica quando a umidade relativa em qualquer sensor RuuviTag excede o valor. Talvez seja necessário ajustar o valor para cima ou para baixo dependendo do intervalo de umidade normal em seu ambiente.

Para adicionar uma ação à regra:

1. Selecione Email.

2. Para um nome de exibição amigável para a ação, insira a notificação de alta umidade.

3. Para Isso, insira o endereço de email associado à sua conta.

   Se você usar um endereço de email diferente, o que você usar deverá ser para um usuário que tenha sido 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 email.

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

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

   Em poucos minutos, a conta de email especificada deve começar a receber mensagens. O aplicativo envia emails sempre que um sensor indica que o nível de umidade excedeu o valor em sua condição.

Limpar os recursos

Se você não planeja concluir mais guias de início rápido ou tutoriais do IoT Central, poderá excluir seu aplicativo do IoT Central:

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

Próxima etapa