Introducción al servicio FHIR
En este artículo se describen los pasos básicos para empezar a trabajar con el servicio FHIR en Azure Health Data Services.
Como requisito previo, necesitará una suscripción de Azure y se le han concedido los permisos adecuados para crear grupos de recursos de Azure e implementar recursos de Azure. Puede seguir todos los pasos o omitir algunos si tiene un entorno existente. Además, puede combinar todos los pasos y completarlos en PowerShell, la CLI de Azure y scripts de API de REST.
Crear un área de trabajo en la suscripción de Azure
Puede crear un área de trabajo desde Azure Portal o mediante PowerShell, la CLI de Azure y la API REST. Puede encontrar scripts en los ejemplos de Azure Health Data Services.
Nota:
Hay límites para el número de áreas de trabajo y el número de instancias de servicio de FHIR que puede crear en cada suscripción de Azure.
Creación de un servicio FHIR en el área de trabajo
Puede crear una instancia de servicio de FHIR desde Azure Portal o mediante PowerShell, la CLI de Azure y la API REST. Puede encontrar scripts en los ejemplos de Azure Health Data Services.
Opcionalmente, puede crear un servicio DICOM y un servicio MedTech en el área de trabajo.
Acceso al servicio FHIR
El servicio FHIR está protegido por el identificador de Entra de Microsoft que no se puede deshabilitar. Para acceder a la API de servicio, debe crear una aplicación cliente que también se conoce como entidad de servicio en el identificador de Entra de Microsoft y concederla con los permisos adecuados.
Registro de una aplicación cliente
Puede crear o registrar una aplicación cliente desde Azure Portal o mediante scripts de PowerShell y la CLI de Azure. Esta aplicación cliente se puede usar para una o varias instancias de servicio de FHIR. También se puede usar para otros servicios de Azure Health Data Services.
Si la aplicación cliente se crea con un certificado o un secreto de cliente, asegúrese de renovar el certificado o el secreto de cliente antes de expirar y reemplazar las credenciales de cliente en las aplicaciones.
Puede eliminar una aplicación cliente. Antes de eliminar una aplicación cliente, asegúrese de que no se usa en entornos de producción, desarrollo, pruebas o control de calidad (QA).
Concesión de permisos de acceso
Puede conceder permisos de acceso o asignar roles desde Azure Portal o mediante scripts de PowerShell y la CLI de Azure.
Realizar transacciones de creación, lectura, actualización y eliminación (CRUD)
Puede realizar transacciones de creación, lectura (búsqueda), actualización y eliminación (CRUD) en el servicio FHIR en las aplicaciones o mediante herramientas como Postman, Cliente REST y cURL. Dado que el servicio FHIR está protegido de forma predeterminada, debe obtener un token de acceso e incluirlo en la solicitud de transacción.
Obtención de un token de acceso
Puede obtener un token de acceso de Microsoft Entra mediante PowerShell, la CLI de Azure, CCI REST o el SDK de .NET. Para obtener más información, consulte Obtención del token de acceso.
Acceso mediante herramientas existentes
Carga de datos
Puede cargar datos directamente mediante el método POST o PUT en el servicio FHIR. Para cargar datos de forma masiva, puede usar una de las herramientas de código abierto que se enumeran a continuación.
- Cargador de FHIR : se trata de una aplicación de consola de .NET y carga los datos almacenados en Azure Storage en el servicio FHIR. Se trata de una sola aplicación de subproceso, pero puede ejecutar varias copias localmente o en un contenedor de Docker.
- FHIR Bulk Loader Esta herramienta es una aplicación de funciones de Azure (microservicio) y se ejecuta en subprocesos paralelos.
- Importación masiva Esta herramienta solo funciona con el servidor FHIR de código abierto. Sin embargo, estará disponible para Azure Health Data Services en el futuro.
CMS, búsqueda, validación de perfiles y reindexación
Puede encontrar más detalles sobre la interoperabilidad y el acceso a los pacientes, la búsqueda, la validación de perfiles y la reindexación en la documentación del servicio FHIR.
Exportar datos
Opcionalmente, puede exportar ($export) datos a Azure Storage y usarlos en los proyectos de análisis o aprendizaje automático. Puede exportar los datos "tal como está" o desindificar en ndjson formato.
También puede exportar datos a Synapse mediante el proyecto de código abierto. En el futuro, esta característica se integrará en el servicio administrado.
Convertir datos
Opcionalmente, puede convertir HL7 v2 y otros datos de formato a FHIR.
Uso de datos de FHIR en el panel de Power BI
Opcionalmente, puede crear informes de panel de Power BI con datos de FHIR.
Pasos siguientes
En este artículo se describen los pasos básicos para empezar a usar el servicio FHIR. Para obtener información sobre cómo implementar el servicio FHIR en el área de trabajo de Azure Health Data Services, consulte
FHIR® es una marca registrada de HL7 y se usa con su permiso.