Inicio rápido: Implementación del conector de Azure IoT para FHIR (versión preliminar): Azure Portal
El conector de Azure IoT para Recursos Rápidos de Interoperabilidad en Salud (FHIR®)* es una característica opcional de Azure API for FHIR que proporciona la funcionalidad de ingesta de datos de dispositivos de Internet de las cosas médicas (IoMT). Durante la fase de versión preliminar, la característica Conector de Azure IoT para FHIR está disponible de forma gratuita. En esta guía de inicio rápido, aprenderá a hacer lo siguiente:
- Implementación y configuración del conector de Azure IoT para FHIR mediante Azure Portal
- Uso de un dispositivo simulado para enviar datos al conector de Azure IoT para FHIR
- Visualización de los recursos creados por el conector de Azure IoT para FHIR en Azure API for FHIR
Requisitos previos
- Una suscripción de Azure activa: cree una cuenta gratuita
- Recurso de Azure API for FHIR: Implementación de Azure API for FHIR mediante Azure Portal
Navegación al recurso de Azure API for FHIR
Abra Azure Portal y vaya al recurso Azure API for FHIR para el que querría crear la característica Conector de Azure IoT para FHIR.
En el menú de navegación de la izquierda, haga clic en Conector de IoT (versión preliminar) en la sección Complementos para abrir la página Conectores de IoT.
Creación de un nuevo conector de Azure IoT para FHIR (versión preliminar)
Haga clic en el botón Agregar para abrir la página Crear conector de IoT.
Escriba la configuración del nuevo conector de Azure IoT para FHIR. Haga clic en el botón Crear y espere a que se implemente el conector de Azure IoT para FHIR.
Nota
Debe seleccionar Crear como valor del menú desplegable Tipo de resolución de esta instalación.
| Configuración | Valor | Descripción |
|---|---|---|
| Nombre del conector | Un nombre único | Escriba un nombre para identificar el conector de Azure IoT para FHIR. Este nombre debe ser único en un recurso Azure API for FHIR. El nombre solo puede contener letras minúsculas, números y el carácter de guion (-). Debe comenzar y terminar con una letra o un número, y debe tener entre 3 y 24 caracteres de longitud. |
| Tipo de resolución | Lookup o Create | Seleccione Lookup si tiene un proceso fuera de banda para crear recursos FHIR de tipo Device y Patient en su instancia de Azure API for FHIR. El conector de Azure IoT para FHIR usará la referencia a estos recursos al crear un recurso FHIR de tipo Observation para representar los datos del dispositivo. Seleccione Crear si desea que el conector de Azure IoT para FHIR cree recursos de tipo Device y Patient esenciales en Azure API for FHIR con los respectivos valores de identificador presentes en los datos del dispositivo. |
Una vez completada la instalación, el conector de Azure IoT para FHIR recién creado se mostrará en la página Conectores de IoT.
Configuración del conector de Azure IoT para FHIR (versión preliminar)
El conector de Azure IoT para FHIR necesita dos plantillas de asignación para transformar los mensajes del dispositivo en recursos de tipo Observation basados en FHIR: asignación de dispositivo y asignación de FHIR. El conector de Azure IoT para FHIR no funcionará por completo hasta que se carguen estas asignaciones.
Para cargar plantillas de asignación, haga clic en el conector de Azure IoT para FHIR recién implementado para ir a la página Conector de IoT.
Asignación de dispositivos
La plantilla de asignación de dispositivos transforma los datos del dispositivo en un esquema normalizado. En la página Conector de IoT, haga clic en el botón Configure device mapping (Configurar asignación de dispositivos) para ir a la página de Asignación de dispositivos.
En la página Asignación de dispositivos, agregue el siguiente script al editor de JSON y haga clic en Guardar.
{
"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"
}
]
}
}
]
}
Asignación de FHIR
La plantilla de asignación de FHIR transforma un mensaje normalizado en un recurso de tipo Observation basado en FHIR. En la página Conector de IoT, haga clic en el botón Configure FHIR mapping (Configurar asignación de FHIR) para ir a la página de Asignación de FHIR.
En la página Asignación de FHIR, agregue el siguiente script al editor de JSON y haga clic en Guardar.
{
"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"
}
}
}
]
}
Generación de una cadena de conexión
El dispositivo IoMT necesita una cadena de conexión para conectarse y enviar mensajes al conector de Azure IoT para FHIR. En la página Conector de IoT para el conector de Azure IoT para FHIR recién implementado, seleccione el botón Manage client connections (Administrar conexiones de cliente).
Una vez en la página Conexiones, haga clic en el botón Agregar para crear una nueva conexión.
Proporcione un nombre descriptivo para esta conexión en la ventana superpuesta y seleccione el botón Crear.
Seleccione la conexión recién creada desde la página Conexiones y copie el valor del campo Cadena de conexión principal de la ventana superpuesta de la derecha.
Conserve esta cadena de conexión para usarla en un paso posterior.
Conexión de sus dispositivos a IoT
Azure ofrece un amplio conjunto de productos de IoT para conectar y administrar sus dispositivos de IoT. Puede crear su propia solución basada en PaaS mediante Azure IoT Hub o empezar con una plataforma de administración de aplicaciones de IoT con Azure IoT Central. En este tutorial, aprovecharemos Azure IoT Central, que tiene plantillas de soluciones centradas en el sector como introducción.
Implemente la plantilla de aplicación de supervisión continua de pacientes. Esta plantilla incluye dos dispositivos simulados que producen datos en tiempo real para ayudarle a comenzar: Smart Vitals Patch (parche de signos vitales inteligente) y Smart Knee Brace (rodillera inteligente).
Nota
Cada vez que los dispositivos reales estén listos, puede usar la misma aplicación de IoT Central para incorporar sus dispositivos y reemplazar los simuladores de dispositivos. Los datos del dispositivo también comenzarán a fluir automáticamente a FHIR.
Conexión de los datos de IoT con el conector de Azure IoT para FHIR (versión preliminar)
Una vez que haya implementado la aplicación de IoT Central, los dos dispositivos simulados listos para usar comenzarán a generar telemetría. En este tutorial, se ingerirá la telemetría del simulador Smart Vitals Patch en FHIR a través del conector de Azure IoT para FHIR. Para exportar los datos de IoT al conector de Azure IoT para FHIR, queremos configurar una exportación de datos continua en IoT Central. Primero tendremos que crear una conexión al destino y, después, crearemos un trabajo de exportación de datos para ejecutar continuamente:
Nota
Querrá seleccionar Exportación de datos frente a Exportación de datos (heredado) en la configuración IoT Central aplicación de esta sección.
Cree un nuevo destino:
- Vaya a la pestaña Destinos y cree un nuevo destino.
- Comience por dar un nombre único al destino.
- Elija Azure Event Hubs como tipo de destino.
- Proporcione Azure IoT connector para la cadena de conexión de FHIR obtenida en un paso anterior para el campo Cadena de conexión.
Cree una nueva exportación de datos:
- Una vez que haya creado el destino, vaya a la pestaña Exportaciones y cree una nueva exportación de datos.
- Empiece por darle un nombre único a la exportación de datos.
- En Datos, seleccione Telemetría como Tipo de datos para exportar.
- En Destino, seleccione el nombre de destino que creó en el nombre anterior.
Visualización de los datos del dispositivo en Azure API for FHIR
Puede ver los recursos de tipo Observation basados en FHIR que creó el conector de Azure IoT para FHIR en Azure API for FHIR mediante Postman. Para obtener información, consulte Acceso al servicio FHIR mediante Postman y realice una solicitud para ver los recursos de GET Observación de https://your-fhir-server-url/Observation?code=http://loinc.org|8867-4 FHIR con el valor de frecuencia del corazón.
Sugerencia
Asegúrese de que el usuario tiene acceso adecuado al plano de datos de Azure API for FHIR. Use el control de acceso basado en roles de Azure (Azure RBAC) para asignar los bloques del plano de datos requeridos.
Limpieza de recursos
Cuando ya no sean necesarios, puede eliminar una instancia del conector de Azure IoT para FHIR si quita el grupo de recursos asociado, el servicio de Azure API for FHIR asociado, o bien la propia instancia del conector de Azure IoT para FHIR.
Para quitar directamente una instancia del conector de Azure IoT para FHIR, selecciónela en la página Conectores de IoT para ir a la página Conector de IoT y haga clic en el botón Eliminar. Seleccione Sí cuando se solicite confirmación.
Pasos siguientes
En esta guía de inicio rápido, ha implementado la característica Conector de Azure IoT para FHIR en el recurso de Azure API for FHIR. Seleccione en los pasos siguientes para más información sobre el conector de Azure IoT para FHIR:
Conozca las distintas fases del flujo de datos en el conector de Azure IoT para FHIR.
Aprenda a configurar el conector de IoT mediante plantillas de asignación de dispositivos y FHIR.
*En Azure Portal, el conector de Azure IoT para FHIR se conoce como conector de IoT (versión preliminar). FHIR es una marca registrada de HL7 y se usa con el permiso de HL7.