Обзор сопоставления устройств службы MedTech

Это важно

Прекращение использования службы MedTech было инициировано 3 мая 2025 года. Если использование службы MedTech больше не является приоритетом, удалите экземпляр, который можно найти здесь. Поддержка активных инстанций в следующих регионах завершится 3 мая 2028 г.: Западная часть США 2, Южная часть Великобритании, Западная Европа, Восточная часть США, Восточная часть США 2, Центральная Индия, Северная Европа. Здесь можно найти версию службы MedTech с открытым исходным кодом.

В этой статье представлен обзор сопоставления устройств службы MedTech.

Для службы MedTech требуются два типа JSON отображения, которые добавляются через портал Azure или API Azure Resource Manager (ARM). Сопоставление устройств является первым типом и управляет значениями сопоставления в данных устройства, которые отправляются в службу MedTech, во внутренний нормализованный объект данных. Сопоставление устройств содержит выражения, которые служба MedTech использует для извлечения типов, идентификаторов устройств, даты измерения и значений измерения. Сопоставление назначения назначения FHIR® является вторым типом и управляет сопоставлением для наблюдений FHIR.

Замечание

Сопоставления назначения устройств и FHIR переоцениваются при каждом обработанном сообщении устройства. Обновления любого из сопоставлений вступают в силу немедленно.

Основы сопоставления устройств

Сопоставление устройств содержит коллекции шаблонов выражений, используемых для извлечения данных сообщения устройства во внутренний нормализованный формат для дальнейшей оценки. Каждое полученное сообщение устройства вычисляется по всем шаблонам выражений в коллекции. Эта оценка означает, что одно сообщение устройства можно разделить на несколько исходящих сообщений, которые можно сопоставить с несколькими наблюдениями FHIR в службе FHIR.

Подсказка

Дополнительные сведения о том, как служба MedTech обрабатывает данные сообщения об устройстве в наблюденияХ FHIR для сохранения в службе FHIR, см. в разделе "Обзор этапов обработки данных устройства службы MedTech".

На этой схеме показана иллюстрация того, что происходит на этапе нормализации в службе MedTech.

Проверки сопоставления устройств

Процесс нормализации проверяет сопоставление устройств, прежде чем позволить сохранить это сопоставление для использования. Эти элементы необходимы в шаблонах сопоставления устройств.

Сопоставление устройств

Элемент	Требуется в CalculatedContent	Обязательный параметр в IotJsonPathContent
typeName	True	True
typeMatchExpression	True	True
deviceIdExpression	True	Ложь и полностью игнорируется.
timestampExpression	True	Ложь и полностью игнорируется.
patientIdExpression	Значение True, если для типа разрешения служб MedTech задано значение Create; False, если для типа разрешения службы MedTech задано значение Lookup.	Значение True, если для типа разрешения службы MedTech задано значение Create; False, если для типа разрешения службы MedTech задано значение Lookup.
encounterIdExpression	Неправда	Неправда
correlationIdExpression	Неправда	Неправда
values[].valueName	True	True
values[].valueExpression	True	True
значения[].требуется	True	True

Это важно

Тип разрешения указывает, как служба MedTech связывает данные устройства с ресурсами устройства и ресурсами пациентов. Служба MedTech считывает ресурсы устройств и пациентов из службы FHIR с помощью идентификаторов устройств и идентификаторов пациентов. Если идентификатор контакта указан и извлечен из полезной нагрузки данных устройства, он связан с наблюдением, если контакт существует в службе FHIR с данным идентификатором. Если идентификатор встречи был успешно нормализован, но FHIR Встреча с таким идентификатором отсутствует, будет выброшено исключение FhirResourceNotFound. Дополнительные сведения о настройке типа разрешения службы MedTech см. на вкладке "Настройка назначения".

Замечание

Элементы values[].valueName, values[].valueExpression и values[].required требуются только в том случае, если в массиве представлено значение. Допустимо, чтобы значения не были сопоставлены. Эти элементы используются, когда отправляемая телеметрия является событием.

Например, для некоторых сценариев может потребоваться создание FHIR-наблюдения в сервисе FHIR, которое не содержит значения.

СодержимоеКоллекции

CollectionContent — это тип корневого шаблона, используемый сопоставлением устройств службы MedTech. CollectionContent — это список всех шаблонов, которые используются на этапе нормализации. Вы можете определить один или несколько шаблонов в CollectionContent, при этом каждое сообщение устройства, полученное службой MedTech, вычисляется по всем шаблонам.

Эти типы шаблонов можно использовать в CollectionContent в зависимости от варианта использования:

CalculatedContent для сообщений устройств, отправленных непосредственно в концентратор событий службы MedTech. CalculatedContent поддерживает функции JSONPath, JMESPath, JMESPath и пользовательские функции службы MedTech.

и (или)

IotJsonPathContent для сообщений устройств, передаваемых через Центр Интернета вещей Azure в концентратор событий службы MedTech. IotJsonPathContent поддерживает JSONPath.

Пример

Подсказка

Вы можете использовать MedTech-сервис отладчик сопоставления для помощи при создании, обновлении и устранении неполадок в сопоставлениях устройств MedTech и назначения FHIR. Отладчик сопоставления позволяет легко просматривать и вносить встроенные корректировки в режиме реального времени, не покидая портал Azure. Отладчик сопоставления также можно использовать для загрузки тестовых сообщений устройства, чтобы увидеть, как они будут выглядеть после обработки в нормализованные сообщения и преобразования в наблюдения FHIR.

В этом примере мы используем сообщение от устройства, которое записывает данные heartRate.

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

Мы используем это сопоставление устройств для этапа нормализации:

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

Полученное нормализованное сообщение будет выглядеть следующим образом после этапа нормализации:

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

Когда служба MedTech обрабатывает сообщение устройства, шаблоны в CollectionContent используются для оценки сообщения. Используется typeMatchExpression для определения того, следует ли использовать шаблон для создания нормализованного сообщения из сообщения устройства. Если typeMatchExpression оценивается как true, то значения deviceIdExpression, timestampExpression и valueExpression используются для поиска и извлечения JSON-значений из сообщения устройства и создания нормализованного сообщения. В этом примере все выражения записаны в JSONPath, однако возможно записать все выражения в JMESPath. Это зависит от автора шаблона, чтобы определить, какой язык выражений наиболее подходит.

Подсказка

Сведения об устранении распространенных ошибок развертывания служб MedTech см. в разделе "Устранение неполадок при развертывании службы MedTech".

Сведения об устранении ошибок службы MedTech см. в разделе "Устранение ошибок" с помощью журналов служб MedTech.