Introducción a la asignación de dispositivos del servicio de tecnologías médicas

Artículo
11/21/2023

En este artículo, se proporciona información general sobre la asignación de dispositivos del servicio de tecnologías médicas.

El servicio de tecnologías médicas requiere dos tipos de asignaciones JSON que se agregan a este servicio mediante Azure Portal o la API de Azure Resource Manager (ARM). La asignación de dispositivos es el primer tipo y controla los valores de asignación de los datos del dispositivo enviados al servicio de tecnologías médicas, a un objeto de datos normalizado interno. La asignación de dispositivos contiene expresiones que el servicio de tecnologías médicas usa para extraer tipos, identificadores de dispositivo, fecha y hora de medición y valores de medida. La asignación de destino de FHIR® es el segundo tipo y controla la asignación de observaciones de FHIR.

Nota:

Las asignaciones de dispositivos y de destinos de FHIR se vuelven a evaluar cada vez que se procesa un mensaje de dispositivo. Las actualizaciones de cualquiera de las asignaciones surtirán efecto inmediatamente.

Conceptos básicos de la asignación de dispositivos

La asignación de dispositivos contiene colecciones de plantillas de expresiones que se usan para extraer datos de mensajes de dispositivo en un formato interno normalizado para su posterior evaluación. Cada mensaje de dispositivo recibido se evalúa con todas las plantillas de expresiones de la colección. Esta evaluación significa que un único mensaje de dispositivo se puede separar en varios mensajes salientes que se pueden asignar a varias observaciones de FHIR en el servicio FHIR.

Sugerencia

Para obtener más información sobre cómo procesa el servicio de tecnologías médicas los datos de los mensajes de dispositivo en observaciones de FHIR para la persistencia en el servicio FHIR, consulte Información general sobre las fases de procesamiento de datos de dispositivos del servicio de tecnologías médicas.

En este diagrama, se proporciona una ilustración de lo que sucede durante la fase de normalización dentro del servicio de tecnologías médicas.

Validaciones de asignaciones de dispositivos

El proceso de normalización valida la asignación de dispositivos antes de permitir que se guarde para su uso. Estos elementos son necesarios en las plantillas de asignación de dispositivos.

Asignación de dispositivos

Elemento	Obligatorio en CalculatedContent	Obligatorio en IotJsonPathContent
typeName	True	True
typeMatchExpression	True	True
deviceIdExpression	True	False y se omite por completo.
timestampExpression	True	False y se omite por completo.
patientIdExpression	True cuando el tipo de resolución de los servicios de tecnologías médicas se establece en Crear; False cuando el tipo de resolución del servicio de tecnologías médicas se establece en Búsqueda.	True cuando el tipo de resolución del servicio de tecnologías médicas se establece en Crear; False cuando el tipo de resolución del servicio de tecnologías médicas se establece en Búsqueda.
encounterIdExpression	False	False
correlationIdExpression	False	False
values[].valueName	True	True
values[].valueExpression	True	True
values[].required	True	True

Importante

El tipo de resolución especifica cómo asocia el servicio de tecnologías médicas los datos del dispositivo a los recursos del dispositivo y a los recursos del paciente. El servicio de tecnologías médicas lee los recursos de dispositivo y paciente del servicio FHIR mediante identificadores de dispositivo e identificadores de paciente. Si se especifica un identificador de encuentro y se extrae de la carga de datos del dispositivo, se vinculará a la observación si existe un encuentro en el servicio FHIR con ese identificador. Si el identificador de encuentro se normaliza correctamente, pero no existe ningún encuentro de FHIR con ese identificador de encuentro, se produce una excepción FhirResourceNotFound. Para más información sobre la configuración del tipo de resolución del servicio de tecnologías médicas, consulte Configuración de la pestaña Destino.

Nota:

Los elementos values[].valueName, values[].valueExpression y values[].required solo son necesarios si tiene una entrada de valor en la matriz. Es válido no tener ningún valor asignado. Estos elementos se usan cuando la telemetría que se envía es un evento.

Por ejemplo, algunos escenarios pueden requerir la creación de una observación de FHIR en el servicio FHIR que no contenga un valor.

CollectionContent

CollectionContent es el tipo de plantilla raíz que usa la asignación de dispositivos del servicio de tecnologías médicas. CollectionContent es una lista de todas las plantillas que se usan durante la fase de normalización. Puede definir una o varias plantillas dentro de CollectionContent, y cada mensaje de dispositivo recibido por el servicio de tecnologías médicas se evalúa con todas las plantillas.

Puede usar estos tipos de plantilla en CollectionContent en función de su caso de uso:

CalculatedContent para los mensajes de dispositivo enviados directamente al centro de eventos del servicio de tecnologías médicas. CalculatedContent admite JSONPath, JMESPath, funciones JMESPath y las funciones personalizadas del servicio de tecnologías médicas.

y/o

IotJsonPathContent para los mensajes de dispositivo que se enrutan mediante una instancia de Azure IoT Hub al centro de eventos del servicio de tecnologías médicas. IotJsonPathContent admite JSONPath.

Ejemplo

Sugerencia

Puede usar el depurador de asignaciones del servicio de tecnologías médicas para obtener ayuda para crear, actualizar y solucionar problemas de las asignaciones de destino de FHIR y de dispositivos del servicio de tecnologías médicas. El depurador de asignaciones le permite ver y realizar fácilmente ajustes insertados en tiempo real, sin tener que salir de Azure Portal. 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.

En este ejemplo, se usa un mensaje de dispositivo que captura datos de tipo heartRate:

{
  "heartRate": "78",
  "endDate": "2023-03-13T22:46:01.8750000",
  "deviceId": "device01"
}

Usamos esta asignación de dispositivos para la fase de normalización:

{
  "templateType": "CollectionContent",
  "template": [
    {
      "templateType": "CalculatedContent",
      "template": {
        "typeName": "heartrate",
        "typeMatchExpression": "$..[?(@heartRate)]",
        "deviceIdExpression": "$.matchedToken.deviceId",
        "timestampExpression": "$.matchedToken.endDate",
        "values": [
          {
            "required": true,
            "valueExpression": "$.matchedToken.heartRate",
            "valueName": "hr"
          }
        ]
      }
    }
  ]
}

El mensaje normalizado resultante tendrá este aspecto después de la fase de normalización:

[
  {
    "type": "heartrate",
    "occurrenceTimeUtc": "2023-03-13T22:46:01.875Z",
    "deviceId": "device01",
    "properties": [
      {
        "name": "hr",
        "value": "78"
      }
    ]
  }
]

Cuando el servicio de tecnologías médicas procesa el mensaje de dispositivo, se usan las plantillas de CollectionContent para evaluar el mensaje. El elemento typeMatchExpression se usa para determinar si se debe usar o no la plantilla para crear un mensaje normalizado a partir del mensaje de dispositivo. Si el elemento typeMatchExpression se evalúa como true, se usan los valores deviceIdExpression, timestampExpression y valueExpression para buscar y extraer los valores JSON del mensaje de dispositivo y crear un mensaje normalizado. En este ejemplo, se han escrito todas las expresiones en JSONPath; sin embargo, sería válido escribir todas las expresiones en JMESPath. Es necesario que el autor de la plantilla determine qué lenguaje de expresión es más adecuado.

Sugerencia

Para obtener ayuda para corregir errores comunes de implementación del servicio de tecnologías médicas, consulte Solución de errores de implementación del servicio de tecnologías médicas.

Para obtener ayuda para corregir los errores del servicio de tecnologías médicas, consulte Solución de errores mediante los registros del servicio de tecnologías médicas.