Compartir a través de

Notas de la versión: Azure API for FHIR

  • Artículo

Importante

Azure API for FHIR se retirará el 30 de septiembre de 2026. Siga las estrategias de migración para realizar la transición al 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 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.

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:

Correcciones de errores

  • Corregido: Mejora del rendimiento para el procesamiento de agrupación. Novedades 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.

Mejora del rendimiento Optimización paralela 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, vea #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

Corrección de errores 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

Corrección de errores 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 Se ha corregido un problema con PUT que provocaba un error al configurar la directiva de control de versiones en versioned-update. 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 de identificación de Azure API for FHIR ahora 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

Corrección de errores 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 CapabiilityStatement.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

Corrección de errores 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 devuelve BadRequestException con un mensaje válido en lugar de un error 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 errores 500 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

Corrección de errores 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

Corrección de errores 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)

Corrección de errores 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

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