Настройка параметров для $convert данных с помощью портал Azure
Примечание
Ресурсы быстрого взаимодействия в сфере здравоохранения (FHIR®) — это открытая спецификация для здравоохранения.
Из этой статьи вы узнаете, как настроить параметры для $convert-data
использования портал Azure для преобразования существующих данных о работоспособности в FHIR R4.
Шаблоны по умолчанию
Корпорация Майкрософт публикует набор стандартных примеров шаблонов Liquid из проекта FHIR Converter для поддержки преобразования данных FHIR. Эти шаблоны предоставляются только для того, чтобы приступить к работе с рабочим процессом преобразования данных. Рекомендуется настраивать и размещать собственные шаблоны, которые поддерживают ваши собственные требования к преобразованию данных. Сведения о настраиваемых шаблонах см. в разделе Настройка шаблонов.
Шаблоны по умолчанию размещаются в общедоступном реестре контейнеров и не требуют дополнительных настроек или параметров для службы FHIR.
Чтобы получить доступ к шаблонам по умолчанию для запросов на преобразование и использовать их, убедитесь, templateCollectionReference
что при вызове $convert-data
операции параметр запроса имеет соответствующее значение в зависимости от типа входных данных.
Предупреждение
Шаблоны по умолчанию выпускаются в рамках лицензии MIT и не поддерживаются служба поддержки Майкрософт.
Шаблоны по умолчанию предоставляются только для начала работы с рабочим процессом преобразования данных. Эти шаблоны по умолчанию не предназначены для рабочей среды и могут измениться, когда корпорация Майкрософт выпускает обновления для службы FHIR. Чтобы обеспечить согласованное поведение преобразования данных в разных версиях службы FHIR, необходимо выполнить следующие действия.
- Разместите собственную копию шаблонов в экземпляре Реестр контейнеров Azure (ACR).
- Зарегистрируйте шаблоны в службе FHIR.
- Используйте зарегистрированные шаблоны в вызовах API.
- Убедитесь, что поведение преобразования соответствует вашим требованиям.
Дополнительные сведения о размещении собственных шаблонов см. в разделе Размещение собственных шаблонов.
Настройка шаблонов
Вы можете использовать расширение FHIR Converter Visual Studio Code для настройки шаблонов в соответствии с конкретными требованиями. Расширение предоставляет интерактивный интерфейс редактирования и упрощает скачивание опубликованных корпорацией Майкрософт шаблонов и примеров данных.
Примечание
Расширение конвертера FHIR для Visual Studio Code доступно для шаблонов HL7v2, C-CDA и JSON Liquid. Шаблоны FHIR STU3 – FHIR R4 Liquid в настоящее время не поддерживаются.
При необходимости предоставленные шаблоны по умолчанию можно использовать в качестве базовой отправной точки, поверх которой можно добавить настройки. При обновлении шаблонов рекомендуется следовать этим рекомендациям, чтобы избежать непреднамеренных результатов преобразования. Шаблон должен быть создан таким образом, чтобы он давал допустимую структуру для ресурса пакета FHIR.
Например, шаблоны Liquid должны иметь такой формат, как следующий код:
<liquid assignment line 1 >
<liquid assignment line 2 >
.
.
<liquid assignment line n >
{
"resourceType": "Bundle",
"type": "xxx",
<...liquid code...>
"identifier":
{
"value":"xxxxx",
},
"id":"xxxx",
"entry": [
<...liquid code...>
]
}
Общий шаблон соответствует структуре и ожиданиям для ресурса пакета FHIR, а JSON пакета FHIR — в корне файла. Если вы решили добавить в шаблон настраиваемые поля, которые не являются частью спецификации FHIR для ресурса пакета, запрос на преобразование все равно может завершиться успешно. Однако преобразованный результат потенциально может иметь непредвиденные выходные данные и не даст допустимый ресурс пакета FHIR, который можно сохранить в службе FHIR как есть.
Рассмотрим следующий пример кода:
<liquid assignment line 1 >
<liquid assignment line 2 >
.
.
<liquid assignment line n >
{
“customfield_message”: “I will have a message here”,
“customfield_data”: {
"resourceType": "Bundle",
"type": "xxx",
<...liquid code...>
"identifier":
{
"value":"xxxxx",
},
"id":"xxxx",
"entry": [
<...liquid code...>
]
}
}
В примере кода два примера настраиваемых полей customfield_message
, customfield_data
которые не являются свойствами FHIR в соответствии со спецификацией и ресурсом пакета FHIR, по-видимому, вложены в customfield_data
(то есть JSON пакета FHIR не находится в корне файла). Этот шаблон не соответствует ожидаемой структуре ресурса пакета FHIR. В результате запрос на преобразование может завершиться успешно с использованием предоставленного шаблона. Однако возвращаемый преобразованный результат потенциально может иметь непредвиденные выходные данные (из-за пропуска определенных этапов обработки после преобразования). Он не будет считаться допустимым пакетом FHIR (так как он является вложенным и имеет свойства спецификации, отличные от FHIR), и попытка сохранить результат в службе FHIR завершается сбоем.
Размещение собственных шаблонов
Рекомендуется разместить собственную копию шаблонов в экземпляре Реестр контейнеров Azure (ACR). ACR можно использовать для размещения пользовательских шаблонов и поддержки управления версиями.
Размещение собственных шаблонов и их использование для $convert-data
операций включает в себя следующие семь шагов:
- создадите экземпляр реестра контейнеров Azure;
- Отправка шаблонов в экземпляр Реестр контейнеров Azure
- Включение управляемого удостоверения Azure в экземпляре службы FHIR
- Предоставление Реестр контейнеров Azure доступа к управляемому удостоверению службы FHIR
- Регистрация сервера Реестр контейнеров Azure в службе FHIR
- Настройка брандмауэра Реестр контейнеров Azure для безопасного доступа
- Проверка операции $convert-data
Шаг 1. Создание экземпляра Реестр контейнеров Azure
Ознакомьтесь с разделом Общие сведения о реестрах контейнеров в Azure и следуйте инструкциям по созданию собственного экземпляра ACR. Рекомендуется поместить экземпляр ACR в ту же группу ресурсов, что и служба FHIR.
Шаг 2. Отправка шаблонов в экземпляр Реестр контейнеров Azure
После создания экземпляра ACR можно использовать команду FHIR Converter: Push Templates в расширении FHIR Converter для отправки пользовательских шаблонов в экземпляр ACR. Кроме того, для этой цели можно использовать средство командной строки для управления шаблонами.
Для поддержки различных версий пользовательских шаблонов в Реестр контейнеров Azure можно отправить образ, содержащий пользовательские шаблоны, в экземпляр ACR с разными тегами изображений.
- Дополнительные сведения о реестрах, репозиториях и артефактах ACR см. в разделе Сведения о реестрах, репозиториях и артефактах.
- Дополнительные сведения о рекомендациях по использованию тегов образов см. в статье Рекомендации по добавлению тегов и управлению версиями образов контейнеров.
Чтобы ссылаться на конкретные версии шаблонов в API, используйте точное имя образа и тег, содержащий шаблон с управлением версиями, который будет использоваться. Для параметра templateCollectionReference
API используйте соответствующее имя изображения и тег (например, <RegistryServer>/<imageName>:<imageTag>
).
Шаг 3. Включение управляемого удостоверения Azure в экземпляре службы FHIR
Перейдите к экземпляру службы FHIR в портал Azure и выберите параметр Удостоверение.
Измените состояние на Включено и нажмите кнопку Сохранить , чтобы включить управляемое системой удостоверение в службе FHIR.
Шаг 4. Предоставление Реестр контейнеров Azure доступа к управляемому удостоверению службы FHIR
В группе ресурсов перейдите к экземпляру Реестра контейнеров и перейдите на вкладку Управление доступом (IAM).
Выберите Добавить>Добавить назначение ролей. Если параметр Добавить назначение ролей недоступен, попросите администратора Azure предоставить вам разрешения на выполнение этой задачи.
На панели Роль выберите роль AcrPull .
На вкладке Участники выберите Управляемое удостоверение и нажмите Выбрать участников.
Выберите подписку Azure.
Выберите Управляемое удостоверение, назначаемое системой, а затем выберите службу FHIR, с которым вы работаете.
Чтобы назначить роль, на вкладке Проверка и назначение выберите Проверка и назначение.
Дополнительные сведения о назначении ролей в портал Azure см. в статье Встроенные роли Azure.
Шаг 5. Регистрация сервера Реестр контейнеров Azure в службе FHIR
Сервер ACR можно зарегистрировать с помощью портал Azure.
Использование портала Azure
В экземпляре службы FHIR в разделе Передача и преобразование данных выберите Артефакты. Отобразится список зарегистрированных Реестр контейнеров Azure серверов.
Нажмите кнопку Добавить , а затем в раскрывающемся списке выберите сервер реестра.
Щелкните Сохранить.
В службе FHIR можно зарегистрировать до 20 серверов ACR.
Примечание
Регистрация вступит в силу через несколько минут.
Шаг 6. Настройка брандмауэра Реестр контейнеров Azure для безопасного доступа
Существует множество методов защиты ACR с помощью встроенного брандмауэра в зависимости от конкретного варианта использования.
- Частное подключение к реестру контейнеров Azure с помощью Приватного канала Azure
- Настройка сетевых правил для общедоступных IP-адресов
- Реестр контейнеров Azure защиты от кражи данных с помощью выделенных конечных точек данных
- Ограничение доступа к реестру контейнеров с использованием конечной точки службы в виртуальной сети Azure
- Обеспечение безопасного доступа доверенных служб к реестру контейнеров с сетевыми ограничениями
- Настройка правил для доступа к Реестру контейнеров Azure за брандмауэром
- Диапазоны IP-адресов и теги служб Azure — общедоступное облако
Примечание
Служба FHIR зарегистрирована в качестве доверенной службы Майкрософт с Реестр контейнеров Azure.
Шаг 7. Проверка операции $convert данных
Вызовите операцию, $convert-data
указав ссылку на шаблон в параметре templateCollectionReference
:
<RegistryServer>/<imageName>@<imageDigest>
Вы должны получить bundle
ответ, содержащий данные о работоспособности, преобразованные в формат FHIR.
Дальнейшие действия
Из этой статьи вы узнали, как настроить параметры для , $convert-data
чтобы начать преобразование различных форматов данных о работоспособности в формат FHIR.
Общие сведения о см. в $convert-data
разделе
Сведения об устранении неполадок $convert-data
см. в разделе
Чтобы узнать о часто задаваемых вопросах по $convert-data
, см. раздел
FHIR® является зарегистрированным товарным знаком Health Level Seven International, зарегистрированным в Управлении по товарным знакам США и используемым с их разрешения.