Quickstart: Azure IoT Connector for FHIR (preview) implementeren met Azure Portal
Azure IoT Connector for FHIR®* (Fast Healthcare Interoperability Resources) is een optionele functie van Azure API for FHIR die de mogelijkheid biedt om gegevens van IoMT-apparaten (Internet of Medical Things) op te nemen. Tijdens de previewfase is de functie Azure IoT Connector for FHIR gratis beschikbaar. In deze snelstart leert u het volgende:
- Azure IoT Connector for FHIR implementeren en configureren met Azure Portal
- Een gesimuleerd apparaat gebruiken om gegevens te verzenden naar Azure IoT Connector for FHIR
- Resources weergeven die zijn gemaakt door Azure IoT Connector for FHIR op de Azure API for FHIR
Vereisten
- Een actief Azure-abonnement - Een gratis abonnement maken
- Azure API for FHIR-resource - Azure API for FHIR implementeren met Azure Portal
Naar Azure API for FHIR-resource gaan
Open Azure Portal en ga naar de Azure API for FHIR-resource waarvoor u de functie Azure IoT Connector for FHIR wilt maken.
Klik in het navigatiemenu links op IoT-connector (preview) in de sectie Invoegtoepassingen om de pagina IoT-connectors te openen.
Nieuwe Azure IoT Connector for FHIR maken (preview)
Klik op de knop Toevoegen om de pagina IoT-connector maken te openen.
Voer instellingen in voor de nieuwe Azure IoT Connector for FHIR. Klik op Maken en wacht tot de implementatie van Azure IoT Connector for FHIR is voltooid.
Notitie
U moet voor deze installatie Maken selecteren als waarde voor de vervolgkeuzelijst Oplossingstype.
| Instelling | Waarde | Beschrijving |
|---|---|---|
| Naam van connector | Een unieke naam | Voer een naam in om uw Azure IoT Connector for FHIR aan te duiden. Deze naam moet uniek zijn binnen een Azure API for FHIR-resource. De naam mag alleen kleine letters, cijfers en het koppelteken (-) bevatten. De naam moet beginnen en eindigen met een letter of cijfer en moet tussen de 3 en 24 tekens lang zijn. |
| Oplossingstype | Opzoeken of maken | Selecteer Opzoeken als u een out-of-band-proces hebt om de FHIR-resources Apparaat en Patiënt te maken in uw Azure API for FHIR. Azure IoT Connector for FHIR gebruikt de verwijzing naar deze resources bij het maken van de FHIR-resource Observatie om de apparaatgegevens weer te geven. Selecteer Maken als u wilt dat met Azure IoT Connector for FHIR de bare-boneresources Apparaat en Patiënt in uw instantie van Azure API for FHIR worden gemaakt met behulp van de betreffende id-waarden die aanwezig zijn in de apparaatgegevens. |
Zodra de installatie is voltooid, wordt de nieuwe Azure IoT Connector for FHIR weergegeven op de pagina IoT-connectors.
Azure IoT Connector for FHIR configureren (preview)
Azure IoT Connector for FHIR heeft twee toewijzingssjablonen nodig om apparaatberichten te transformeren naar op FHIR gebaseerde observatieresources: apparaattoewijzing en FHIR-toewijzing. Uw Azure IoT Connector for FHIR is pas volledig operationeel als deze toewijzingen zijn geüpload.
Als u toewijzingssjablonen wilt uploaden, klikt u op de zojuist geïmplementeerde Azure IoT Connector for FHIR om naar de pagina IoT-connector te gaan.
Apparaattoewijzing
Met de sjabloon voor apparaattoewijzing worden apparaatgegevens getransformeerd tot een genormaliseerd schema. Klik op de pagina IoT-connector op de knop Apparaattoewijzing configureren om naar de pagina Apparaattoewijzing te gaan.
Voeg op de pagina Apparaattoewijzing het volgende script toe aan de JSON-editor en klik op Opslaan.
{
"templateType": "CollectionContent",
"template": [
{
"templateType": "IotJsonPathContent",
"template": {
"typeName": "heartrate",
"typeMatchExpression": "$..[?(@Body.telemetry.HeartRate)]",
"patientIdExpression": "$.Properties.iotcentral-device-id",
"values": [
{
"required": "true",
"valueExpression": "$.Body.telemetry.HeartRate",
"valueName": "hr"
}
]
}
}
]
}
FHIR-toewijzing
Met de sjabloon voor FHIR-toewijzing wordt een genormaliseerd bericht getransformeerd tot een op FHIR gebaseerde observatieresource. Klik op de pagina IoT-connector op de knop FHIR-toewijzing configureren om naar de pagina FHIR-toewijzing te gaan.
Voeg op de pagina FHIR-toewijzing het volgende script toe aan de JSON-editor en klik op Opslaan.
{
"templateType": "CollectionFhir",
"template": [
{
"templateType": "CodeValueFhir",
"template": {
"codes": [
{
"code": "8867-4",
"system": "http://loinc.org",
"display": "Heart rate"
}
],
"periodInterval": 0,
"typeName": "heartrate",
"value": {
"unit": "count/min",
"valueName": "hr",
"valueType": "Quantity"
}
}
}
]
}
Een verbindingsreeks genereren
Het IoMT-apparaat heeft een verbindingsreeks nodig om verbinding met Azure IoT Connector for FHIR te maken en er berichten naartoe te sturen. Selecteer op de pagina IoT-connector de knop Clientverbindingen beheren voor de zojuist geïmplementeerde Azure IoT Connector for FHIR.
Ga naar de pagina Verbindingen en klik op de knop Toevoegen om een nieuwe verbinding te maken.
Geef in het overlayvenster een beschrijvende naam op voor deze verbinding en selecteer de knop Maken.
Selecteer op de pagina Verbindingen de nieuwe verbinding die u hebt gemaakt en kopieer de waarde in het veld Primaire verbindingsreeks naar het overlayvenster aan de rechterkant.
Bewaar deze verbindingsreeks voor gebruik in een latere stap.
Uw apparaten verbinden met IoT
Azure biedt een uitgebreide reeks IoT-producten om verbinding te maken met uw IoT-apparaten en deze te beheren. U kunt uw eigen oplossing maken op basis van PaaS met behulp van Azure IoT Hub, of aan de slag gaan met een platform voor het beheren van IoT- apps met Azure IoT Central. Voor deze zelfstudie maken we gebruik van Azure IoT Central. Azure IoT Central bevat branchespecifieke oplossingssjablonen waarmee u aan de slag kunt.
Implementeer detoepassingssjabloon voor continue patiëntbewaking. Deze sjabloon bevat twee gesimuleerde apparaten waarmee realtimegegevens worden geproduceerd om u op weg te helpen: Smart Vitals Patch en Smart Knee Brace.
Notitie
Wanneer uw echte apparaten klaar zijn, kunt u dezelfde IoT Central-toepassing gebruiken voor de onboarding van uw apparaten en om de apparaatsimulatoren te vervangen. Uw apparaatgegevens worden ook automatisch naar FHIR gestroomd.
Uw IoT-gegevens verbinden met Azure IoT Connector for FHIR (preview)
Nadat u uw IoT Central-toepassing hebt geïmplementeerd, wordt telemetrische gegevens gegenereerd met de twee kant-en-klare gesimuleerde apparaten. Voor deze zelfstudie wordt de telemetrie van de Smart Vitals Patch-simulator via Azure IoT Connector for FHIR opgenomen. Als u uw IoT-gegevens wilt exporteren naar Azure IoT Connector for FHIR, kunt u het beste een continue gegevensexport instellen in IoT Central. Eerst moeten we een verbinding met de bestemming maken en vervolgens maken we een gegevensexport-taak om continu uit te voeren:
Notitie
Selecteer Gegevensexport versus Gegevensexport (verouderd) in de IoT Central App-instellingen voor deze sectie.
Maak een nieuwe bestemming:
- Ga naar het tabblad Bestemmingen en maak een nieuwe bestemming.
- Geef eerst een unieke naam op voor uw doel.
- Kies Azure Event Hubs als doeltype.
- Geef de Azure IoT Connector for FHIR-connection string die u in een vorige stap hebt verkregen voor het veld Verbindingsreeks.
Een nieuwe gegevensexport maken:
- Nadat u de bestemming hebt gemaakt, gaat u naar het tabblad Exports en maakt u een nieuwe gegevensexport.
- Begin door de gegevensexport een unieke naam te geven.
- Selecteer onder Gegevens de optie Telemetrie als het Type gegevens dat u wilt exporteren.
- Selecteer onder Doel de doelnaam die u in de vorige naam hebt gemaakt.
Apparaatgegevens weergeven in Azure API for FHIR
U kunt op FHIR gebaseerde observatieresources die zijn gemaakt met Azure IoT Connector for FHIR in Azure API for FHIR, weergeven met behulp van Postman. Zie Access the FHIR service using Postman (Toegang tot de FHIR-service met Postman) en een aanvraag indienen om GET Observation FHIR-resources met een hartslagwaarde https://your-fhir-server-url/Observation?code=http://loinc.org|8867-4 weer te geven.
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.
Resources opschonen
Wanneer u een instantie van Azure IoT Connector for FHIR niet meer nodig hebt, kunt u deze verwijderen door de gekoppelde resourcegroep of Azure API for FHIR-service of de instantie van Azure IoT Connector for FHIR zelf te verwijderen.
Als u een instantie van Azure IoT Connector for FHIR rechtstreeks wilt verwijderen, selecteert u de instantie op de pagina IoT-connectors om naar de pagina van de betreffende IoT-connector te gaan. Klik vervolgens op de knop Verwijderen. Selecteer Ja wanneer u wordt gevraagd om een bevestiging.
Volgende stappen
In deze quickstart-gids hebt u Azure IoT Connector for FHIR geïmplementeerd in uw Azure API for FHIR-resource. 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.
Meer informatie over het configureren van IoT-connector met behulp van FHIR-toewijzingssjablonen.
*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.