Notas de la versión: Azure API for FHIR

Importante

Azure API for FHIR se retirará el 30 de septiembre de 2026. Siga las estrategias de migración para realizar la transición a servicio FHIR® de Azure Health Data Services en esa fecha. Debido a la retirada de Azure API for FHIR, no se permitirán nuevas implementaciones a partir del 1 de abril de 2025. El servicio FHIR de Azure Health Data Services es la versión evolucionada de la API de Azure para FHIR que permite a los clientes administrar FHIR, DICOM y los servicios de tecnologías médicas con integraciones en otros servicios de Azure.

Azure API for FHIR® proporciona una implementación totalmente administrada de Microsoft FHIR Server para Azure. El servidor es una implementación del estándar FHIR. Este documento proporciona información detallada sobre las características y mejoras de Azure API for FHIR.

Noviembre de 2024

Servicio FHIR

Correcciones de errores

• Mejora de la validación de exportación: se encontró un problema en el que las exportaciones continuaron a pesar de los parámetros de búsqueda no válidos. Se implementa un nuevo cambio para evitar exportaciones en estas condiciones. Este es el comportamiento predeterminado. Los clientes pueden invalidarlo con la marca lenienta. Este cambio se ha comunicado a los clientes el mes pasado.
• Mejora del rendimiento del lote: el proceso de actualización del perfil durante la ejecución del lote se ha simplificado. Si una agrupación contiene cambios en ValueSet, StructureDefinitiony/o CodeSystem, no se producirá ninguna actualización del perfil hasta que la agrupación se complete por completo. Este cambio mejora el rendimiento de las agrupaciones al reducir los retrasos causados por varias actualizaciones al controlar los cambios en estos tipos de recursos.
• Análisis de encabezados de tipo de contenido: se ha solucionado y resuelto un problema relacionado con el análisis del application/x-www-form-urlencoded encabezado de tipo de contenido.
• Mejoras de reindexación La operación de reindexación se ha mejorado mediante la eliminación de una limitación artificial que anteriormente limitaba el control de grandes conjuntos de datos históricos o casos en los que los clientes solicitaron un tamaño de consulta limitado. Además, el proceso de reindexación notificaría incorrectamente como "completado" al controlar muchos recursos históricos o eliminados secuenciales con el tamaño de consulta predeterminado. Este problema se ha solucionado para asegurarse de que el proceso de reindexación se completa correctamente e informa del estado adecuado.

Octubre de 2024

Servicio FHIR

Correcciones de errores

• Validación de exportación: se identificó un problema en el que las exportaciones continuaron a pesar de los parámetros de búsqueda no válidos. Estamos introduciendo un cambio que impide las exportaciones en estas condiciones. Esta característica está actualmente detrás de una marca de validación estricta y se convertirá en el comportamiento predeterminado en o después del 30 de octubre.
• Inclusión de parámetros de búsqueda: se ha resuelto un problema por el que los parámetros de búsqueda adicionales (por ejemplo, _include, _has) no devolvieron todos los resultados esperados y, a veces, se omite el vínculo siguiente.
• Ejecución del trabajo de exportación: se ha solucionado una aparición poco frecuente de durante la finalización del System.ObjectDisposedException trabajo de exportación evitando las salidas prematuras.
• Actualización del código de estado HTTP: el código de estado HTTP para parámetros no válidos durante $reindex la creación de trabajos ahora se actualiza a 400, lo que garantiza un mejor control de errores.
• Limpieza de parámetros de búsqueda: se ha implementado una corrección para garantizar una limpieza completa de los parámetros de búsqueda en la base de datos cuando se desencadena con llamadas API de eliminación, solucionando problemas relacionados con eliminaciones incompletas.

Agosto de 2024

Servicio FHIR

Correcciones de errores Se implementó una corrección para solucionar problemas con exportaciones de gran tamaño que muestran incorrectamente un estado "completado" mientras las tareas secundarias siguen procesando. La solución incorpora un retraso para mitigar la aparición de estos errores de estado, lo que mejora la confiabilidad de la exportación.

Julio de 2024

Servicio FHIR

Correcciones de errores

Corregido: La exportación de datos como usuario INTELIGENTE exportando datos como un usuario SMART ya no requiere ámbitos de escritura. Anteriormente, era necesario conceder privilegios de "escritura" a un usuario SMART para exportar datos, lo que implicaba niveles de privilegios superiores. Para iniciar un trabajo de exportación como usuario SMART, asegúrese de que el usuario sea miembro del rol de exportación de FHIR en RBAC y solicite el ámbito clínico smart de "lectura".

Corregido: Actualización del código de estado de HTTP 500 a HTTP 400 Durante una operación de revisión, si la carga solicitó una actualización para un tipo de recurso distinto de Parameter, inicialmente se produjo un error interno del servidor (HTTP 500). Esto se ha actualizado para producir un error HTTP 400 en su lugar.

Mayo de 2024

Servicio FHIR

Mejoras en la operación de purga-historial La operación de historial de purga permite realizar una eliminación parcial mediante el parámetro de consulta "allowPartialSuccess". De forma predeterminada, la operación de historial de purga espera la finalización correcta antes de eliminar los recursos. Sin embargo, si se produce un error durante la ejecución, se revierte la eliminación de recursos. Mediante el parámetro de consulta "allowPartialSuccess", puede evitar que la transacción se revierta en caso de error.

Correcciones de errores

• Corregido: código de estado HTTP para solicitudes de ejecución prolongada. Las solicitudes FHIR que tardan más de 100 segundos en ejecutar devuelven un código de estado HTTP 408 en lugar de HTTP 500.
• Corregido: solicitud de historial en la agrupación. Antes de la corrección, una solicitud de historial en un paquete devolvió el código de estado HTTP 404.

Marzo de 2024

Los lotes de paralelización de lotes se ejecutan en serie en el servicio FHIR de forma predeterminada. Para mejorar el rendimiento con llamadas de agrupación, habilitamos el procesamiento paralelo de lotes.

Más información:

• Paralelización de lotes

Correcciones de errores

• Corregido: Mejora del rendimiento para el procesamiento de agrupación. Las actualizaciones se realizan en el método de ejecución de tareas, lo que conduce a la mejora del rendimiento del procesamiento de paquetes. Consulte PR#3727.

Febrero de 2024

Permite contar todas las versiones (históricas y eliminadas temporalmente) de los recursos El parámetro de consulta _summary=count y _count=0 se puede agregar a _history punto de conexión para obtener el recuento de todos los recursos con versiones. Este recuento incluye recursos eliminados temporalmente. Para obtener más información, consulte Administración del historial.

Mejora del rendimiento de la operación de exportación El parámetro de consulta "_isparallel" se puede agregar a la operación de exportación para mejorar su rendimiento. Es importante tener en cuenta que el uso de este parámetro puede dar lugar a un aumento del consumo de unidades de solicitud durante la vida útil de la exportación. Para obtener más información, consulte Exportar parámetros de consulta de operación.

Nota:

Hay un problema conocido con la operación de $export que podría dar lugar a exportaciones incompletas con el estado correcto. El problema se produce cuando se usó la marca is_parallel. Los trabajos de exportación ejecutados con _isparallel parámetro de consulta a partir del 13 de febrero de 2024 se ven afectados con este problema.

Cambio en la nomenclatura de nombres para el nombre de archivo exportado y la cuenta de almacenamiento predeterminada Con este cambio, los nombres de archivo exportados siguen el formato '{FHIR Resource Name}-{Number}-{Number}.ndjson'. No se garantiza que el orden de los archivos se corresponda con ninguna ordenación de los recursos de la base de datos. El nombre de la cuenta de almacenamiento predeterminado se actualiza a "Export-{Number}". No hay ningún cambio en el número de recursos agregados en archivos exportados individuales.

La optimización paralela de mejora del rendimiento para las consultas de FHIR se puede habilitar mediante el encabezado HTTP "x-ms-query-latency-over-efficiency". Este valor debe establecerse en true para lograr la simultaneidad máxima durante la ejecución de la consulta. Para más información, consulte Lotes.

Enero de 2024

La ejecución simultánea de consultas con interacciones condicionales puede ser compleja y intensiva en el rendimiento. Para mejorar la latencia de las consultas que implican interacciones condicionales, tiene la opción de usar el encabezado de solicitud x-conditionalquery-processing-logic. Para más información, consulte Consideraciones de rendimiento para interacciones de API condicionales.

Diciembre de 2023

Las funcionalidades adicionales agregadas a la operación exportar $export operación ahora admiten la exportación de recursos con versiones y recursos eliminados temporalmente. Para obtener más información, consulte Exportación de parámetros de consulta.

Noviembre de 2023

La funcionalidad de eliminación masiva ya está disponible en la versión preliminar "$bulk-delete" permite eliminar recursos del servidor FHIR de forma asincrónica. La operación de eliminación masiva se puede ejecutar en el nivel del sistema o para el tipo de recurso individual. Para obtener más información, consulte operación de eliminación masiva.

La operación de eliminación masiva está actualmente en versión preliminar pública. Revise la declinación de responsabilidades para obtener más información. [! EXCLUSIÓN de declinación de responsabilidades de versión preliminar pública]

Corrección de errores: las consultas de FHIR que usan la paginación y la revinclusión provocaron un error al usar el vínculo siguiente

El problema ahora se soluciona y las consultas de FHIR que usan el token de continuación con include/revinclude, ya no notifican una excepción. Para obtener más información sobre la corrección, visite #3525.

Junio de 2023

Corrección de errores: la dirección URL del punto de conexión de metadatos en la instrucción de funcionalidad es url relativa por especificación de FHIR, la dirección URL del punto de conexión de metadatos en la instrucción de funcionalidad debe ser una dirección URL absoluta. Para obtener más información sobre la especificación de FHIR, visite La instrucción de funcionalidad. Este fanix soluciona el problema, para obtener más información, visite 3265.

Mayo de 2023

SMART on FHIR: asignación de ámbito clínico fijo para aplicaciones

Esta corrección de errores soluciona el problema con el ámbito clínico no interpretado correctamente para las aplicaciones back-end. Para obtener más información, visite #3250.

Abril de 2023

Se han corregido problemas transitorios asociados con la carga de parámetros de búsqueda personalizados . Esta corrección de errores soluciona el problema, donde el servicio FHIR no cargaría el estado SearchParameter más reciente en caso de error. Para obtener más información, visite #3222.

Noviembre de 2022

Se ha corregido el error generado cuando el recurso se actualiza mediante el encabezado if-match y PATCH.

El error ahora se ha corregido y el recurso se actualizará si coincide con el encabezado Etag. Para obtener más información, consulte #2877|.

Mayo de 2022

Mejora

Mejora	Información relacionada
Azure API for FHIR no crea una nueva versión del recurso si el contenido del recurso no ha cambiado.	Si un usuario actualiza un recurso y solo cambian meta.versionId o meta.lastUpdated, se devuelve OK con la información actual del recurso sin actualizar VersionId y lastUpdated. Para obtener más información, consulte #2519.

Abril de 2022

Mejoras

Mejoras	Información relacionada
FHIRPath Patch	FHIRPath Patch se ha agregado como una característica a Azure API for FHIR. Esto implementa FHIRPath Patch como se define en el sitio web de HL7.
Mover la notificación de agrupación al núcleo	Con la introducción del espacio de nombres Resource.Bundle en el núcleo, las referencias al archivo de recursos de cadena tenían que ser más explícitas. Para obtener más información, vea PR #2478.
Controla un encabezado no válido en una actualización con versión.	Cuando la directiva de control de versiones se establecía en "versioned-update", era necesario proporcionar la versión más reciente del recurso en el encabezado if-match de la solicitud en una actualización. La versión especificada debe tener el formato ETag. Antes, se devolvía el error 500 si la versión no era válida o tenía un formato incorrecto. Esta actualización ahora devuelve un error 400 de solicitud incorrecta. Para obtener más información, vea PR #2467.

Correcciones de errores

Correcciones de error	Información relacionada
Agrega el núcleo a la ruta de acceso del recurso	Parte de la ruta de acceso a un recurso de cadena se quitó accidentalmente de la directiva de control de versiones. Esta corrección la agrega de nuevo. Para obtener más información, vea PR #2470.
El tiempo de espera de SQL devuelve un error 500	Se ha corregido un error por el que una solicitud SQL alcanza el tiempo de espera y devuelve el error 500. En los registros, se trata de un agotamiento del tiempo de espera de SQL en comparación con la obtención de un error 429 del front-end. Para obtener más información, vea PR #2497.

Marzo de 2022

Características

Característica	Información relacionada
FHIRPath Patch	Esta nueva característica permite usar la operación FHIRPath Patch en los recursos de FHIR. Para obtener más información, consulte Funcionalidades de la API REST de FHIR para Azure API for FHIR.

Correcciones de errores

Correcciones de error	Información relacionada
Recursos duplicados en la búsqueda con _include	Se ha corregido un problema por el que se puede devolver un único recurso dos veces en una búsqueda que tiene _include. Para obtener más información, vea PR #2448.
Creaciones con PUT en una actualización con versión	Problema corregido: al crear con PUT se produjo un error cuando la directiva de control de versiones está configurada versioned-updateen . Para obtener más información, vea PR #2457.
Control de encabezados no válido en una actualización con versión	Se ha corregido un problema por el que el encabezado no válido if-match provocaba un error HTTP 500. Ahora se devuelve un error HTTP de solicitud incorrecta. Para obtener más información, vea PR #2467.

Febrero de 2022

Características y mejoras

Mejoras	Información relacionada
Se ha agregado un reintento después del error 429 y el registro en BundleHandler	A veces se producen errores 429 cuando se procesa una agrupación. Si el servicio FHIR recibe un error 429 en la capa BundleHandler, se anula el procesamiento de la agrupación y se omiten los demás recursos. Hemos agregado otro reintento (además del reintento que ya había en la capa del almacén de datos) que se ejecutará una vez por cada recurso que encuentre un error 429. Para obtener más información sobre esta mejora de característica, vea PR #2400.
Facturación de $convert-data y $de-id	Las características de conversión de datos y exportación desidentificada de Azure API for FHIR ya están disponibles con carácter general. Se ha habilitado la facturación de las operaciones $convert-data y $de-id en Azure API for FHIR. Los medidores de facturación se activaron el 1 de marzo de 2022.

Correcciones de errores

Correcciones de error	Información relacionada
Actualizar el índice de búsqueda de compartimiento	Había un caso de esquina en el que el índice de búsqueda de compartimiento no se establecía en los recursos. Ahora se usa para la búsqueda de compartimiento el mismo índice que la búsqueda principal con el fin de asegurar que se devuelvan todos los datos. Para obtener más información sobre la corrección del código, vea PR #2430.

Diciembre de 2021

Características y mejoras

Mejoras	Información relacionada
Se ha agregado el publicador a CapabilityStatement.name	Ahora puede encontrar el publicador en la declaración de funcionalidad en CapabilityStatement.name. #2319
Registro de FhirOperation vinculado a llamadas anónimas a métricas de solicitud	Las operaciones que no requerían autenticación no se registraban. Se ha ampliado la capacidad para obtener el tipo de FhirOperation en RequestMetrics para las llamadas anónimas. #2295

Correcciones de errores

Correcciones de error	Información relacionada
Se ha corregido el error 500 cuando Code en SearchParameter es NULL	Se ha corregido un problema con SearchParameter si tenía un valor NULL para Code, el resultado era un error 500. Ahora da como resultado un InvalidResourceException como lo hacen los demás valores. #2343
Se devuelve BadRequestException con un mensaje válido cuando el cuerpo JSON de la entrada no es válido	Para las solicitudes de cuerpo JSON no válidas, el servidor FHIR devolvía un error 500. Ahora se devuelve un BadRequestException con un mensaje válido en lugar de 500. #2239
_sort puede hacer que ChainedSearch devuelva resultados incorrectos	Antes, las opciones de ordenación del objeto SearchOption de la búsqueda encadenada no se borraban, lo que provocaba que se pasaran a la subbúsqueda encadenada, donde no eran válidas. Esto podía dar lugar a que no se devolviese ningún resultado cuando debía haber resultados. El error se ha corregido (#2347). Se ha corregido el error de GitHub #2344.

Noviembre de 2021

Características y mejoras

Mejoras	Información relacionada
Procesar los vínculos de Patient-everything	Se ha ampliado la funcionalidad de Patient-everything para procesar los vínculos de pacientes #2305. Para obtener más información, consulte Uso de Patient-everything en el servicio FHIR en la documentación.
Se ha agregado el nombre y la versión del software a la declaración de funcionalidad	En la declaración de funcionalidad, el nombre del software ahora distingue si usa Azure API for FHIR o Azure Health Data Services. La versión del software ahora especifica qué paquete de versión de código abierto está activo en el servicio administrado (#2294). Direcciones: #1778 y #2241
Registro de 500s en RequestMetric	Antes, no se registraban en RequestMetric los errores 500 ni ningún otro error desconocido o no controlado. Ahora se registran (#2240). Para obtener más información, consulte Habilitación del registro de diagnóstico en Azure API for FHIR.
Comprimir tokens de continuación	En algunos casos, el token de continuación era demasiado largo para seguir el vínculo siguiente en las búsquedas y daba como resultado un error 404. Para resolverlo, se ha comprimido el token de continuación con el fin de asegurar que permanece por debajo del límite de tamaño (#2279). Soluciona el problema #2250.

Correcciones de errores

Correcciones de error	Información relacionada
Se ha resuelto el error 500 que se producía cuando se pasaba la fecha con una zona horaria.	Esto corrige un error 500 que se producía cuando se pasaba una fecha con una zona horaria a un campo de fecha y hora (#2270).
Se ha resuelto un problema por el que la publicación de una agrupación con un tipo de medio incorrecto devolvía un error 500.	Antes, al publicar una búsqueda con una clave que contenía determinados caracteres, se producía un error 500. Esto corrige los problemas #2264 y #2148.

Octubre de 2021

Correcciones de errores

Error de bucle infinito	Información relacionada
Se ha corregido un problema por el que la eliminación condicional podía dar lugar a un bucle infinito.	#2269

Septiembre de 2021

Características y mejoras

Mejoras	Información relacionada
Se ha agregado compatibilidad con Patch condicional	Patch condicional
Patch condicional	#2163
Se ha agregado el evento de auditoría de Patch condicional.	#2213

Permitir JSON Patch en agrupaciones	JSON Patch en agrupaciones
Permite agrupaciones del historial de búsqueda con solicitudes Patch.	#2156
Se ha habilitado JSON Patch en agrupaciones con recursos binarios.	#2143

Nuevos subtipos de eventos de auditoría	Información relacionada
Se han agregado nuevos subtipos de OperationName de auditoría.	#2170

Mejoras de reindexación	Información relacionada
Se han agregado límites para la reindexación de parámetros.	#2103
Se ha actualizado el mensaje de error para los límites de reindexación de parámetros.	#2109
Se ha agregado la comprobación del recuento de reindexación final.	#2099

Correcciones de errores

Correcciones de error	Información relacionada
Captura más amplia de excepciones al aplicar una revisión.	#2192
Corrige el historial con PATCH en STU3.	#2177

Errores de búsqueda personalizados	Información relacionada
Soluciona el error con los parámetros de búsqueda personalizados.	#2133
Se ha agregado lógica de reintento al eliminar el parámetro de búsqueda.	#2121
Se ha establecido un número máximo de elementos en las opciones de búsqueda en SearchParameterDefinitionManager.	#2141
Proporcionar una excepción mejor si hay una expresión incorrecta en el parámetro de búsqueda.	#2157

Se ha resuelto el error 503 de reintento	Información relacionada
Error 503 de reintento en Azure Cosmos DB.	#2106
Corrige el procesamiento de los errores 429 de los procedimientos almacenados.	#2165

Problemas de GitHub cerrados	Información relacionada
No se puede crear el parámetro de búsqueda personalizado para el dispositivo médico CarePlan.	#2146
Mensaje de error poco claro para la creación condicional sin identificador.	#2168

Conector de IoT para FHIR (versión preliminar)

Correcciones de error	Información relacionada
Se ha corregido el vínculo roto.	Se ha actualizado el vínculo a la documentación de Azure del conector de IoT en el portal de Azure API for FHIR.

Pasos siguientes

Para obtener información sobre las características y correcciones de errores de Azure Health Data Services (servicios FHIR, DICOM y MedTech), consulte:

Notas de la versión: Azure Health Data Services

Nota:

FHIR® es una marca registrada de HL7 y se usa con su permiso.