Часто задаваемые вопросы об Azure API для FHIR

Azure API для FHIR: основные сведения

Что такое FHIR?

Ресурсы быстрого взаимодействия в сфере здравоохранения (FHIR) — это стандарт взаимодействия, предназначенный для обмена медицинскими данными между различными системами в сфере здравоохранения. Этот стандарт был разработан организацией HL7 и принимается медицинскими организациями по всему миру. Самая последняя версия FHIR — R4 (выпуск 4). Api Azure для FHIR поддерживает R4 и предыдущую версию STU3 (стандартная для пробной версии 3). Дополнительные сведения о FHIR см. в HL7.org.

Хранятся ли данные, стоящие за API FHIR, в Azure?

Да, данные хранятся в управляемых базах данных в Azure. Api Azure для FHIR не предоставляет прямой доступ к базовому хранилищу данных.

Как получить доступ к базовым данным?

В управляемой службе вы не можете получить доступ к базовым данным. Это гарантирует, что API Azure для FHIR предлагает сертификаты конфиденциальности и соответствия требованиям, необходимые для медицинских данных. Если вам нужен доступ к базовым данным, можно использовать сервер FHIR с открытым кодом.

Какой поставщик удостоверений поддерживается?

Мы поддерживаем Microsoft Azure Active Directory в качестве поставщика удостоверений.

Можно ли использовать Azure AD B2C с API Azure для FHIR?

Нет, мы не поддерживаем B2C в API Azure для FHIR. Если вам нужны более детализированные элементы управления доступом, рекомендуется обратиться к прокси-серверу FHIR с открытым кодом.

Какова политика резервного копирования и восстановления для API Azure для FHIR?

Данные для управляемой службы автоматически создаются каждые 4 часа, и сохраняются две резервные копии. Таким образом, срок хранения составляет 8 часов. Восстановление данных выполняется группой поддержки, а целевая точка восстановления (RPO) составляет менее 240 минут.

Клиенты могут отправить запрос на восстановление данных или изменить политику резервного копирования данных по умолчанию с помощью запроса в службу поддержки.

Какую версию FHIR вы поддерживаете?

Мы поддерживаем версии 4.0.0 и 3.0.1. Дополнительные сведения см. в разделе Поддерживаемые функции FHIR. Вы также можете прочитать о том, что изменилось между версиями FHIR (STU3 на R4) в журнале версий для HL7 FHIR.

Azure IoT Connector для FHIR (предварительная версия) в настоящее время поддерживает только FHIR версии R4 и отображается в экземплярах R4 Azure API для FHIR.

В чем разница между службами azure Health Data Services и Azure API для FHIR?

Azure API для FHIR — это общедоступная управляемая служба FHIR. Службы azure Health Data Services позволяют развертывать службу FHIR и службу DICOM в одной рабочей области. Дополнительные сведения см. в обзоре служб Azure Health Data Services.

В чем разница между Сервером Microsoft FHIR для Azure и Azure API для FHIR?

Azure API для FHIR — это размещенная и управляемая версия сервера Microsoft FHIR с открытым кодом для Azure. В управляемой службе корпорация Майкрософт предоставляет все услуги по обслуживанию и обновлениям.

При запуске сервера FHIR для Azure у вас есть прямой доступ к базовым службам, но мы отвечаем за обслуживание и обновление сервера, а также все необходимые действия по обеспечению соответствия требованиям, если вы храните данные PHI.

В каких регионах доступен API Azure для FHIR?

У нас есть общая доступность как для государственных, так и для государственных организаций в нескольких географических регионах. Сведения об облачных службах майкрософт для государственных организаций см. в статье Службы Azure от FedRAMP.

Где можно просмотреть выпуски в Azure API для FHIR?

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

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

Чтобы узнать, какой пакет выпуска в настоящее время находится в управляемой службе, можно просмотреть инструкцию о возможностях для Azure API для FHIR в свойстве software.version . Вы увидите, какой пакет развернут.

Где можно найти версию FHIR (R4 или STU3) в моей базе данных?

Точную версию FHIR можно найти в операторе capability в свойстве fhirVersion .

Можно ли переключить azure API для FHIR с STU3 на R4?

Нет. У нас нет способа изменить версию существующей базы данных. Вам потребуется создать api Azure для FHIR и перезагрузить данные. Вы можете использовать преобразователь JSON в FHIR , чтобы начать с преобразования данных STU3 в R4.

Можно ли настроить URL-адрес для API Azure для FHIR?

Нет. Вы не можете изменить URL-адрес azure API для FHIR.

Реализации и спецификации FHIR

Что такое SMART на FHIR?

SMART (substitutable Medical Applications and Reusable Technology) on FHIR — это набор открытых спецификаций для интеграции партнерских приложений с серверами FHIR и другими ит-системами здравоохранения, такими как электронные медицинские записи и обмен медицинской информацией. Создавая приложение SMART on FHIR, вы можете обеспечить доступ к приложению и его использование множеством различных систем. Дополнительные сведения о SMART см. на веб-сайте SMART Health IT .

Поддерживает ли API Azure для FHIR SMART on FHIR?

Да, функция SMART on FHIR поддерживается с помощью примеров AHDS. Это называется SMART on FHIR (Enhanced). Smart on FHIR(Enhanced) можно рассматривать как удовлетворяющие требованиям руководство по реализации SMART on FHIR (версия 1.0.0) и §170.315(g)(10) Стандартизованный API для критериев обслуживания пациентов и населения. Дополнительные сведения см. в документации по SMART on FHIR(Enhanced).

Можно ли создать пользовательский ресурс FHIR?

Мы не разрешаем настраиваемые ресурсы FHIR. Если вам нужен пользовательский ресурс FHIR, можно создать пользовательский ресурс поверх базового ресурса с расширениями.

Поддерживаются ли расширения в Api Azure для FHIR?

Мы разрешаем загружать на сервер любые допустимые данные JSON FHIR. Если вы хотите сохранить определение структуры, определяющее расширение, его можно сохранить как ресурс определения структуры. Для поиска расширений необходимо определить собственные параметры поиска.

Каково ограничение на размер ресурса, который можно отправить?

Объем ресурса должен быть чуть меньше 2 МБ. Это ограничение базового хранилища данных, и мы не можем увеличить это значение.

Разделы справки см. раздел Azure API для FHIR в XML?

В управляемой службе поддерживается только JSON. Сервер FHIR с открытым кодом поддерживает JSON и XML. Чтобы просмотреть версию XML в открытом коде, используйте ._format= application/fhir+xml

Каково ограничение на _count?

Текущее ограничение для _count составляет 1000. Если _count больше 1000, в пакете появится предупреждение о том, что будет отображаться только 1000 записей.

Существуют ли какие-либо ограничения на функцию экспорта групп?

Для экспорта групп мы экспортируем только включенные ссылки из группы, но не все характеристики ресурса группы.

Можно ли опубликовать пакет в Azure API для FHIR?

В настоящее время мы поддерживаем пакетные пакеты для отправки, но не поддерживаем отправку пакетов транзакций в Azure API для FHIR. Вы можете использовать службу FHIR в службах azure Health Data Services, если вам нужна поддержка пакета транзакций.

Как получить все ресурсы для одного пациента в Azure API для FHIR?

Вы можете использовать операцию $everything пациентов или функцию поиска секций в Azure API для FHIR. Это позволяет получить все ресурсы, связанные с конкретным пациентом. Обратите внимание, что отделение пациентов включает в себя все ресурсы, связанные с пациентом, но не сам пациент, поэтому вам также потребуется выполнить поиск, чтобы получить пациента, если вам нужен ресурс пациента в ваших результатах.

Какова сортировка по умолчанию при поиске ресурсов в Azure API для FHIR?

Поддерживается сортировка по дате последнего обновления: _sort=_lastUpdated. Мы также поддерживаем _sort для элементов FirstName, LastName, BirthDate и ClinicalDate. Дополнительные сведения о других поддерживаемых параметрах поиска см. в статье Обзор поиска FHIR.

Поддерживает ли API Azure для FHIR $everything?

Да, у нас есть поддержка $everything пациентов. Дополнительные сведения см. в руководстве по $Everything пациентов.

Поддерживает ли API Azure для FHIR какие-либо терминологические операции?

Нет, Azure API для FHIR сегодня не поддерживает операции с терминологией.

Как работает $export?

$export является частью спецификации FHIR. Если служба FHIR настроена с управляемым удостоверением и учетной записью хранения, а управляемое удостоверение имеет доступ к этой учетной записи хранения, можно вызвать $export в API FHIR, и все ресурсы FHIR будут экспортированы в учетную запись хранения. Дополнительные сведения см. в статье $export.

Существует ли готовое решение для деидентифицирования данных EHR?

У нас есть средство с открытым кодом для деидентифицировать данные FHIR. Эта же технология также интегрирована в Azure API для FHIR в виде экспорта без идентификации .

Доступен ли деидентифицированный экспорт на уровне пациента и группы?

Анонимный экспорт в настоящее время поддерживается только при полном экспорте системы (/$export), но не для экспорта пациентов (/Пациент/$export). Мы работаем над тем, чтобы сделать его доступным и на уровне пациентов.

Каковы различия между типами удаления в Azure API для FHIR?

В Azure API для FHIR поддерживаются два основных типа удаления. Это удаление и условное удаление.

  • С помощью команды Удалить можно выполнить обратимое удаление (наиболее распространенный тип) и по-прежнему иметь возможность восстановить исторические версии записи.
  • С помощью условного удаления можно передать условия поиска, чтобы удалить ресурс по одному элементу за раз или по нескольким одновременно.
  • Если вы передали hardDelete параметр Delete или Conditional Delete, все записи и журнал будут удалены и невосстановимы.

Разделы справки восстановить удаленные записи в Azure API для FHIR?

Вы можете восстановить удаленные файлы, если не используете hardDelete параметр . Записи в Azure API для FHIR должны по-прежнему существовать. Записи можно найти, выполнив поиск в журнале ресурса и выполнив поиск последней версии с данными.

Использование API Azure для FHIR

Разделы справки включить Log Analytics для Azure API для FHIR?

Дополнительные сведения о включении журналов аудита и примеров запросов см. в статье Включение ведения журнала диагностики в Azure API для FHIR. Если вы хотите включить дополнительные сведения в журналы, см. статью Использование пользовательских заголовков HTTP.

Я получаю 429s при загрузке и обновлении данных. Как устранить эту проблему?

Чтобы устранить эту проблему, можно увеличить пропускную способность или переключиться на автомасштабирование , чтобы обеспечить достаточное количество вычислительных ресурсов для обработки запросов. Если у вас по-прежнему возникают проблемы, отправьте запрос в службу поддержки.

Разделы справки ниже мои ЕЗ, и я не могу и ЕЗ выше, чем я их установил?

Минимальное значение ЕЗ должно быть не менее 40 ЕЗ на ГБ. При загрузке данных ЕЗ в базе данных увеличивается, если вы будете ниже этого минимального значения.

Где можно просмотреть некоторые примеры использования API Azure для FHIR в рабочем процессе?

У нас есть коллекция эталонных архитектур, доступных на странице GitHub "Архитектура работоспособности".

Функции и службы Azure API для FHIR

Можно ли выполнять проверки работоспособности службы FHIR?

Чтобы выполнить проверка работоспособности в службе FHIR, введите {{fhirurl}}/health/check в запросе GET. Вы увидите состояние службы FHIR. Ответ кода состояния HTTP с кодом 200 и Значением OverallStatus в качестве "Работоспособен" означает, что проверка работоспособности выполнен успешно. В случае ошибок вы получите ответ с кодом состояния HTTP 404 (Не найдено) или кодом состояния 500 (внутренняя ошибка сервера) и подробные сведения в тексте ответа в некоторых сценариях.

Есть ли способ зашифровать данные с помощью личного ключа, а не ключа по умолчанию?

Да, API Azure для FHIR позволяет настраивать ключи, управляемые клиентом, используя поддержку из Azure Cosmos DB. Дополнительные сведения о шифровании данных с помощью личного ключа см. в статье Настройка ключей, управляемых клиентом, в REST.