Preguntas más frecuentes sobre el servicio 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.

En esta sección se tratan algunas de las preguntas más frecuentes sobre el servicio FHIR de Azure Health Data Services (denominado servicio FHIR).

Servicio FHIR: conceptos básicos

¿Qué es FHIR?

Recursos Rápidos de Interoperabilidad en Salud (FHIR, pronunciado como "fire" en inglés) es un estándar de interoperabilidad diseñado para permitir el intercambio de datos del sector sanitario entre diferentes sistemas sanitarios. Este estándar fue desarrollado por la organización HL7 y lo adoptan organizaciones del sector sanitario de todo el mundo. La versión más reciente de FHIR disponible es la R4 (versión 4). El servicio FHIR admite R4 y la versión anterior STU3 (Estándar para uso de prueba 3). Para más información sobre FHIR, visite HL7.org.

¿Están los datos detrás de las API de FHIR almacenados en Azure?

Sí, los datos se almacenan en bases de datos administradas en Azure. El servicio FHIR de Azure Health Data Services no proporciona acceso directo al almacén de datos subyacente.

¿Cómo se puede obtener acceso a los datos subyacentes?

En el servicio administrado, no puede acceder a los datos subyacentes. Esto es para garantizar que el servicio FHIR ofrezca las certificaciones de privacidad y cumplimiento necesarias para los datos sanitarios. Si necesita acceso a los datos subyacentes, puede usar el servidor FHIR de código abierto.

¿Qué proveedor de identidades admite?

Se admite el identificador de Entra de Microsoft como proveedor de identidades.

¿Puedo usar Azure AD B2C con el servicio FHIR?

Sí. Puede usar Azure Active Directory B2C (Azure AD B2C) con el servicio FHIR para conceder acceso a las aplicaciones y usuarios. Para más información, consulte Uso de Azure Active Directory B2C para conceder acceso al servicio FHIR.

¿Qué versión de FHIR admite?

Se admiten las versiones 4.0.0 y 3.0.1.

Para obtener más información, consulte Características de FHIR admitidas. Lea sobre lo que ha cambiado entre las versiones de FHIR (es decir, de STU3 a R4) en el historial de versiones de HL7 STU3.

¿Cuál es la diferencia entre Azure API for FHIR y el servicio FHIR en Azure Health Data Services?

Azure API for FHIR era nuestro producto disponible con carácter general inicial y se retira a partir del 30 de septiembre de 2026. El servicio FHIR de Azure Health Data Services admite funcionalidades adicionales, como:

De forma predeterminada, cada instancia de Azure Health Data Services, la instancia de FHIR se limita a la capacidad de almacenamiento de 4 TB. Para aprovisionar una instancia de FHIR con capacidad de almacenamiento superior a 4 TB, cree una solicitud de soporte técnico con el tipo de problema "Límite de servicio y suscripción (cuotas)".

¿Cuál es la diferencia entre el servicio FHIR en Azure Health Data Services y el servidor FHIR de código abierto?

El servicio FHIR en Azure Health Data Services es una versión hospedada y administrada del servidor Microsoft FHIR de código abierto para Azure. En el servicio administrado, Microsoft proporciona todo el mantenimiento y las actualizaciones.

Al ejecutar FHIR Server para Azure, tiene acceso directo a los servicios subyacentes, pero también es responsable de mantener y actualizar el servidor y todo el trabajo de cumplimiento requerido si almacena datos de PHI.

¿En qué regiones está disponible el servicio FHIR?

El servicio FHIR está disponible en todas las regiones que Azure Health Data Services está disponible. Puede ver eso en la página Productos por región .

¿Dónde puedo ver lo que se publica en el servicio FHIR?

La página de notas de la versión proporciona información general sobre todo lo que se ha enviado al servicio administrado en el mes anterior.

Para ver lo que se publicará en el servicio administrado, puede revisar la página de versiones del servidor FHIR de código abierto. Hemos trabajado para etiquetar elementos con Azure Health Data Services si se liberarán en el servicio administrado y estarán disponibles dos semanas después de que se encuentren en la página de versión en código abierto. También se han incluido instrucciones sobre cómo probar la compilación si se quiere probar en el entorno propio. Estamos evaluando cómo compartir mejor las actualizaciones de servicio administradas adicionales.

Para ver qué paquete de versión está actualmente en el servicio administrado, puede ver la instrucción de funcionalidad del servicio FHIR y en la software.version propiedad . Verá qué paquete se implementa.

¿Dónde puedo encontrar qué versión de FHIR (R4/STU3) se ejecuta en mi base de datos?

Puede encontrar la versión exacta de FHIR expuesta en la instrucción de funcionalidad en la fhirVersion propiedad (DIRECCIÓN URL o metadatos de FHIR).

¿Puedo cambiar mi servicio FHIR de STU3 a R4?

No. No tenemos una manera de cambiar la versión de una base de datos existente. Deberá crear un nuevo servicio de FHIR y volver a cargar los datos. Puede aprovechar el convertidor JSON a FHIR como un lugar para empezar con la conversión de datos STU3 en R4.

¿Puedo personalizar la dirección URL del servicio FHIR?

No. No se puede cambiar la dirección URL del servicio FHIR.

Implementaciones y especificaciones de FHIR

¿Qué es SMART on FHIR?

SMART (Substitutable Medical Applications and Reusable Technology) on FHIR es un conjunto de especificaciones de código abierto para integrar aplicaciones de asociados con servidores de FHIR y otros sistemas de TI sanitarios, como los registros sanitarios electrónicos y los intercambios de información sanitaria. Al crear una aplicación SMART on FHIR, puede garantizar que una gran cantidad de sistemas diferentes pueden acceder a la aplicación y aprovecharla. Para obtener más información sobre SMART, consulte SMART Health IT.

¿El servicio FHIR admite SMART on FHIR?

Sí, la funcionalidad SMART on FHIR se admite mediante ejemplos de AHDS. Esto se conoce como SMART on FHIR(Enhanced). SMART on FHIR (mejorado) puede ser la opción idónea para cumplir los requisitos de la Guía de implementación de SMART on FHIR (v 1.0.0) y del criterio §170.315(g)(10) Standardized API for patient and population services. Para obtener más información, visite SMART on FHIR(Enhanced) Documentation (Documentación de SMART on FHIR(Enhanced).

¿Puedo crear un recurso personalizado de FHIR?

No se permiten recursos de FHIR personalizados. Si necesita un recurso FHIR personalizado, puede crear un recurso personalizado sobre el recurso básico con extensiones.

¿Se admiten extensiones en el servicio FHIR?

Está permitido cargar datos JSON de FHIR válidos en el servidor. Si desea almacenar la definición de la estructura que define la extensión, puede guardarla como un recurso de definición de estructura. Para buscar en extensiones, deberá definir sus propios parámetros de búsqueda.

Cómo ver el servicio FHIR en XML?

En el servicio administrado, solo se admite JSON. El servidor FHIR de código abierto admite JSON y XML. Para ver la versión XML en código abierto, use _format= application/fhir+xml.

¿Cuál es el límite en recuento?

El límite actual de "_count" es 1000. Si establece "_count" en más de 1000, recibirá una advertencia en el conjunto de que solo se mostrarán 1000 registros.

¿Puedo publicar un conjunto en el servicio FHIR?

Actualmente se admite publicar conjuntos por lotes y conjunto de transacciones en el servicio FHIR.

¿Cómo puedo obtener todos los recursos de un solo paciente en el servicio FHIR?

Se admite la operación $patient-everything, que le proporcionará todos los datos relacionados con un solo paciente.

¿Cuál es la ordenación predeterminada al buscar recursos en el servicio FHIR?

Se admite la ordenación por cadena y campos dateTime en el servicio FHIR. Para obtener más información sobre otros parámetros de búsqueda admitidos, consulte Introducción a la búsqueda de FHIR.

¿El servicio FHIR admite operaciones de terminología?

No, el servicio FHIR no admite actualmente operaciones de terminología.

¿Cuáles son las diferencias entre los tipos de eliminación en el servicio FHIR?

Hay dos tipos de eliminación básicos admitidos en el servicio FHIR. Estos son Delete y Conditional Delete.

  • Con Delete, puede optar por realizar una eliminación temporal (tipo más común) y poder recuperar versiones históricas del registro.
  • Con la eliminación condicional, puede pasar criterios de búsqueda para eliminar un recurso de un elemento a la vez o varios a la vez.
  • Si ha pasado el hardDelete parámetro con Delete o Conditional Delete, todos los registros y el historial se eliminan y no se pueden recuperar.

Uso del servicio FHIR

¿Puedo realizar comprobaciones de estado en el servicio FHIR?

Para realizar una comprobación de estado en un servicio FHIR, escriba {{fhirurl}}/health/check en la solicitud GET. Debería poder ver el estado del servicio FHIR. La respuesta del código de estado HTTP con 200 y OverallStatus como Correcto en respuesta significa que la comprobación de estado se realiza correctamente.

En caso de errores, puede recibir una respuesta de error con el código de estado HTTP 404 (no encontrado) o el código de estado 500 (error interno del servidor) e información detallada en el cuerpo de la respuesta.

Pasos siguientes

En este artículo, ha aprendido las respuestas a las preguntas más frecuentes sobre el servicio FHIR. Para ver las preguntas más frecuentes sobre el servicio FHIR en Azure API for FHIR, consulte

Preguntas más frecuentes sobre Azure API for FHIR

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