Descripción general de la reescritura de Dataverse Healthcare APIs
La API upsert de atención médica de Dataverse facilita la ingestión de datos FHIR en Dataverse. Una vez que los datos estén disponibles en Dataverse, los usuarios pueden actualizar los nuevos registros, como actualizar la información demográfica del paciente. La solución de reescritura de las Dataverse Healthcare APIs permite que estos cambios se publiquen nuevamente en el servidor FHIR de origen.
El enfoque de la solución ofrece cierta extensibilidad al proceso de reescritura. La configuración de escritura diferida también puede apuntar a un punto de conexión alternativo si los usuarios necesitan inyectar lógica personalizada en este proceso. Por ejemplo, una aplicación de Azure Logic personalizada puede estar destinada al mensaje saliente que realiza un procesamiento o enrutamiento adicional. Este punto final de salida alternativo debe admitir la autenticación mediante OAuth 2.0 utilizando un Id. de cliente y un secreto de cliente.
El siguiente diagrama resalta el proceso de reescritura general:
Los pasos estándar de procesamiento son los siguientes:
- El usuario actualiza un registro en Dataverse.
- Dataverse evalúa el cambio y compone un nuevo recurso FHIR que se publica en el punto de conexión de API FHIR.
- El FHIR punto de conexión procesa el recurso FHIR y devuelve la respuesta del resultado de la operación a Dataverse.
- Dataverse registra los resultados operativos en los registros del kit de herramientas de integración de datos. El administrador puede revisar cualquier error aquí.
Para lograr extensibilidad, los usuarios pueden especificar un enfoque de reescritura alternativo si es necesario.
- Dataverse envía la solicitud de recursos FHIR al punto de conexión definido por el usuario.
- El usuario definido punto de conexión es responsable de procesar el recurso FHIR publicado y enviarlo a la API FHIR.
- El usuario es responsable de registrar los resultados operativos, de modo que Administrador pueda revisar cualquier falla mientras envía datos al punto de conexión personalizado.
Nota
La versión actual de las Dataverse Healthcare API y el proceso de reescritura suponen que hay un servicio de FHIR disponible para la creación y validación del recurso de FHIR saliente. Esta configuración es necesaria tanto para escribir directamente en el servicio de FHIR como en un punto de conexión saliente alternativo. Garantiza la integridad del recurso de FHIR saliente cuando se produce un evento de reescritura. Esta configuración se ha probado y validado con un servicio de FHIR de Azure Health Data Services.
También se publica un registro de Procedencia FHIR en FHIR punto de conexión cuando se procesa el evento de reescritura. El recurso de procedencia rastrea información sobre la actividad que creó, revisó, eliminó o firmó una versión de un recurso, describiendo las entidades y agentes involucrados. Puede utilizar esta información para formar evaluaciones sobre su calidad, fiabilidad o confianza. También proporciona indicaciones sobre dónde ir para investigar más a fondo los orígenes del recurso y la información que contiene.
Para obtener más información sobre proveniencia en FHIR, vaya a nuestro artículo sobre Proveniencia de recursos en FHIR.
Habilitar reescritura
Habilitar el proceso de reescritura incluye los siguientes tres pasos principales:
- Proporcionar detalles de conexión
- Actualizar mapas de entidades
- Aplicar el consentimiento del paciente
Proporcionar detalles de conexión
El primer paso para configurar la reescritura es proporcionar los detalles de conectividad para el punto de conexión FHIR que recibe los recursos FHIR publicados. Puede encontrar estos valores de configuración en la sección Configuración de integración del kit de herramientas de integración de datos.
Para obtener más información sobre estas configuraciones, vaya a Configurar las opciones de integración.
Actualizar mapas de entidades
Después de proporcionar detalles de conectividad, el siguiente paso es actualizar los mapas de entidades que controlan qué recursos de FHIR deben participar en el proceso de reescritura.
Los complementos de reescritura utilizan los mismos mapas de entidad configurados para la API upsert. Cada mapa de entidad puede incluir un atributo titulado Habilitar reescritura en FHIR. Cuando el valor de este atributo se establece en Sí, los complementos de reescritura publican actualizaciones para la tabla de Dataverse seleccionada en el punto de conexión FHIR. Este proceso permite un control granular, tabla por tabla, sobre qué datos se deben volver a escribir en el FHIR punto de conexión.
Después de habilitar la reescritura para el mapa de entidades, el Administrador puede elegir qué eventos activarán el proceso de reescritura, indicado por el campo de formulario Mensajes admitidos . La solución de reescritura actualmente admite Crear y Actualizar mensajes.
Para obtener más información sobre cómo configurar asignaciones de entidades, vaya a Configurar asignaciones de entidades.
Aplicar el consentimiento del paciente
Los recursos del paciente incluyen una opción de configuración adicional para la reescritura. Los pacientes pueden optar por dar su consentimiento o negar que sus datos se actualicen desde la aplicación de Dataverse. Este consentimiento se guarda para cada paciente en el atributo Sincronización de FHIR en Azure habilitada .
Cuando el valor del atributo Sincronización de FHIR en Azure habilitada se establece en Sí, y si la asignación de entidad Paciente está configurada para reescritura, cualquier cambio en los atributos que se hayan asignado se publicará en el punto de conexión FHIR. De lo contrario, los complementos de reescritura ignorarán los cambios en el registro del paciente.
Advertencias comunes y escenarios de error
Las advertencias y excepciones que pueden ocurrir durante el proceso de reescritura se registran en los registros del kit de herramientas de integración de datos. Para obtener más información sobre los registros, vaya a Revisar los registros de Dataverse Healthcare API.
Opciones de configuración no válidas
Si la configuración de conectividad proporcionada en la sección Configuración de integración es incorrecta, el proceso de reescritura registra una excepción y detiene el procesamiento. Por ejemplo, los valores de ID de aplicación/cliente o el Secreto del cliente podrían ser incorrectos.
Mensaje procesado con advertencias
El FHIR punto de conexión podría devolver algunas advertencias o mensajes de información incluso si la solicitud de reescritura se procesa con éxito. Los registros secundarios para este mensaje de advertencia contendrían más detalles para que los administradores los revisen.
Errores de proveniencia de FHIR
Cualquier excepción relacionada con la creación del registro de proveniencia de FHIR se registra con una excepción general junto con los detalles devueltos por el punto de conexión FHIR.
Faltan atributos necesarios
El procesamiento de reescritura para mapas de expansión requiere una referencia al registro principal. Si falta el valor del atributo del enlace principal, el proceso de reescritura registra una excepción y detiene el procesamiento.
Tipo de contacto no válido
Para los registros de contacto en Dataverse, el indicador del Tipo de contacto debe configurarse correctamente para que la reescritura tenga éxito. Por ejemplo, deben configurarse como Paciente o Médico. Si falta este valor, el proceso de reescritura registra una excepción y detiene el procesamiento.
Limitaciones
La solución de reescritura actualmente tiene las siguientes limitaciones:
- Formato de salida: la solución de reescritura no admite el formato de salida. El proceso actualmente publica el recurso FHIR que representa los cambios para el recurso FHIR actualizado en Dataverse.
- Autenticación: la solución de reescritura actualmente admite la publicación en puntos finales que solo admiten la autenticación OAuth.
Consulte también
¿Qué es Microsoft Cloud for Healthcare?
Descripción general del kit de herramientas de integración de datos
Descripción general de Dataverse Healthcare APIs
Configurar Dataverse Healthcare APIs
Revisar los registros de las Dataverse healthcare API