Заметки о выпуске до 2025 г. Azure API для FHIR
Внимание
Поддержка Azure API для FHIR будет прекращена 30 сентября 2026 г. Следуйте стратегиям миграции, чтобы перейти в службу FHIR® служб azure Health Data Services к этой дате. Из-за прекращения поддержки Azure API для FHIR с 1 апреля 2025 г. новые развертывания будут невозможны. Служба FHIR служб работоспособности Azure — это развивающаяся версия Azure API для FHIR, которая позволяет клиентам управлять службами FHIR, DICOM и MedTech с интеграцией с другими службами Azure.
Azure API для FHIR® обеспечивает полностью управляемое развертывание сервера Microsoft FHIR для Azure. Сервер является реализацией стандарта FHIR . В этом документе содержатся сведения о функциях и улучшениях, внесенных в API Azure для FHIR.
Ноябрь 2024 г.
Служба FHIR
Исправления ошибок
- Улучшение проверки экспорта: обнаружена проблема, из-за которой экспорт продолжался, несмотря на недопустимые параметры поиска. Новое изменение реализуется для предотвращения экспорта в этих условиях. Это поведение принимается по умолчанию. Клиенты могут переопределить его с помощью ленивого флага. Это изменение было передано клиентам в прошлом месяце.
- Повышение производительности пакета. Процесс обновления профиля во время выполнения пакета был упрощен. Если пакет содержит изменения
ValueSetв ,StructureDefinitionи /илиCodeSystem, обновление профиля не будет выполняться до завершения пакета. Это изменение повышает производительность пакетов, уменьшая задержки, вызванные несколькими обновлениями при обработке изменений в этих типах ресурсов. - Синтаксический анализ заголовка типа контента: устранена проблема, связанная с анализом
application/x-www-form-urlencodedзаголовка типа контента. - Усовершенствования переиндексации операция повторной индексации была улучшена путем удаления искусственного ограничения, которое ранее ограничивало обработку больших исторических наборов данных или случаев, когда клиенты запрашивали ограниченный размер запроса. Кроме того, процесс переиндексации неправильно сообщает о завершении при обработке множества последовательных исторических или удаленных ресурсов с размером запроса по умолчанию. Эта проблема устранена, чтобы убедиться, что процесс переиндексирования выполняется правильно и сообщает о соответствующем состоянии.
Октябрь 2024 г.
Служба FHIR
Исправления ошибок
- Проверка экспорта: обнаружена проблема, из-за которой экспорт продолжался, несмотря на недопустимые параметры поиска. Мы вводим изменения, которые препятствуют экспорту в этих условиях. Эта функция в настоящее время находится за строгим флагом проверки и станет поведением по умолчанию в течение или после 30 октября.
- Включение параметров поиска: устранена проблема, из-за которой дополнительные параметры поиска (например,
_include,_has) не возвращали все ожидаемые результаты, иногда пропуская следующую ссылку. - Экспорт выполнения задания: редкий случай
System.ObjectDisposedExceptionзавершения задания экспорта устранен путем предотвращения преждевременного выхода. - Обновление кода состояния HTTP: код состояния HTTP для недопустимых параметров во время
$reindexсоздания задания теперь обновляется до 400, обеспечивая лучшую обработку ошибок. - Очистка параметров поиска. Исправление реализовано, чтобы обеспечить полную очистку параметров поиска в базе данных при активации с помощью вызовов API удаления, устраняя проблемы, связанные с неполными удалениями.
Август 2024 г.
Служба FHIR
Исправление ошибок Устранено исправление ошибки, которое было реализовано для решения проблем с большими экспортами неправильно, отображая состояние "завершено" в то время как дочерние задачи по-прежнему обрабатываются. Решение включает задержку для устранения этих ошибок состояния, повышая надежность экспорта.
Июль 2024 г.
Служба FHIR
Исправления ошибок
Исправлено. Экспорт данных в виде смарт-пользователей, экспортируемых в качестве смарт-пользователя , больше не требует областей записи. Ранее необходимо предоставить пользователю SMART права на запись для экспорта данных, что подразумевало более высокие уровни привилегий. Чтобы инициировать задание экспорта в качестве смарт-пользователя, убедитесь, что пользователь является членом роли экспорта FHIR в RBAC и запрашивает "чтение" клинической области SMART.
Исправлено: обновление кода состояния от HTTP 500 до HTTP 400 во время операции исправления, если полезные данные запрашивали обновление для типа ресурса, отличного от параметра, изначально возникла внутренняя ошибка сервера (HTTP 500). Это было обновлено, чтобы создать ошибку HTTP 400.
Май 2024 г.
Служба FHIR
Усовершенствования операции очистки журнала Операция очистки позволяет выполнить частичное удаление с помощью параметра запроса allowPartialSuccess. По умолчанию операция очистки журнала ожидает успешного завершения перед удалением ресурсов. Однако если во время выполнения возникает ошибка, удаление ресурсов откатится. С помощью параметра запроса allowPartialSuccess можно предотвратить откат транзакции в случае ошибки.
Исправления ошибок
- Исправлено: код состояния HTTP для длительных запросов. Запросы FHIR, которые занимают более 100 секунд для выполнения, возвращают код состояния HTTP 408 вместо HTTP 500.
- Исправлено: запрос журнала в пакете. До исправления запрос журнала в пакете вернул код состояния HTTP 404.
Март 2024 г.
Пакеты пакетной параллелизации пакетной службы выполняются последовательно в службе FHIR по умолчанию. Чтобы повысить пропускную способность с помощью вызовов пакетов, мы включили параллельную обработку пакетных пакетов.
Подробнее:
Исправления ошибок
- Исправлено. Повышение производительности обработки пакетов. Обновления вносятся в метод выполнения задачи, что приводит к улучшению производительности обработки пакета. См. статью PR#3727.
Февраль 2024 г.
Позволяет подсчитывать все версии (исторические и обратимо удаленные) ресурсов Параметр запроса _summary=count и _count=0 можно добавить в конечную точку _history, чтобы получить количество всех версий ресурсов. Это число включает обратимые удаленные ресурсы. Дополнительные сведения см. в разделе "Управление журналами".
Повышение пропускной способности для операции экспорта Параметр запроса "_isparallel" можно добавить в операцию экспорта, чтобы повысить пропускную способность. Важно отметить, что использование этого параметра может привести к увеличению потребления единиц запросов за время экспорта. Дополнительные сведения см. в разделе "Экспорт параметров запроса операции".
Примечание.
Существует известная проблема с операцией $export, которая может привести к неполному экспорту с успехом состояния. Проблема возникает при использовании флага is_parallel. Задания экспорта, выполняемые с параметром запроса _isparallel начиная с 13 февраля 2024 г., влияют на эту проблему.
Измените номер имени для экспортированного имени файла и учетной записи хранения по умолчанию с помощью этого изменения экспортированные имена файлов следуют формату "{FHIR Resource Name}-{Number}-{Number}.ndjson". Порядок файлов не гарантируется в соответствии с порядком ресурсов в базе данных. Имя учетной записи хранения по умолчанию обновляется до "Export-{Number}". Нет изменений в количестве ресурсов, добавленных в отдельные экспортированные файлы.
Оптимизация параллелизма повышения производительности для запросов FHIR может быть включена с помощью заголовка HTTP "x-ms-query-latency-over-efficiency". Это значение должно иметь значение true, чтобы обеспечить максимальную параллельность во время выполнения запроса. Дополнительные сведения см. в разделе "Пакетные пакеты".
Январь 2024 г.
Параллельное выполнение запросов с условным взаимодействием условных взаимодействий может быть сложным и трудоемким. Чтобы повысить задержку запросов, связанных с условным взаимодействием, можно использовать заголовок запроса x-условнойquery-processing-logic. Дополнительные сведения см. в разделе "Рекомендации по производительности" для взаимодействия с условным API.
Декабрь 2023 г.
Дополнительные возможности, добавленные в операцию экспорта $export теперь поддерживают экспорт версий ресурсов и обратимо удаленных ресурсов. Дополнительные сведения см. в разделе "Экспорт параметров запроса".
Ноябрь 2023 г.
Возможность массового удаления теперь доступна в предварительной версии "$bulk-delete" позволяет асинхронно удалять ресурсы с сервера FHIR. Операция массового удаления может выполняться на уровне системы или для отдельного типа ресурса. Дополнительные сведения см. в статье об операции массового удаления.
Операция массового удаления в настоящее время находится в общедоступной предварительной версии. Дополнительные сведения см. в разделе "Отказ от ответственности". [! Отказ от предоставления общедоступной предварительной версии INCLUDE]
Исправление ошибок: запросы FHIR с помощью разбиения на страницы и повторного включения привели к ошибке при использовании следующей ссылки
Теперь устранена проблема и запросы FHIR с использованием маркера продолжения с включением или повторной обработкой, больше не сообщайте об исключении. Дополнительные сведения об исправлении см . в #3525.
Июнь 2023 г.
Исправление ошибки. URL-адрес конечной точки метаданных в инструкции возможностей является относительным URL-адресом для спецификации FHIR, URL-адрес конечной точки метаданных в инструкции возможностей должен быть абсолютным URL-адресом. Дополнительные сведения о спецификации FHIR см . в инструкции о возможности. Этот фанатик решает проблему, чтобы получить подробные сведения о посещении 3265.
Май 2023 г.
SMART on FHIR: фиксированное сопоставление клинических областей для приложений
Эта ошибка устраняет проблему с клинической областью, не интерпретируемой правильно для внутренних приложений. Дополнительные сведения см . в #3250
Апрель 2023 г.
Исправлены временные проблемы, связанные с загрузкой пользовательских параметров поиска. Эта ошибка устраняет проблему, когда служба FHIR не загружает последнее состояние SearchParameter в случае сбоя. Дополнительные сведения см . в #3222
Ноябрь 2022 г.
Исправлена ошибка, созданная при обновлении ресурса с помощью заголовка if-match и PATCH
Исправлена ошибка, и ресурс будет обновлен, если он соответствует заголовку Etag. Дополнительные сведения см. в разделе #2877|.
Май 2022 г.
Повышение
| Улучшение | Дополнительные сведения |
|---|---|
| Azure API для FHIR не создает новую версию ресурса, если содержимое ресурса не изменилось. | Если пользователь обновляет существующий ресурс и только meta.versionId или meta.lastUpdated, мы возвращаем ОК с существующими сведениями о ресурсах без обновления VersionId и lastUpdated. Дополнительные сведения см. в разделе #2519. |
Апрель 2022 г.
Усовершенствования
| Усовершенствования | Дополнительные сведения |
|---|---|
| Исправление FHIRPath | Исправление FHIRPath было добавлено в качестве функции как в API Azure для FHIR. Это реализует исправление FHIRPath, как определено на веб-сайте HL7 . |
| Перемещение уведомления о пакете в Core | При вводе пространства имен Resource.Bundle в Core необходимо сделать более явными ссылки на ресурс в файл строковых ресурсов. Дополнительные сведения см. в разделе PR #2478. |
| Обрабатывает недопустимый заголовок в обновлении версии | Если для политики управления версиями задано значение versioned-update, необходимо, чтобы последняя версия ресурса была предоставлена в заголовке запроса if-match в обновлении. Указанная версия должна быть в формате ETag. Ранее возвращается значение 500, если версия была недопустимой или в неправильном формате. Теперь это обновление возвращает 400 недопустимых запросов. Дополнительные сведения см. в разделе PR #2467. |
Исправления ошибок
| Исправления ошибок | Дополнительные сведения |
|---|---|
| Добавляет ядро в путь к ресурсу | Часть пути к строкового ресурса была случайно удалена в политике управления версиями. Это исправление добавляет его обратно. Дополнительные сведения см. в разделе PR #2470. |
| Время ожидания SQL возвращает ошибку 500 | Исправлена ошибка, когда sql-запрос попадает в время ожидания, и запрос возвращает значение 500. В журналах это время ожидания из SQL по сравнению с получением ошибки 429 из передней части. Дополнительные сведения см. в разделе PR #2497. |
Март 2022 г.
Функции
| Функция | Дополнительные сведения |
|---|---|
| Исправление FHIRPath | Эта новая функция позволяет использовать операцию исправления FHIRPath в ресурсах FHIR. Дополнительные сведения см. в статье о возможностях REST API FHIR для Azure API для FHIR. |
Исправления ошибок
| Исправления ошибок | Дополнительные сведения |
|---|---|
Дублирование ресурсов в поиске с помощью _include |
Исправлена проблема, из-за которой один ресурс можно возвращать дважды в поиске._include Дополнительные сведения см. в разделе PR #2448. |
| Put создает в обновлении с версиями | Исправлена проблема: создание с помощью PUT привело к ошибке при настройке versioned-updateполитики управления версиями. Дополнительные сведения см. в разделе PR #2457. |
| Недопустимая обработка заголовков при обновлении версии | Исправлена проблема, из-за которой недопустимый if-match заголовок приводил к ошибке HTTP 500. Теперь возвращается http-недопустимый запрос. Дополнительные сведения см. в разделе PR #2467. |
2022 февраля
Функции и улучшения
| Усовершенствования | Дополнительные сведения |
|---|---|
| Добавлено 429 повторных попыток и ведения журнала в BundleHandler | Иногда при обработке пакета возникают 429 ошибок. Если служба FHIR получает 429 на уровне BundleHandler, мы прерываем обработку пакета и пропускаем оставшиеся ресурсы. Мы добавили еще одну повторную попытку (помимо повторных попыток, присутствующих на уровне хранилища данных), которая будет выполняться один раз на ресурс, который сталкивается с 429. Дополнительные сведения об этом улучшении функций см. в разделе PR #2400. |
Выставление счетов и $convert-data$de-id |
Теперь общедоступны функции преобразования данных Azure для FHIR и деидентифицируемых функций экспорта. Выставление счетов и $convert-data $de-id операций в AZURE API для FHIR было включено. Счетчики выставления счетов были включены 1 марта 2022 года. |
Исправления ошибок
| Исправления ошибок | Дополнительные сведения |
|---|---|
| Обновление индекса поиска в отсеке | Существовал угол случая, когда индекс поиска в секции не был установлен на ресурсах. Теперь мы используем тот же индекс, что и основной поиск в секции, чтобы убедиться, что возвращаются все данные. Дополнительные сведения об исправлении кода см. в разделе PR #2430. |
Декабрь 2021 г.
Функции и улучшения
| Усовершенствования | Дополнительные сведения |
|---|---|
Добавлен издатель в CapabilityStatement.name |
Теперь вы можете найти издателя в инструкции возможностей по адресу CapabilityStatement.name. #2319 |
Журнал FhirOperation , связанный с анонимными вызовами метрик запросов |
Мы не были операциями ведения журнала, которые не требовали проверки подлинности. Мы расширили возможность ввода FhirOperation RequestMetrics для анонимных вызовов. #2295 |
Исправления ошибок
| Исправления ошибок | Дополнительные сведения |
|---|---|
Исправлена ошибка 500, если SearchParameter код имеет значение NULL |
Исправлена проблема, связанная с SearchParameter наличием значения NULL для Code, результатом будет 500. Теперь он приводит к InvalidResourceException тому, что другие значения выполняются. #2343 |
Возвращается BadRequestException с допустимым сообщением при недопустимом вводе текста JSON |
Для недопустимых запросов текста JSON сервер FHIR возвращает ошибку 500. Теперь мы возвращаем допустимое BadRequestException сообщение вместо 500. #2239 |
_sort Может привести ChainedSearch к возврату неправильных результатов |
Ранее параметры сортировки из объекта в цепочке поиска SearchOption не были удалены, что приводит к передаче параметров сортировки в цепочку подпоисков, которые не являются допустимыми. Это может привести к отсутствии результатов, когда должны быть результаты. Эта ошибка исправлена #2347. Устранена ошибка GitHub #2344. |
Ноябрь 2021 г.
Функции и улучшения
| Усовершенствования | Дополнительные сведения |
|---|---|
| Обработка ссылок "Пациент- все" | Мы расширили возможности пациентов для обработки связей пациентов #2305. Дополнительные сведения см . в документации по FHIR для пациентов. |
| Добавлено имя программного обеспечения и версия для инструкции возможности | В инструкции возможностей имя программного обеспечения теперь отличается, если вы используете Azure API для FHIR или Служб данных Работоспособности Azure. Теперь версия программного обеспечения будет указывать, какой пакет выпуска с открытым исходным кодом находится в управляемой службе #2294. Адреса: #1778 и #2241 |
Журнал 500s в RequestMetric |
Ранее 500-е или любые неизвестные или необработанные ошибки не были вошедшего в RequestMetricсистему. Теперь они регистрируются #2240. Дополнительные сведения см. в разделе "Включение параметров диагностики" в AZURE API для FHIR |
| Сжатие маркеров продолжения | В некоторых случаях маркер продолжения был слишком длинным, чтобы иметь возможность следовать следующей ссылке в поисках и привести к 404. Чтобы устранить эту проблему, мы сжимали маркер продолжения, чтобы убедиться, что он остается ниже предела размера #2279. Устранена проблема 2250. |
Исправления ошибок
| Исправления ошибок | Дополнительные сведения |
|---|---|
| Устранена ошибка 500 при передаче даты с часовой поясом. | Это исправляет ошибку 500 при передаче даты с часовыми поясами в поле datetime #2270. |
| Устранена проблема при публикации пакета с неправильным типом носителя, возвращена ошибка 500. | Ранее при публикации поиска с ключом, содержащим определенные символы, возвращается ошибка 500. Это исправляет эту проблему #2264, и она обращается к #2148. |
2021 октября
Исправления ошибок
| Ошибка бесконечного цикла | Дополнительные сведения |
|---|---|
| Исправлена проблема, из-за которой условное удаление может привести к бесконечному циклу. | #2269 |
Сентябрь 2021 года
Функции и улучшения
| Усовершенствования | Дополнительные сведения |
|---|---|
| Добавлена поддержка условного исправления | Условное исправление |
| Условное исправление | #2163 |
| Добавлено событие аудита условного исправления. | #2213 |
| Разрешить исправление JSON в пакетах | Исправление JSON в пакетах |
|---|---|
| Позволяет выполнять пакеты журнала поиска с запросами на исправление. | #2156 |
| Исправление JSON в пакетах с помощью двоичных ресурсов. | #2143 |
| Новые подтипы событий аудита | Дополнительные сведения |
|---|---|
| Добавлены новые подтипы OperationName. | #2170 |
| Улучшения переиндексации | Дополнительные сведения |
|---|---|
| Добавлены границы для параметров переиндексации. | #2103 |
| Обновите сообщение об ошибке для границ параметров переиндексации. | #2109 |
| Добавлена окончательная проверка счетчика переиндексов. | #2099 |
Исправления ошибок
| Исправления ошибок | Дополнительные сведения |
|---|---|
| Более широкий перехват исключений при применении исправления. | #2192 |
| Исправляет журнал с помощью PATCH в STU3. | #2177 |
| Ошибки пользовательского поиска | Дополнительные сведения |
|---|---|
| Устраняет сбой пользовательских параметров поиска. | #2133 |
| Добавлена логика повторных попыток при удалении параметра поиска. | #2121 |
| Задайте максимальное количество элементов в параметрах поиска в SearchParameterDefinitionManager. | #2141 |
| Обеспечивает лучшее исключение, если в параметре поиска есть плохое выражение. | #2157 |
| Устранена ошибка повтора 503 | Дополнительные сведения |
|---|---|
| Повторите ошибку 503 из Azure Cosmos DB. | #2106 |
| Исправлена обработка 429s из StoreProcedures. | #2165 |
| Проблемы с GitHub закрыты | Дополнительные сведения |
|---|---|
| Не удалось создать настраиваемый параметр поиска для медицинского устройства CarePlan. | #2146 |
| Неясное сообщение об ошибке для условного создания без идентификатора. | #2168 |
Соединитель Интернета вещей для FHIR (предварительная версия)
| Исправления ошибок | Дополнительные сведения |
|---|---|
| Исправлена сломанная ссылка. | Обновлена ссылка на документацию по соединителю Интернета вещей Azure на портале Azure API для FHIR. |
Следующие шаги
Сведения о функциях и исправлениях ошибок в службах данных Работоспособности Azure (служба FHIR, служба DICOM и служба MedTech) см. в статье
Примечание.
FHIR® является зарегистрированным товарным знаком HL7 и используется с разрешением HL7 .