Apparaatgegevens ontvangen via Azure IoT Hub

  • Artikel
  • 5 minuten om te lezen

Azure IoT Connector for FHIR®* (Fast Healthcare Interoperability Resources) biedt u de mogelijkheid om gegevens van IoMT-apparaten (Internet of Medical Things) op te nemen in Azure API for FHIR. Met de quickstart Azure IoT Connector for FHIR (preview) implementeren met de Azure-portal ziet u een voorbeeld van een apparaat dat wordt beheerd door het verzenden van telemetrie door Azure IoT Central naar Azure IoT Connector for FHIR. Azure IoT Connector for FHIR kan ook worden gebruikt voor apparaten die zijn ingericht en beheerd via Azure IoT Hub. In deze zelfstudie wordt de procedure geboden om apparaatgegevens van Azure IoT Hub te verbinden en te routeren naar Azure IoT Connector for FHIR.

Vereisten

Tip

Als u een met Azure IoT Hub gesimuleerde apparaat-app gebruikt, kunt u de gewenste toepassing kiezen in verschillende ondersteunde talen en systemen.

Verbindingsreeks ophalen voor Azure IoT Connector for FHIR (preview)

Azure IoT Hub vereist een verbindingsreeks om veilig verbinding te maken met uw Azure IoT Connector for FHIR. Maak een nieuwe verbindingsreeks voor uw Azure IoT Connector for FHIR zoals beschreven in Een verbindingsreeks genereren. Bewaar deze verbindingsreeks voor gebruik in de volgende stap.

Azure IoT Connector for FHIR gebruikt een Azure Event Hub-exemplaar voor het ontvangen van apparaatberichten. De hierboven gemaakte verbindingsreeks is in principe de verbindingsreeks voor deze onderliggende Event Hub.

Azure IoT Hub verbinden met Azure IoT Connector for FHIR (preview)

Azure IoT Hub ondersteunt een functie met de naam berichtroutering die de mogelijkheid biedt om gegevens van apparaten te verzenden naar verschillende Azure-Services zoals Event Hub, Opslagaccount en Service Bus. Azure IoT Connector for FHIR gebruikt deze functie om apparaatgegevens te verbinden en te verzenden van Azure IoT Hub naar het Event Hub-eindpunt.

Notitie

Momenteel kunt u PowerShell of CLI-opdrachten alleen gebruiken om berichtroutering te maken omdat de Event Hub van Azure IoT Connector for FHIR niet wordt gehost op het klantabonnement. Daarom is het voor u niet zichtbaar via de Azure-portal. Hoewel de objecten voor berichtroute worden toegevoegd met PowerShell of CLI, zijn ze zichtbaar op de Azure-portal en kunnen ze vanuit deze locatie worden beheerd.

Het instellen van een berichtroutering bestaat uit twee stappen.

Een eindpunt toevoegen

Deze stap definieert een eindpunt waar de IoT Hub de gegevens aan zou routeren. Maak dit eindpunt met behulp van PowerShell-opdracht add-AzIotHubRoutingEndpoint of CLI-opdracht az iot hub routing-endpoint create, op basis van uw voorkeur.

Hier volgt de lijst met parameters die moeten worden gebruikt met de opdracht voor het maken van een eindpunt:

PowerShell-parameter CLI-parameter Beschrijving
ResourceGroupName resource-group De naam van de resourcegroep van uw IoT Hub-resource.
Naam hub-name Naam van uw IoT Hub-resource.
EndpointName endpoint-name Gebruik een naam die u wilt toewijzen aan het eindpunt dat wordt gemaakt.
EndpointType endpoint-type Type eindpunt waarmee IoT Hub verbinding moet maken. Gebruik de letterlijke waarde van 'EventHub' voor PowerShell en 'eventhub' voor CLI.
EndpointResourceGroup endpoint-resource-group Resourcegroepnaam voor uw Azure IoT Connector voor de FHIR-Azure API for FHIR resource. U kunt deze waarde ophalen via de pagina Overzicht van de Azure API for FHIR.
EndpointSubscriptionId endpoint-subscription-id Abonnements-id voor uw Azure IoT Connector for the FHIR Azure API for FHIR resource. U kunt deze waarde ophalen via de pagina Overzicht van de Azure API for FHIR.
Connectionstring connection-string Verbindingsreeks voor uw Azure IoT Connector for FHIR. Gebruik de waarde die u in de vorige stap hebt verkregen.

Een berichtenroute toevoegen

In deze stap wordt een berichtroute gedefinieerd op basis van het eindpunt dat hierboven is gemaakt. Maak een route met behulp van PowerShell-opdracht add-AzIotHubRoute of CLI-opdracht az iot hub route create, op basis van uw voorkeur.

Hier volgt de lijst met parameters die moeten worden gebruikt met de opdracht om een berichtroute toe te voegen:

PowerShell-parameter CLI-parameter Beschrijving
ResourceGroupName g De naam van de resourcegroep van uw IoT Hub-resource.
Naam hub-name Naam van uw IoT Hub-resource.
EndpointName endpoint-name De naam van het eindpunt dat u hierboven hebt gemaakt.
RouteName route-name Een naam die u wilt toewijzen aan de berichtroute die wordt gemaakt.
Bron source-type Het type gegevens dat naar het eindpunt moet worden verzonden. Gebruik de letterlijke waarde 'DeviceMessages' voor PowerShell en 'devicemessages' voor CLI.

Apparaatbericht verzenden naar IoT Hub

Gebruik uw apparaat (echt of gesimuleerd) om het voorbeeldbericht over hartslag te verzenden dat hieronder wordt weergegeven in Azure IoT Hub. Dit bericht wordt doorgestuurd naar Azure IoT Connector for FHIR, waarbij het bericht wordt omgezet in een FHIR Observation-resource en opgeslagen in de Azure API for FHIR.

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

Belangrijk

Zorg ervoor dat u het apparaatbericht verzendt dat voldoet aan de toewijzingssjablonen die zijn geconfigureerd met uw Azure IoT Connector for FHIR.

Apparaatgegevens weergeven in Azure API for FHIR

U kunt de FHIR Observation-resource(s) bekijken die zijn gemaakt door Azure IoT Connector for FHIR met behulp van Postman. Zie Access the FHIR service using Postman (Toegang tot de FHIR-service met Postman)voor meer informatie en maak een aanvraag naar om Observation FHIR-resources weer te geven met de hartslagwaarde die is verzonden in het GET https://your-fhir-server-url/Observation?code=http://loinc.org|8867-4 bovenstaande voorbeeldbericht.

Tip

Zorg ervoor dat uw gebruiker de juiste toegang heeft tot de Azure API for FHIR-gegevensvlak. Gebruik Op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) om gegevensvlakrollen toe te wijzen.

Volgende stappen

In deze quickstart stelt u Azure IoT Hub in om apparaatgegevens te routeren naar Azure IoT Connector for FHIR. Selecteer een van de onderstaande volgende stappen voor meer informatie over Azure IoT Connector for FHIR:

Meer informatie over verschillende stadia van de gegevensstroom in Azure IoT Connector for FHIR.

Gegevensstroom van Azure IoT Connector for FHIR

Meer informatie over het configureren van IoT-connector met behulp van FHIR-toewijzingssjablonen.

Toewijzingssjablonen in Azure IoT Connector for FHIR

*In Azure Portal wordt Azure IoT Connector for FHIR aangeduid als IoT Connector (preview). FHIR is een gedeponeerd handelsmerk van HL7 en wordt gebruikt met de toestemming van HL7.