Comenzar a usar el servicio de FHIR

Artículo
10/16/2024

En este artículo se describen los pasos básicos para empezar a trabajar con el servicio de FHIR® en Azure Health Data Services.

Como requisito previo, necesitará una suscripción de Azure y los permisos para crear grupos de recursos de Azure e implementar recursos de Azure. Puede seguir todos los pasos u 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

Cree 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 del servicio 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 de tecnologías médicas en el área de trabajo.

Acceso al servicio FHIR

El servicio FHIR está protegido por una instancia de Microsoft Entra ID que no se puede deshabilitar. Para acceder a la API de servicio, debe crear una aplicación cliente (también denominada "entidad de servicio") en Microsoft Entra ID y concederle los permisos adecuados.

Registrar una aplicación cliente

Puede crear o registrar una aplicación cliente desde Azure Portal o mediante PowerShell y scripts de 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 que expire y de 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 enAzure Portal o mediante scripts de PowerShell y la CLI de Azure.

Realización de 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. Como el servicio de FHIR está protegido de manera 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, la CCI REST o el SDK de .NET. Para obtener más información, consulta Obtención de un token de acceso.

Acceso mediante herramientas existentes

Carga de datos

Puede cargar los datos directamente mediante el método POST o PUT en el servicio de FHIR. Para cargar datos de forma masiva, puede usar la operación $import. Para obtener información, visite operación de importación.

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 y como están" o desclasificarlos en formato ndjson.

Conversión de datos

Opcionalmente, puede convertir datos HL7 v2 y otros formatos 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

Implementación del servicio de FHIR en Azure Health Data Services