Cómo usar el depurador de mapeo del servicio MedTech (versión preliminar)

Importante

El desuso del servicio de tecnologías médicas se inició el 3 de mayo de 2025. Si el uso de un servicio de tecnologías médicas ya no es una prioridad, desaprovisione la instancia, que se puede encontrar aquí. Soporte con instancias activas en las siguientes regiones finalizará el 3 de mayo de 2028: Oeste de EE. UU. 2, Sur de Reino Unido, Oeste de Europa, Este de EE. UU., Este de Australia, Este de EE. UU. 2, Centro de la India, Norte de Europa. La versión de código abierto del servicio de tecnologías médicas se puede encontrar aquí.

Importante

Esta funcionalidad está disponible actualmente para la versión preliminar pública y está sujeta a cambios. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

En este artículo, aprenderá a usar el depurador de asignación de servicios de tecnologías médicas. El depurador de mapeo es una herramienta de autoservicio que se utiliza para crear, actualizar y solucionar problemas del servicio MedTech dispositivo y los mapeos de destino FHIR®. El depurador de mapeo le permite ver y realizar fácilmente ajustes en línea en tiempo real, sin tener que salir del portal de Azure. El depurador de asignaciones también se puede usar para cargar mensajes de dispositivo de prueba para ver su aspecto después de procesarse en mensajes normalizados y transformarse en observaciones de FHIR.

Sugerencia

Para obtener información sobre cómo el servicio MedTech transforma y conserva los datos de mensajes del dispositivo en el servicio FHIR, consulte Introducción a las fases de procesamiento de datos de dispositivos del servicio MedTech.

En el siguiente vídeo se presenta una visión general sobre el depurador de mapeo.

Información general del depurador de mapeo

1. Para acceder al depurador de asignación del servicio de tecnologías médicas, seleccione Depurador de asignación en el servicio de tecnologías médicas en Azure Portal. En este artículo, se usa un servicio MedTech denominado mt-azuredocsdemo. Seleccione su propio servicio MedTech. Desde esta pantalla, podemos ver que el depurador de mapeo presenta los mapeos de dispositivo y destino FHIR asociados a este servicio MedTech y proporciona una validación de esos mapeos.

   

2. El depurador de asignación proporciona características cómodas que ayudan a facilitar la administración, edición y solución de problemas de las asignaciones de dispositivo y destino de FHIR.

   

   Cargar : con esta selección, puede cargar:

   • Asignación de dispositivos: se puede editar y guardar (opcional) en el servicio de tecnologías médicas.
   • Asignación de destino de FHIR: se puede editar y guardar en el servicio MedTech, si se desea (opcional).
   • Mensaje del dispositivo de prueba: lo usa el servicio de validación para generar una medición normalizada de ejemplo y una observación FHIR en función de los mapeos proporcionados.

   Descargar : con esta selección puede descargar copias de:

   • Mapeo de dispositivos: el mapeo de dispositivos que utiliza actualmente tu servicio de MedTech.
   • Mapeo de destino FHIR: el mapeo de destino FHIR que utiliza actualmente su servicio MedTech.
   • Asignaciones: ambas asignaciones usadas actualmente por el servicio de tecnologías médicas

Solución de problemas de las asignaciones de dispositivo y destino de FHIR mediante el depurador de asignación

Para este ejemplo de solución de problemas, estamos usando un mensaje de prueba de dispositivo que es enviado a través de un Azure IoT Hub y un mapeo de dispositivos que emplea templates de IotJsonPathContent.

1. Si hay errores con las asignaciones de dispositivo y destino de FHIR, el depurador de asignación muestra los problemas. En este ejemplo, podemos ver que hay advertencias de error en la línea 12 de la asignación de dispositivos y en la línea 20 de la asignación de destino de FHIR.

   

2. Si coloca el cursor del mouse sobre una advertencia de error, el depurador de asignación proporciona más información del error.

   

3. Ahora se usan las sugerencias proporcionadas por el depurador de asignación y ahora se corrigen las advertencias de error. Estamos listos para seleccionar Guardar para confirmar nuestras asignaciones de destino de FHIR y dispositivo actualizadas al servicio de tecnologías médicas.

   

   Nota:

   El servicio de tecnologías médicas solo guarda las asignaciones que se han cambiado o actualizado. Por ejemplo: Si solo ha realizado un cambio en la asignación de dispositivos, solo esos cambios se guardan en el servicio MedTech y no se guardaría ningún cambio en la asignación de destino de FHIR. Esto es así por diseño y para ayudar con el rendimiento del servicio MedTech.

4. Una vez que las asignaciones de destino del dispositivo y FHIR se han guardado correctamente, se crea una confirmación desde Notificaciones en el portal de Azure.

   

Ver un mensaje normalizado y la observación de FHIR

1. El depurador de asignación ofrece la posibilidad de ver las salidas de ejemplo de las fases normalización y transformación de FHIR proporcionando un mensaje del dispositivo de prueba. Seleccione Cargar y probar mensaje del dispositivo.

   

2. Se abre el cuadro Seleccionar un archivo . En este ejemplo, seleccione Entrar manualmente.

   

3. Copie o pegue el mensaje del dispositivo de prueba en el cuadro Cargar mensaje del dispositivo de prueba. El cuadro Validación puede seguir siendo rojo si cualquiera de las asignaciones tiene un error o advertencia. Siempre que No haya erroresen verde, el mensaje del dispositivo de prueba es válido con las asignaciones de destino del dispositivo y FHIR proporcionadas.

   Nota:

   El depurador de asignación también muestra los enriquecimientos realizados en el mensaje del dispositivo de prueba si ha sido enrutado a través de un mensaje desde una instancia de Azure IoT Hub (por ejemplo, la adición de los elementos Body, Properties y SystemProperties).

   

   Seleccione la X en la esquina derecha para cerrar el cuadro del mensaje de cargar dispositivo de prueba.

4. Una vez cargado un mensaje de dispositivo de prueba válido, los botones Ver mensaje normalizado y Ver observación de FHIR están disponibles para que pueda ver las salidas de ejemplo de las fases de normalización y transformación FHIR. Estas salidas de ejemplo se pueden usar para validar que las asignaciones de dispositivo y destino de FHIR están configuradas correctamente para procesar mensajes del dispositivo según sus requisitos.

   

5. Use la X en la esquina para cerrar los cuadros Mensaje normalizado y Observación de FHIR.

   

   

Pasos siguientes

Información general sobre el mapeo de dispositivos del servicio MedTech

Información general sobre el mapeo de destino FHIR del servicio MedTech

Información general sobre las asignaciones basadas en escenarios del servicio de tecnologías médicas

Nota:

FHIR® es una marca registrada de HL7 y se utiliza con el permiso de HL7.