Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Это важно
Прекращение использования службы MedTech было инициировано 3 мая 2025 года. Если использование службы MedTech больше не является приоритетом, удалите экземпляр, который можно найти здесь. Поддержка активных инстанций в следующих регионах завершится 3 мая 2028 г.: Западная часть США 2, Южная часть Великобритании, Западная Европа, Восточная часть США, Восточная часть США 2, Центральная Индия, Северная Европа. Здесь можно найти версию службы MedTech с открытым исходным кодом.
В этой статье представлен обзор сопоставления назначения службы MedTech FHIR®.
Служба MedTech требует двух типов сопоставлений JSON, которые добавляются в службу MedTech через портал Azure или API Azure Resource Manager. Сопоставление устройств — это первый тип, который управляет сопоставлением значений в данных устройства, отправляемых в службу MedTech для преобразования во внутренний нормализованный объект данных. Сопоставление устройств содержит выражения, которые служба MedTech использует для извлечения типов, идентификаторов устройств, даты измерения и значений измерения. Сопоставление назначения FHIR является вторым типом и определяет, как нормализованные данные сопоставляются с наблюдениями FHIR.
Замечание
Сопоставления назначения устройств и FHIR переоцениваются при каждом обработанном сообщении устройства. Обновления любого из сопоставлений вступают в силу немедленно.
Основные сведения о сопоставлении местоположений FHIR
Сопоставление конечного пункта FHIR управляет тем, как нормализованные данные, извлеченные из сообщения устройства, сопоставляются с FHIR-наблюдением.
- Следует ли создать наблюдение для точки во времени или в течение часа?
- Какие коды следует добавить в наблюдение?
- Должно ли значение быть представлено как SampledData или количество?
Эти типы данных все являются опциями конфигурации сопоставления назначения FHIR.
После того как данные устройства преобразованы в нормализованную модель данных, нормализованные данные собираются для последующего преобразования в наблюдение FHIR. Если тип наблюдения — SampledData, данные группируются в соответствии с идентификатором устройства, типом измерения и периодом времени (период времени может составлять 1 час или 24 часа). Выходные данные этой группировки отправляются для преобразования в одно FHIR-наблюдение, которое представляет период времени для этого типа данных. Для других типов наблюдений (Количество, CodeableConcept и String) данные не группируются, но вместо этого каждое измерение преобразуется в одно наблюдение, представляющее точку во времени.
Подсказка
Дополнительные сведения о том, как служба MedTech обрабатывает данные сообщения об устройстве в наблюденияХ FHIR для сохранения в службе FHIR, см. в разделе "Обзор этапов обработки сообщений об устройстве службы MedTech".
На этой схеме показана иллюстрация того, что происходит на этапе преобразования в службе MedTech.
Замечание
Наблюдение FHIR, изображённое на этой схеме, не является полным ресурсом. См . пример в этом обзоре для всего наблюдения FHIR.
CollectionFhir
CollectionFhir — это тип корневого шаблона, используемый в сопоставлении назначения службы MedTech в формате FHIR. CollectionFhir — это список всех шаблонов, используемых на этапе преобразования. Вы можете определить один или несколько шаблонов в CollectionFhir, при этом каждое нормализованное сообщение вычисляется по всем шаблонам.
CodeValueFhir
CodeValueFhir в настоящее время является единственным шаблоном, поддерживаемым в сопоставлении назначения FHIR. Он позволяет определять коды, действующий период и значение наблюдения. Поддерживаются несколько типов значений: SampledData, CodeableConcept, Quantity и String. Наряду с этими настраиваемыми значениями идентификатор ресурса наблюдения и связывание с соответствующими ресурсами устройства и пациентов обрабатываются автоматически.
Это важно
Тип разрешения указывает, как служба MedTech связывает данные устройства с ресурсами устройства и ресурсами пациентов. Служба MedTech считывает ресурсы устройств и пациентов из службы FHIR с помощью идентификаторов устройств и идентификаторов пациентов. Если идентификатор контакта указан и извлечен из полезной нагрузки данных устройства, он связан с наблюдением, если контакт существует в службе FHIR с данным идентификатором. Если идентификатор встречи был успешно нормализован, но FHIR Встреча с таким идентификатором отсутствует, будет выброшено исключение FhirResourceNotFound. Дополнительные сведения о настройке типа разрешения службы MedTech см. на вкладке "Настройка назначения".
| Элемент | Описание | Обязательный |
|---|---|---|
| typeName | Тип измерения, с которым следует связать этот шаблон. Примечание: Должен быть по крайней мере один шаблон сопоставления устройств, содержащий такой же typeName. Элемент typeName используется для связывания шаблона сопоставления назначения FHIR с одним или несколькими шаблонами сопоставления устройств. Шаблоны сопоставления устройств с тем же typeName элементом создают нормализованные данные, вычисляемые с помощью шаблона сопоставления назначения FHIR, который имеет тот же typeName. |
True |
| periodInterval | Период времени, который должен представлять созданное наблюдение. Поддерживаемые значения: 0 (экземпляр), 60 (час), 1440 (день). | Значение True, если тип наблюдения — SampledData; Игнорируется для других типов наблюдений. |
| категория | Любое количество CodeableConcepts для определения типа созданного наблюдения. | Неправда |
| Коды | Одно или несколько кодов для применения к созданному наблюдению. | True |
| коды[].код | Код для кодирования в элементе codes. |
True |
| codes[].system | Система для кодирования в элементе codes. |
Неправда |
| codes[].display | Отображение кода в элементе codes . |
Неправда |
| value | Значение для извлечения и представления в наблюдении. Дополнительные сведения об элементах, содержащихся в value элементе, см. в разделе "Типы значений". |
True, если элемент components не используется (если тип Наблюдения является CodebleConcept, в этом случае этот элемент не только не обязателен, но и игнорируется). |
| Компоненты | Один или несколько компонентов для создания на наблюдение. | Значение True, если элемент value не используется вместо. |
| components[].codes | Одно или несколько кодов для применения к компоненту. | Неправда |
| components[].value | Значение для извлечения и представления в компоненте. Дополнительные сведения об элементах, содержащихся в components[].value элементе, см. в разделе "Типы значений". |
Значение истинно, когда используется элемент components, за исключением случаев, когда тип Observation является CodeableConcept, в этом случае этот элемент не только не обязателен, но и игнорируется. |
Типы значений
Все элементы шаблонов value CodeValueFhir содержат следующие элементы:
| Элемент | Описание | Обязательный |
|---|---|---|
| valueType | Тип значения. Это значение будет иметь значение SampledData, Quantity, CodeableConcept или String в зависимости от типа значения. | True |
| valueName | Название значения. | Значение True, если valueType не является CodeableConcept. |
Эти типы значений поддерживаются при отображении назначения FHIR в сервисе MedTech.
Выборочные данные
Представляет тип данных SampledData FHIR. Измерения наблюдения записываются в поток значений, начиная с точки во времени и постоянно увеличиваются по указанному периоду. Если значение отсутствует, E записывается в поток данных. Если период такой, что два или более значений занимают одинаковое положение в потоке данных, используется последнее значение. Эта же логика применяется при обновлении наблюдения с помощью SampledData. Для шаблона CodeValueFhir с типом значения SampledData элемент шаблона value содержит следующие элементы:
| Элемент | Описание | Обязательный |
|---|---|---|
| defaultPeriod | Используемый период по умолчанию в миллисекундах. | True |
| единица | Единица, заданная в источнике SampledData. | True |
Количество
Представляет тип данных Quantity FHIR. Этот тип создает одну точку во времени, наблюдение. Если новое значение поступает, содержащее тот же идентификатор устройства, тип измерения и метку времени, предыдущее наблюдение обновляется до нового значения. Для шаблона CodeValueFhir с типом значения Quantity элемент шаблона value содержит следующие элементы:
| Элемент | Описание | Обязательный |
|---|---|---|
| единица | Представление единицы измерения. | Неправда |
| код | Закодированная форма измерительной единицы. | Неправда |
| system | Система, определяющая закодированную форму единицы. | Неправда |
CodeableConcept
Представляет тип данных CodeableConcept FHIR. Значение в нормализованной модели данных не используется, а вместо этого при получении этого типа данных создается наблюдение с определенным кодом, представляющим, что наблюдение было записано в определенный момент времени. Для шаблона CodeValueFhir с типом значения CodeableConcept элемент шаблона value содержит следующие элементы:
| Элемент | Описание | Обязательный |
|---|---|---|
| текст | Представление обычного текста. | Неправда |
| Коды | Одно или несколько кодов для применения к созданному наблюдению. | True |
| коды[].код | Код для кодирования в элементе codes. |
True |
| codes[].system | Система для кодирования в элементе codes. |
Неправда |
| codes[].display | Отображение кода в элементе codes . |
Неправда |
String
Представляет тип данных String FHIR. Этот тип создает одну точку во времени, наблюдение. Если новое значение поступает, содержащее тот же идентификатор устройства, тип измерения и метку времени, предыдущее наблюдение обновляется до нового значения. Другие элементы не определены.
Пример
Подсказка
Вы можете использовать MedTech-сервис отладчик сопоставления для помощи при создании, обновлении и устранении неполадок в сопоставлениях устройств MedTech и назначения FHIR. Отладчик сопоставления позволяет легко просматривать и вносить встроенные корректировки в режиме реального времени, без необходимости покидать портал Azure. Отладчик сопоставления также можно использовать для загрузки тестовых сообщений устройства, чтобы увидеть, как они будут выглядеть после обработки в нормализованные сообщения и преобразования в наблюдения FHIR.
Замечание
Этот пример и нормализованное сообщение — продолжение раздела «Обзор сопоставления устройств MedTech».
В этом примере мы используем нормализованное сообщение для захвата данных heartRate.
[
{
"type": "heartrate",
"occurrenceTimeUtc": "2023-03-13T22:46:01.875Z",
"deviceId": "device01",
"properties": [
{
"name": "hr",
"value": "78"
}
]
}
]
Мы используем сопоставление маршрутов FHIR на стадии преобразования.
{
"templateType": "CollectionFhir",
"template": [
{
"templateType": "CodeValueFhir",
"template": {
"codes": [
{
"code": "8867-4",
"system": "http://loinc.org",
"display": "Heart rate"
}
],
"typeName": "heartrate",
"value": {
"system": "http://unitsofmeasure.org",
"code": "count/min",
"unit": "count/min",
"valueName": "hr",
"valueType": "Quantity"
}
}
}
]
}
Полученное наблюдение FHIR будет выглядеть следующим образом после этапа преобразования:
[
{
"code": {
"coding": [
{
"system": {
"value": "http://loinc.org"
},
"code": {
"value": "8867-4"
},
"display": {
"value": "Heart rate"
}
}
],
"text": {
"value": "heartrate"
}
},
"effective": {
"start": {
"value": "2023-03-13T22:46:01.8750000Z"
},
"end": {
"value": "2023-03-13T22:46:01.8750000Z"
}
},
"issued": {
"value": "2023-04-05T21:02:59.1650841+00:00"
},
"value": {
"value": {
"value": 78
},
"unit": {
"value": "count/min"
},
"system": {
"value": "http://unitsofmeasure.org"
},
"code": {
"value": "count/min"
}
}
}
]
Подсказка
Сведения об устранении распространенных ошибок развертывания служб MedTech см. в разделе "Устранение неполадок при развертывании службы MedTech".
Сведения об устранении ошибок службы MedTech см. в разделе "Устранение ошибок" с помощью журналов служб MedTech.
Дальнейшие действия
Обзор карты устройств сервиса MedTech
Использование шаблонов CalculatedContent с сопоставлением устройств службы MedTech
Использование шаблонов IotJsonPathContent с сопоставлением устройств службы MedTech
Как использовать пользовательские функции с картированием устройств сервиса MedTech
Обзор примеров сопоставлений на основе сценариев сервиса MedTech
Замечание
FHIR® является зарегистрированным товарным знаком HL7 и используется с разрешением HL7 .