rychlý start: nasazení služby Azure IoT Connector pro FHIR (preview) pomocí Azure Portal
azure IoT Connector pro rychlé interoperability prostředků (FHIR®) * je volitelná funkce Azure API pro FHIR, která poskytuje schopnost ingestovat data ze zařízení IoMT (Internet of medicíny). Během období Preview je funkce konektoru Azure IoT pro FHIR k dispozici bezplatně. V tomto rychlém startu se naučíte:
- Nasazení a konfigurace konektoru Azure IoT pro FHIR s využitím webu Azure Portal
- Odesílání dat do konektoru Azure IoT pro FHIR s využitím simulovaného zařízení
- Zobrazení prostředků vytvořených konektorem Azure IoT pro FHIR v rozhraní Azure API for FHIR
Požadavky
- Aktivní předplatné Azure – můžete ho vytvořit zdarma .
- Rozhraní Azure API pro FHIR Resource – nasazení rozhraní Azure API pro FHIR pomocí Azure Portal
Přejít na Azure API pro prostředek FHIR
otevřete Azure Portal a vyhledejte prostředek azure API for FHIR , pro který chcete vytvořit funkci azure IoT Connector for FHIR.
v navigační nabídce vlevo klikněte na IoT Connector (preview) v části doplňky otevřete stránku konektory IoT .
vytvoření nové služby Azure IoT Connector pro FHIR (preview)
kliknutím na tlačítko přidat otevřete stránku vytvořit IoT Connector .
zadejte nastavení pro nový IoT Connector Azure pro FHIR. klikněte na tlačítko vytvořit a pro nasazení FHIR očekávat službu Azure IoT Connector.
Poznámka
Pro tuto instalaci musíte vybrat vytvořit jako hodnotu pro rozevírací seznam typ řešení .
| Nastavení | Hodnota | Popis |
|---|---|---|
| Název konektoru | Jedinečný název | zadejte název, který identifikuje IoT Connector azure pro FHIR. tento název by měl být jedinečný v rámci azure API pro prostředek FHIR. Název může obsahovat jenom malá písmena, číslice a znak spojovníku (-). Musí začínat a končit písmenem nebo číslicí a musí mít délku 3-24 znaků. |
| Typ řešení | Vyhledat nebo vytvořit | Pokud máte mimo IP síť, vyberte Vyhledat v případě, že máte v rozhraní API Azure pro FHIR vytvořit prostředky zařízení a pacient FHIR. Azure IoT Connector pro FHIR použije odkaz na tyto prostředky při vytváření prostředku sledování FHIR, který bude reprezentovat data zařízení. vyberte vytvořit , když chcete, aby Azure IoT Connector FHIR v rozhraní API azure pro FHIR vytvořit holé prostředky zařízení a pacienta, a to pomocí odpovídajících hodnot identifikátorů přítomných v datech zařízení. |
po dokončení instalace se nově vytvořená IoT Connector Azure pro FHIR zobrazí na stránce konektory IoT .
konfigurace Azure IoT Connector pro FHIR (preview)
Azure IoT Connector pro FHIR potřebuje dvě šablony mapování pro transformaci zpráv zařízení do prostředků pozorování založených na FHIR: mapování zařízení a mapování FHIR. vaše IoT Connector Azure pro FHIR není plně funkční, dokud se tato mapování nebudou nahrávat.
pokud chcete nahrát šablony mapování, klikněte na nově nasazenou službu Azure IoT Connector pro FHIR, abyste přešli na stránku IoT Connector .
Mapování zařízení
Šablona mapování zařízení transformuje data zařízení do normalizovaného schématu. na stránce IoT Connector klikněte na tlačítko konfigurovat mapování zařízení a přejděte na stránku mapování zařízení .
Na stránce mapování zařízení přidejte následující skript do editoru JSON a klikněte na Uložit.
{
"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"
}
]
}
}
]
}
Mapování FHIR
Šablona mapování FHIR transformuje normalizovanou zprávu na prostředek pozorování založený na FHIR. na stránce IoT Connector klikněte na tlačítko nakonfigurovat mapování FHIR a přejděte na stránku mapování FHIR .
Na stránce mapování FHIR přidejte následující skript do editoru JSON a klikněte na Uložit.
{
"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"
}
}
}
]
}
Vygenerování připojovacího řetězce
zařízení IoMT potřebuje připojovací řetězec pro připojení a posílání zpráv do služby Azure IoT Connector pro FHIR. na stránce IoT Connector pro nově nasazenou službu Azure IoT Connector pro FHIR vyberte tlačítko spravovat připojení klienta .
Po stránce připojení klikněte na tlačítko Přidat a vytvořte nové připojení.
Zadejte popisný název tohoto připojení v překryvném okně a klikněte na tlačítko vytvořit .
Vyberte nově vytvořené připojení ze stránky připojení a zkopírujte hodnotu pole primární připojovací řetězec z překryvného okna na pravé straně.
Zachovat tento připojovací řetězec, který se má použít v pozdějším kroku.
Připojení zařízení do IoT
Azure nabízí rozsáhlou sadu produktů IoT pro připojení a správu vašich zařízení IoT. Pomocí služby Azure IoT Hub můžete vytvořit vlastní řešení založené na PaaS nebo začít s platformou spravovat aplikace IoT pomocí Azure IoT Central. V tomto kurzu budeme využívat Azure IoT Central, který obsahuje šablony řešení zaměřené na obor, které vám pomůžou začít.
Nasaďte šablonu aplikace pro monitorování nepřetržitého pacienta. Tato šablona obsahuje dvě simulovaná zařízení, která vytvářejí data v reálném čase, která vám pomůžou začít: inteligentní a inteligentní kolenum.
Poznámka
Až budou vaše skutečná zařízení připravená, můžete pomocí stejné aplikace IoT Central připojit zařízení a vyměnit simulátory zařízení. Data zařízení se automaticky začnou přesměrovat do FHIR.
Připojení dat IoT pomocí Azure IoT Connector pro FHIR (preview)
Po nasazení IoT Central aplikace začnou vaše dvě předem připravená simulovaná zařízení generovat telemetrii. v tomto kurzu budeme ingestovat telemetrii z inteligentního simulátoru opravy do FHIR prostřednictvím Azure IoT Connector pro FHIR. pokud chcete exportovat data IoT do Azure IoT Connector pro FHIR, chceme v rámci IoT Central nastavit průběžný export dat. Nejdřív budeme muset vytvořit připojení k cíli a pak vytvoříme úlohu exportu dat, která bude nepřetržitě běžet:
Poznámka
V nastavení aplikace IoT Central pro tuto část budete chtít vybrat Export dat vs. Export dat (starší verze) .
Vytvořit nový cíl:
- Přejít na kartu cíle a vytvořit nový cíl.
- Začněte tím, že mu udělíte jedinečný název.
- Jako cílový typ vyberte Azure Event Hubs .
- zadejte připojovací řetězec služby Azure IoT Connector pro FHIR, který jste získali v předchozím kroku pro pole připojovací řetězec .
Vytvořit nový export dat:
- Jakmile vytvoříte cíl, pokračujte na kartu exporty a vytvořte nový export dat.
- Začněte tím, že data exportujte jedinečný název.
- V části data vyberte telemetrii jako typ dat k exportu.
- V části cíl vyberte název cíle, který jste vytvořili v předchozím názvu.
Zobrazení dat zařízení v rozhraní Azure API pro FHIR
můžete zobrazit prostředky pro sledování založené na FHIR, které vytvořila služba azure IoT Connector pro FHIR v rozhraní azure API pro FHIR pomocí post. Informace najdete v tématu přístup ke službě FHIR pomocí metody post a vytvoření GET žádosti o https://your-fhir-server-url/Observation?code=http://loinc.org|8867-4 zobrazení FHIR prostředků sledování s hodnotou srdce.
Tip
Ujistěte se, že váš uživatel má odpovídající přístup k rozhraní Azure API pro rovinu dat FHIR. Pomocí řízení přístupu na základě role Azure (Azure RBAC) přiřaďte požadované role roviny dat.
Vyčištění prostředků
pokud už je nepotřebujete, můžete instanci azure IoT Connector pro FHIR odstranit tak, že odeberete přidruženou skupinu prostředků nebo přidružené rozhraní API azure pro službu FHIR nebo azure IoT Connector pro instanci FHIR.
Pokud chcete instanci Azure IoT Connector for FHIR přímo odebrat, vyberte instanci ze stránky Konektory IoT, přejděte na IoT Connector stránky a klikněte na tlačítko Odstranit. Po vyzvání k potvrzení vyberte Ano.
Další kroky
V této úvodní příručce jste do svého prostředku azure IoT Connector for FHIR nasadili Azure API for FHIR azure. Pokud chcete získat další informace o Azure IoT Connector for FHIR, vyberte z následujících kroků:
Porozumět různým fázím toku dat v rámci Azure IoT Connector pro FHIR.
Zjistěte, jak nakonfigurovat IoT Connector pomocí šablon mapování zařízení a FHIR.
*V Azure Portal se Azure IoT Connector for FHIR označuje jako IoT Connector (Preview). FHIR je registrovaná ochranná známka HL7 a používá se se souhlasem HL7.