Descripción general de la reescritura de Dataverse Healthcare APIs
La API de actualización e inserción de datos de atención médica de Dataverse facilita la ingesta de datos FHIR (recursos de interoperabilidad rápida de atención médica) 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:
- 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 mayor extensibilidad, puede especificar un enfoque de escritura diferida alternativo si es necesario.
- Dataverse envía la solicitud de recursos FHIR al punto final definido.
- El punto de conexión definido es responsable de procesar el recurso FHIR publicado y enviarlo a la API de FHIR.
- Usted es responsable de registrar los resultados operativos, para que el administrador pueda revisar cualquier falla al enviar datos al punto de conexión personalizado.
Nota
La versión actual de las API de Dataverse Healthcare 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. También describe 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
Proporcione 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 escritura diferida para la asignación de entidades, el administrador puede seleccionar qué eventos desencadenadores tiene lugar el proceso de escritura diferida, indicado por el campo 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 para el paciente incluyen una configuración adicional para la escritura diferida. Los pacientes pueden optar por dar su consentimiento o negar que sus datos se actualicen desde la aplicación de Dataverse. El atributo Sincronización Azure FHIR habilitada guarda este consentimiento para cada paciente.
Cuando el valor del atributo Azure FHIR Sync Enabled se establece en Sí y la asignación de entidad Patient está configurada para escritura diferida, cualquier cambio en los atributos asignados se publica 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 los detalles de conectividad proporcionados en la sección configuración de integración son incorrectos, el proceso de escritura diferida registra una excepción y detiene el procesamiento. Por ejemplo, los valores de ID de aplicación/cliente o Secreto de cliente podrían ser incorrectos.
Mensaje procesado con advertencias
El punto de conexión FHIR podría devolver algunas advertencias o mensajes de información incluso si la solicitud de escritura diferida se procesa correctamente. Los registros elemento secundario para este mensaje de advertencia contienen 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, debe configurar correctamente el indicador del Tipo de contacto para que la escritura diferida tenga éxito. Por ejemplo, debe configurarlo 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 escritura diferida actualmente admite la publicación solo en puntos finales que usan la autenticación OAuth.