Ta emot enhetsdata från Azure IoT Hub
Med Azure IoT Connector for FHIR (elektronisk standard för utbyte av vårdinformation) (FHIR®)* kan du mata in data från IoMT-enheter (Internet of Medical Things) till Azure API for FHIR. Snabbstarten Distribuera Azure IoT Connector för FHIR (förhandsversion) med Azure Portal visade ett exempel på en enhet som hanteras av Azure IoT Central skicka telemetri till Azure IoT Connector för FHIR. Azure IoT Connector for FHIR kan också fungera med enheter som etablerats och hanteras via Azure IoT Hub. Den här självstudien innehåller en procedur för att ansluta och dirigera enhetsdata från Azure IoT Hub till Azure IoT Connector för FHIR.
Förutsättningar
- En aktiv Azure-prenumeration – Skapa en utan kostnad
- Azure API for FHIR resurs med minst en Azure IoT Connector for FHIR – Distribuera Azure IoT Connector för FHIR (förhandsversion) med Azure Portal
- Azure IoT Hub resurs som är ansluten till verkliga eller simulerade enheter – Skapa en IoT-hubb med hjälp av Azure Portal
Tips
Om du använder ett Azure IoT Hub simulerat enhetsprogram kan du välja program bland olika språk och system som stöds.
Hämta anslutningssträng för Azure IoT Connector för FHIR (förhandsversion)
Azure IoT Hub kräver en anslutningssträng för att på ett säkert sätt ansluta till din Azure IoT Connector för FHIR. Skapa en ny anslutningssträng för din Azure IoT Connector för FHIR enligt beskrivningen i Generera en anslutningssträng. Bevara den här anslutningssträngen som ska användas i nästa steg.
Azure IoT Connector för FHIR använder en Azure Event Hub-instans under huven för att ta emot enhetsmeddelanden. Anslutningssträngen som skapades ovan är i princip anslutningssträngen till den underliggande händelsehubben.
Anslut Azure IoT Hub med Azure IoT Connector för FHIR (förhandsversion)
Azure IoT Hub stöder en funktion som kallas meddelanderoutning som ger möjlighet att skicka enhetsdata till olika Azure-tjänster som Event Hub, Storage Account och Service Bus. Azure IoT Connector for FHIR använder den här funktionen för att ansluta och skicka enhetsdata från Azure IoT Hub till händelsehubbens slutpunkt.
Anteckning
Just nu kan du bara använda PowerShell- eller CLI-kommandon för att skapa meddelanderoutning eftersom Azure IoT Connector för FHIR:s händelsehubb inte finns i kundprenumerationen, och därför visas den inte för dig via Azure Portal. Men när meddelandevägobjekten har lagts till med PowerShell eller CLI är de synliga på Azure Portal och kan hanteras därifrån.
Att konfigurera en meddelanderoutning består av två steg.
Lägga till en slutpunkt
Det här steget definierar en slutpunkt som IoT Hub som data ska dirigeras till. Skapa den här slutpunkten med antingen PowerShell-kommandot Add-AzIotHubRoutingEndpoint eller cli-kommandot az iot hub routing-endpoint create, baserat på dina önskemål.
Här är listan över parametrar som ska användas med kommandot för att skapa en slutpunkt:
| PowerShell-parameter | CLI-parameter | Description |
|---|---|---|
| ResourceGroupName | resource-group | Resursgruppens namn på IoT Hub resurs. |
| Name | hub-name | Namnet på din IoT Hub resurs. |
| EndpointName | slutpunktsnamn | Använd ett namn som du vill tilldela till slutpunkten som skapas. |
| EndpointType | slutpunktstyp | Typ av slutpunkt som IoT Hub måste ansluta till. Använd literalvärdet "EventHub" för PowerShell och "eventhub" för CLI. |
| EndpointResourceGroup | endpoint-resource-group | Resursgruppsnamn för din Azure IoT Connector för FHIR-Azure API for FHIR resursen. Du kan hämta det här värdet från översiktssidan för Azure API for FHIR. |
| EndpointSubscriptionId | endpoint-subscription-id | Prenumerations-ID för din Azure IoT Connector för FHIR Azure API for FHIR resursen. Du kan hämta det här värdet från översiktssidan för Azure API for FHIR. |
| Connectionstring | connection-string | Anslutningssträng till din Azure IoT Connector för FHIR. Använd det värde som du fick i föregående steg. |
Lägga till en meddelandeväg
Det här steget definierar en meddelandeväg med hjälp av slutpunkten som skapades ovan. Skapa en väg med antingen PowerShell-kommandot Add-AzIotHubRoute eller cli-kommandot az iot hub route create, baserat på dina önskemål.
Här är listan över parametrar som ska användas med kommandot för att lägga till en meddelandeväg:
| PowerShell-parameter | CLI-parameter | Description |
|---|---|---|
| ResourceGroupName | g | Resursgruppens namn på IoT Hub resurs. |
| Name | hub-name | Namnet på din IoT Hub resurs. |
| EndpointName | slutpunktsnamn | Namnet på den slutpunkt som du skapade ovan. |
| RouteName | route-name | Ett namn som du vill tilldela till meddelandevägen som skapas. |
| Källa | källtyp | Typ av data som ska skickas till slutpunkten. Använd literalvärdet "DeviceMessages" för PowerShell och "devicemessages" för CLI. |
Skicka enhetsmeddelande till IoT Hub
Använd din enhet (verklig eller simulerad) för att skicka exemplet på pulsfrekvensmeddelandet nedan till Azure IoT Hub. Det här meddelandet dirigeras till Azure IoT Connector for FHIR, där meddelandet omvandlas till en FHIR-observationsresurs och lagras i Azure API for FHIR.
{
"HeartRate": 80,
"RespiratoryRate": 12,
"HeartRateVariability": 64,
"BodyTemperature": 99.08839032397609,
"BloodPressure": {
"Systolic": 23,
"Diastolic": 34
},
"Activity": "walking"
}
Viktigt
Se till att skicka enhetsmeddelandet som överensstämmer med mappningsmallarna som konfigurerats med din Azure IoT Connector för FHIR.
Visa enhetsdata i Azure API for FHIR
Du kan visa FHIR-observationsresursen som skapats av Azure IoT Connector FHIR med postman. Mer information finns i Access the FHIR service using Postman(Få åtkomst till FHIR-tjänsten med Postman) och skicka en begäran om att visa observations-FHIR-resurser med det pulsvärde som skickades i GET https://your-fhir-server-url/Observation?code=http://loinc.org|8867-4 exempelmeddelandet ovan.
Tips
Kontrollera att användaren har rätt åtkomst till Azure API for FHIR dataplanet. Använd rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att tilldela nödvändiga dataplansroller.
Nästa steg
I den här snabbstartsguiden ska du konfigurera Azure IoT Hub att dirigera enhetsdata till Azure IoT Connector för FHIR. Välj nedanstående steg om du vill veta mer om Azure IoT Connector för FHIR:
Förstå olika faser i dataflödet i Azure IoT Connector för FHIR.
Lär dig hur du konfigurerar IoT Connector med hjälp av enhets- och FHIR-mappningsmallar.
*I Azure Portal kallas Azure IoT Connector för FHIR för IoT Connector (förhandsversion). FHIR är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.