Tutorial: Receber dados do dispositivo por meio do Hub IoT do Azure

Importante

As APIs de serviços de saúde do Azure estão atualmente em VERSÃO PRÉVIA. Os Termos de Uso Complementares para Versões Prévias do Microsoft Azure incluem termos legais adicionais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

O conector IoT fornece a capacidade de coletar e ingerir dados de saúde de vários dispositivos médicos ou relacionados à saúde de IoT no serviço Fast Healthcare Interoperability Resources (FHIR®). O conector IoT é interoperável e responsivo com dispositivos criados e gerenciados por meio Hub IoT do Azure fluxos de trabalho aprimorados e facilidade de uso. Este tutorial fornece o procedimento para conectar e rotear dados de dispositivo do Hub IoT do Azure para o conector IoT.

Pré-requisitos

Dica

Se estiver usando um aplicativo de dispositivo simulado do Hub IoT do Azure, fique à vontade para escolher seu aplicativo preferido entre diferentes linguagens e sistemas compatíveis.

Obter cadeia de conexão para o conector IoT

Hub IoT do Azure requer uma cadeia de conexão para se conectar com segurança ao conector IoT. Crie uma nova cadeia de conexão para o conector IoT, conforme descrito em Gerar uma cadeia de conexão. Cofre essa cadeia de conexão a ser usada na próxima etapa.

O conector IoT usa uma instância do Hub de Eventos do Azure nos bastidores para receber mensagens do dispositivo. A cadeia de conexão criada acima é basicamente a cadeia de conexão para esse Hub de Eventos subjacente.

Conexão Hub IoT do Azure com o conector IoT

O Hub IoT do Azure dá suporte a um recurso chamado roteamento de mensagens que fornece a capacidade de enviar dados do dispositivo para vários serviços do Azure, como o Hub de Eventos, a conta de armazenamento e o Barramento de Serviço. O conector IoT usa esse recurso para se conectar e enviar dados do dispositivo Hub IoT do Azure seu ponto de extremidade do Hub de Eventos.

Observação

Neste momento, você só pode usar o PowerShell ou o comando da CLI para criar o roteamento de mensagens porque o Hub de Eventos do conector IoT não está hospedado na assinatura do cliente, portanto, ele não ficará visível para você por meio do portal do Azure. No entanto, depois que os objetos de rota de mensagem são adicionados por meio do PowerShell ou da CLI, eles ficam visíveis no portal do Azure e podem ser gerenciados nele.

A configuração de um roteamento de mensagens consiste em duas etapas.

Adicionar um ponto de extremidade

Essa etapa define um ponto de extremidade para o qual o Hub IoT roteará os dados. Crie esse ponto de extremidade usando o comando Add-AzIotHubRoutingEndpoint do PowerShell ou o comando az iot hub routing-endpoint create da CLI, como preferir.

Esta é a lista de parâmetros a serem usados com o comando para criar um ponto de extremidade:

Parâmetro do PowerShell Parâmetro da CLI Descrição
ResourceGroupName resource-group Nome do grupo de recursos do recurso do Hub IoT.
Nome hub-name Nome do recurso do Hub IoT.
EndpointName endpoint-name Use um nome que deseja atribuir ao ponto de extremidade que está sendo criado.
EndpointType endpoint-type Tipo de ponto de extremidade ao qual o Hub IoT precisa se conectar. Use o valor literal "EventHub" para o PowerShell e "eventhub" para a CLI.
EndpointResourceGroup endpoint-resource-group Nome do grupo de recursos para o recurso de serviço FHIR do conector IoT. Você pode obter esse valor na página Visão geral do serviço FHIR.
EndpointSubscriptionID endpoint-subscription-id ID da assinatura para o recurso de serviço FHIR do conector IoT. Você pode obter esse valor na página Visão geral do serviço FHIR.
ConnectionString connection-string Cadeia de conexão com o conector IoT. Use o valor obtido na etapa anterior.

Adicionar uma rota de mensagens

Essa etapa define uma rota de mensagens usando o ponto de extremidade criado acima. Crie uma rota usando o comando Add-AzIotHubRoute do PowerShell ou o comando az iot hub route create da CLI, como preferir.

Esta é a lista de parâmetros a serem usados com o comando para adicionar uma rota de mensagem:

Parâmetro do PowerShell Parâmetro da CLI Descrição
ResourceGroupName g Nome do grupo de recursos do recurso do Hub IoT.
Nome hub-name Nome do recurso do Hub IoT.
EndpointName endpoint-name Nome do ponto de extremidade criado acima.
RouteName route-name Um nome que você deseja atribuir à rota de mensagens que está sendo criada.
Fonte source-type Tipo de dados a ser enviado ao ponto de extremidade. Use o valor literal "DeviceMessages" para o PowerShell e "devicemessages" para a CLI.

Enviar mensagem de dispositivo para Hub IoT do Azure

Use seu dispositivo (real ou simulado) para enviar a mensagem de frequência cardíaca de exemplo mostrada abaixo para o Hub IoT do Azure. Essa mensagem será roteada para o conector IoT, em que a mensagem será transformada em um recurso de Observação FHIR e armazenada no serviço FHIR.

{
  "HeartRate": 80,
  "RespiratoryRate": 12,
  "HeartRateVariability": 64,
  "BodyTemperature": 99.08839032397609,
  "BloodPressure": {
    "Systolic": 23,
    "Diastolic": 34
  },
  "Activity": "walking"
}

Importante

Certifique-se de enviar a mensagem do dispositivo que está em conformidade com os modelos de mapeamento configurados com o conector IoT.

Exibir dados do dispositivo no serviço FHIR

Você pode exibir os recursos de Observação do FHIR criados pelo conector IoT no serviço FHIR usando o Postman. Para obter informações, consulte Acessar o serviço FHIR usando o Postmane fazer uma solicitação para para exibir recursos de Observação FHIR com o valor de taxa de frequência cardíaca enviado na GET mensagem de exemplo https://your-fhir-server-url/Observation?code=http://loinc.org|8867-4 acima.

Dica

Verifique se o usuário tem acesso apropriado ao plano de dados do serviço FHIR. Use o Azure RBAC (controle de acesso baseado em função do Azure) para atribuir as funções de plano de dados necessárias.

Próximas etapas

Neste tutorial, você configura o Hub IoT do Azure rotear dados do dispositivo para o conector IoT. Selecione as próximas etapas abaixo para saber mais sobre o conector IoT:

Entenda os diferentes estágios do fluxo de dados no conector IoT.

(FHIR®) é uma marca registrada da HL7 e é usada com a permissão HL7.