Преобразование данных в формат FHIR для Azure API FHIR

Пользовательская $convert-data конечная точка в службе FHIR® предназначена для преобразования данных из разных типов данных в FHIR. Он использует подсистему шаблонов Liquid и шаблоны из проекта преобразователя FHIR в качестве шаблонов по умолчанию. Эти шаблоны преобразования можно настроить по мере необходимости.

$convert-data В настоящее время пользовательская конечная точка поддерживает четыре типа преобразования данных:

Использование endpoint $convert-data

Операция $convert-data интегрирована в службу FHIR и выполняется как часть этой службы. После включения $convert-data на сервере можно вызывать API для преобразования данных в FHIR с помощью https://<<FHIR service base URL>>/$convert-data.

Ресурс параметров

$convert-data принимает ресурс параметра Parameter в теле запроса, как описано в следующей таблице. В тексте запроса вызова API можно включить следующие параметры:

Пример запроса

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "inputData",
            "valueString": "MSH|^~\\&|SIMHOSP|SFAC|RAPP|RFAC|20200508131015||ADT^A01|517|T|2.3|||AL||44|ASCII\nEVN|A01|20200508131015|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|\nPID|1|3735064194^^^SIMULATOR MRN^MRN|3735064194^^^SIMULATOR MRN^MRN~2021051528^^^NHSNBR^NHSNMBR||Kinmonth^Joanna^Chelsea^^Ms^^D||19870624000000|F|||89 Transaction House^Handmaiden Street^Wembley^^FV75 4GJ^GBR^HOME||020 3614 5541^PRN|||||||||C^White - Other^^^||||||||\nPD1|||FAMILY PRACTICE^^12345|\nPV1|1|I|OtherWard^MainRoom^Bed 183^Simulated Hospital^^BED^Main Building^4|28b|||C005^Whittingham^Sylvia^^^Dr^^^DRNBR^D^^^ORGDR|||CAR|||||||||16094728916771313876^^^^visitid||||||||||||||||||||||ARRIVED|||20200508131015||"
        },
        {
            "name": "inputDataType",
            "valueString": "Hl7v2"
        },
        {
            "name": "templateCollectionReference",
            "valueString": "microsofthealth/fhirconverter:default"
        },
        {
            "name": "rootTemplate",
            "valueString": "ADT_A01"
        }
    ]
}

Пример ответа

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:9d697ec3-48c3-3e17-db6a-29a1765e22c6",
      "resource": {
        "resourceType": "Patient",
        "id": "9d697ec3-48c3-3e17-db6a-29a1765e22c6",
        ...
        ...
      "request": {
        "method": "PUT",
        "url": "Location/50becdb5-ff56-56c6-40a1-6d554dca80f0"
      }
    }
  ]
}

Настройка шаблонов

Расширение конвертера FHIR для Visual Studio Code можно использовать для настройки шаблонов в соответствии с вашими потребностями. Расширение предоставляет интерактивный интерфейс редактирования и упрощает скачивание опубликованных корпорацией Майкрософт шаблонов и примеров данных. Дополнительные сведения см. в документации в расширении.

Размещение и использование шаблонов

Рекомендуется разместить собственную копию шаблонов в ACR. Существует четыре этапа, участвующих в размещении собственной копии шаблонов и использовании этих шаблонов в $convert-data операции:

1. Отправьте шаблоны в реестр контейнеров Azure.
2. Включите управляемую идентичность в вашем экземпляре Azure API для FHIR.
3. Предоставьте доступ aCR к Управляемому удостоверению Azure API для FHIR.
4. Зарегистрируйте серверы ACR в API Azure для FHIR.
5. При необходимости настройте брандмауэр ACR для безопасного доступа.

Отправка шаблонов в реестр контейнеров Azure

После создания экземпляра ACR можно использовать команду FHIR Converter: Push Templates в расширении преобразователя FHIR , чтобы отправить настраиваемые шаблоны в ACR. Кроме того, можно использовать средство командной строки управления шаблонами.

Активировать управляемое удостоверение на Azure API для FHIR

Перейдите к экземпляру службы Azure API для FHIR на портале Azure и выберите вкладку «Удостоверение». Измените статус на On, чтобы включить управляемое удостоверение в Azure API для FHIR.

Предоставление доступа ACR к Azure API для FHIR

1. Перейдите к панели управления доступом (IAM).

2. Нажмите кнопку "Добавить", а затем выберите "Добавить назначение роли ", чтобы открыть страницу "Добавить назначение ролей".

3. Назначьте роль AcrPull .

   

Дополнительные сведения о назначении ролей на портале Azure см. в статье о встроенных ролях Azure.

Регистрация серверов ACR в Azure API для FHIR

Вы можете зарегистрировать сервер ACR на портале Azure или с помощью ИНТЕРФЕЙСА командной строки.

Регистрация сервера ACR с помощью портала Azure

Перейдите на вкладку «Артефакты» в разделе «Преобразование данных» в экземпляре Azure API для FHIR. Вы увидите список зарегистрированных серверов ACR. Выберите "Добавить" и выберите сервер реестра в раскрывающемся меню. Необходимо выбрать Сохранить, чтобы регистрация вступила в силу. Может потребоваться несколько минут, чтобы применить изменение и перезапустить экземпляр.

Регистрация сервера ACR с помощью CLI

Вы можете зарегистрировать до 20 серверов ACR в AZURE API для FHIR.

Установите azure Health Data Services CLI из Azure PowerShell при необходимости:

az extension add -n healthcareapis

Зарегистрируйте серверы acr в Azure API для FHIR, выполнив следующие примеры:

Регистрация одного сервера ACR

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Регистрация нескольких серверов ACR

az healthcareapis acr add --login-servers "fhiracr2021.azurecr.io fhiracr2020.azurecr.io" --resource-group fhir-test --resource-name fhirtest2021

Настройка брандмауэра ACR

Выберите Сетевые настройки для учетной записи хранения в Azure на портале.

Выберите Выбранные сети.

В разделе "Брандмауэр" укажите IP-адрес в поле диапазона адресов . Добавьте диапазоны IP-адресов, чтобы разрешить доступ из Интернета или локальных сетей.

В следующей таблице вы найдете IP-адрес для региона Azure, где подготовлена служба Azure API для FHIR.

Проверить

Вызовите API, указывая ссылку на шаблон $convert-data в параметре templateCollectionReference.

<RegistryServer>/<imageName>@<imageDigest>

Дальнейшие шаги

В этой статье вы познакомились с процессом преобразования данных для Azure API для FHIR. Дополнительные сведения о связанных проектах GitHub для Azure API для FHIR см.