Часто задаваемые вопросы об 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 не предоставляет прямой доступ к базовому хранилищу данных.

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

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

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

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

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

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

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

Какая версия FHIR поддерживается?

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

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

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

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

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

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

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

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

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

Точную версию FHIR, предоставленную в инструкции возможностей, можно найти в свойстве fhirVersion .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Как увидеть API Azure для 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, если вам нужна поддержка пакета транзакций.

Как получить все ресурсы для одного пациента в 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?

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

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

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

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

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

Как включить аналитику журналов для Azure API для FHIR?

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

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

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

Как уменьшить количество единиц ЕЗ, и я не могу и ЕЗ выше, чем я задал их?

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

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

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

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

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

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

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

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

Что делать, если не удается удалить ресурс FHIR из-за его состояния подготовки?

Проверьте, включена ли аварийное восстановление для ресурса FHIR. Если это так, отключите функцию аварийного восстановления.

Что делать, если я получаю код состояния HTTP 429 от службы Azure API для FHIR?

Проверьте потребление единиц запросов, связанных с экземпляром FHIR. В случае высокого потребления единиц запросов (около 100%), проверьте, соответствует ли ошибка регулирования времени высокой нагрузки на единицу запросов. Если это так, рассмотрите возможность включения автомасштабирования для службы и увеличения ЕЗ, выделенного для вашей службы. Дополнительные сведения см. в статье об автомасштабировании Azure API для FHIR .

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

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

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

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

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

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

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

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

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

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

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

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

Точную версию FHIR, предоставленную в инструкции возможностей, можно найти в свойстве fhirVersion .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

У нас есть средство с открытым исходным кодом для удаления данных FHIR. Эта же технология также интегрирована в AZURE API для FHIR в виде деидентированного экспорта.

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

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

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

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

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

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

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

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

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

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

Проверьте, включена ли аварийное восстановление для ресурса FHIR. Если это так, отключите функцию аварийного восстановления.

Проверьте потребление единиц запросов, связанных с экземпляром FHIR. В случае высокого потребления единиц запросов (около 100%), проверьте, соответствует ли ошибка регулирования времени высокой нагрузки на единицу запросов. Если это так, рассмотрите возможность включения автомасштабирования для службы и увеличения ЕЗ, выделенного для вашей службы. Дополнительные сведения см. в статье об автомасштабировании Azure API для FHIR .