Administre los datos de FHIR con el kit de herramientas de integración de datos
El kit de herramientas de integración de datos lo ayuda a sincronizar la PHI (información de salud protegida) de los pacientes entre los sistemas EHR y Dataverse. Esta integración brinda a los equipos de atención y a los pacientes un acceso rápido y seguro a sus datos en el entorno de Microsoft Cloud for Healthcare.
Su sistema FHIR permanece separado, pero sus datos están rápidamente disponibles a través de Dataverse. Las Dataverse Healthcare APIs brindan puntos de entrada para ingerir y recuperar datos FHIR en la base de datos de Microsoft Cloud for Healthcare Dataverse. Los proveedores de atención pueden centrarse en las necesidades de los pacientes y los administradores pueden centrarse en gestionar personas, lugares y recursos clínicos.
Funciones que simplifican el trabajo con datos FHIR
La siguiente tabla describe cómo el kit de herramientas de integración de datos puede simplificar el trabajo con datos de pacientes protegidos.
| Característica | Qué hace la característica | Cómo te ayuda a administrar |
|---|---|---|
| Asignaciones de entidad | Los mapas de entidades asocian recursos FHIR con entidades de Dataverse. Por ejemplo, el recurso FHIR Paciente corresponde a la entidad contacto de Dataverse. Ambos tratan de lo mismo: pacientes. Cuando desea leer o cambiar datos, el mapa muestra el origen de los datos y ayuda a las API de atención médica de Dataverse a transformar los datos entre los registros de entidades de Dataverse y los recursos FHIR. |
En lugar de crear cada mapa de entidad usted mismo, puede habilitar los mapas que necesita. Si un mapa necesita un pequeño cambio, ajústelo o cópielo y agregue una etiqueta. Si ya no desea ver un mapa, archívelo. Y para casos de usos especiales, puede crear un nuevo mapa. |
| Asignaciones de atributos | Los mapas de atributos asocian elementos de recursos FHIR con atributos de Dataverse. Para la ingestión, estos mapas contienen detalles sobre cómo localizar el elemento de datos y su tipo de datos correspondiente en Dataverse. Para la recuperación, los mapas describen cómo transformar el elemento de datos de Dataverse en un nodo de recurso FHIR. Estos mapas comienzan habilitados de forma predeterminada, pero no afectan la sincronización a menos que habilite su mapa de entidad principal. |
Los mapas de atributos predeterminados proporcionan un conjunto de referencia de detalles impulsado por la especificación HL7 para el recurso FHIR principal. A menudo, solo necesita habilitar el mapa de entidad principal, pero puede configurar mapas de atributos, de forma muy similar a los mapas de entidad. Puede deshabilitar los mapas si los datos no son relevantes para la entidad. También puede cambiar desde dónde se recuperan los datos si su sistema difiere de la especificación FHIR. Los mapas de atributos heredan la etiqueta de sus mapas de entidades principales, para ayudarlo a diferenciarlos. |
| Mapas de expansión | Las asignaciones de expansión proporcionan las reglas para transformar datos jerárquicos basados en documentos JSON en el modelo de datos relacionales de Dataverse. | Los mapas de expansión permiten a los administradores convertir atributos JSON complejos en múltiples atributos de Dataverse relacionados. Con los mapas de expansión, puede especificar atributos de vínculo principal para determinar la relación entre los registros principal y secundario. |
| Registros | El kit de herramientas de integración de datos captura los detalles en las actividades de las Dataverse Healthcare API y le permite ver, ordenar y consultar los registros de transacciones. Las entradas de registro no contienen datos de EMR; solo indican lo que las llamadas API intentaron y el resultado. Cada entrada tiene una descripción y más detalles para permitir la resolución de problemas a los administradores y desarrolladores. |
Los registros son la forma en que valida sus asignaciones y supervisa las operaciones de las Dataverse Healthcare APIs y soluciona problemas. Por ejemplo, una entrada de registro con la descripción "Campos obligatorios faltantes" indica que el cambio de datos intentó escribir en una instancia de recurso FHIR, pero no incluyó un valor para un elemento obligatorio. Es posible que vea esta entrada si el formulario de ingreso de datos carece de un campo para ingresar el valor o tiene un campo que permite el envío incluso cuando se deja vacío. La entrada del registro incluirá una lista de campos que faltan, para que pueda encontrar y solucionar el problema rápidamente. |
| Recursos FHIR en Azure | El registro de recursos FHIR de Azure define los recursos FHIR admitidos actualmente en la solución Microsoft Cloud for Healthcare Dataverse . Esta información también es utilizada por las Dataverse Healthcare APIs al transformar datos entre los dos sistemas. | A medida que se expande el modelo de datos de Dataverse, esta lista se actualiza para indicar qué recursos FHIR están disponibles para la integración. |
| Configuración de integración | El kit de herramientas de integración de datos incluye herramientas específicas de cada componente para administrar las opciones de configuración. Estos ajustes indican a Dataverse cómo reconocer los cambios de datos de FHIR y dónde enviar las transacciones de datos de FHIR. También le permiten activar o desactivar la sincronización y establecer el nivel de registro para cada componente. | Permite administrar los componentes de forma individual tanto para las nuevas instalaciones como para las instancias existentes en ejecución. |
| Datos de atención sanitaria | Cuando los pacientes dan su consentimiento para compartir sus datos de atención médica, los administradores pueden verlos en el kit de herramientas de integración de datos. | Visualizar los datos lo ayuda a administrar los flujos de datos y comprender mejor los elementos de registro, y le permite validar sus mapas de datos. |
Asignaciones de entidad
Los asignaciones de entidades son el nivel más alto en el proceso de asignación. Asignan recursos FHIR a sus entidades de Dataverse correspondientes (también conocidas como tablas de Dataverse). Puede asignar un concepto de entidad a varios recursos FHIR. Las asignaciones de entidades ayudan a las Dataverse Healthcare APIs y las tablas de datos de salud virtuales a transformar los datos entre los mensajes FHIR y las entidades de Dataverse. También ayuda a enviar los recursos FHIR correctos de Dataverse a los puntos finales FHIR remotos.
Para ver una lista de todas las asignaciones de entidades, en la aplicación del kit de herramientas de integración de datos, seleccione la navegación Administrador de agentes en la sección Cambiar área y luego seleccione Asignaciones de entidades en Configuración de las asignaciones.
Los mapas de entidad incluidos con el kit de herramientas de integración de datos
El kit de herramientas de integración de datos incluye muchos mapas de entidades integrados, mapas de atributos y mapas de elementos FHIR para los recursos estándar de FHIR que probablemente necesitará. Debido a que el sistema de cada persona es diferente, los mapas de entidades no están habilitados durante la implementación.
- Para habilitar los mapas de entidad que necesita, solo necesita cambiar una configuración específica.
- Para modificar los mapas para que se ajusten a sus sistemas EMR específicos, los mapas del kit de herramientas de integración de datos son muy configurables.
- Si no puede encontrar un mapa específico que se adapte a sus necesidades, es fácil crear sus propios mapas.
Para obtener más información sobre cómo configurar asignaciones de entidades, vaya a Configurar asignaciones de entidades.
La siguiente tabla enumera los mapas de entidades incluidos con el kit de herramientas de integración de datos. Esta tabla incluye los recursos FHIR de nivel raíz, pero no las asignaciones de expansión cubiertas en detalle en Configurar asignaciones de expansión.
| Recurso FHIR en Azure | Entidad de Dataverse | Descripción |
|---|---|---|
| Organización | cuenta | Agrupación de personas u organizaciones reconocidos formal o informalmente que se forma para lograr algún tipo de acción colectiva. Esta agrupación incluye grupos como empresas, instituciones, corporaciones, departamentos, grupos comunitarios y grupos de práctica de atención médica. |
| Paciente | contacto | Datos demográficos y otra información administrativa acerca de una persona o animal que recibe cuidados u otros servicios relacionados con la salud. |
| Médico | contacto | Persona que interviene directa o indirectamente en la prestación de los servicios médicos. |
| AllergyIntolerance | msemr_allergyintolerance | Riesgo de respuesta fisiológica nociva o indeseable, que es única para un individuo y está asociada a la exposición a una sustancia. |
| Cita | msemr_appointmentemr | Evento de atención sanitaria programado para un paciente y/o médicos en el que se puede realizar un servicio en una fecha y hora específicas. |
| CarePlan | msemr_careplan | Describe la intención de cómo uno o varios médicos pretenden prestar atención a un paciente determinado durante un período de tiempo, posiblemente limitada a la atención de una o varias condiciones específicas. |
| CareTeam | msemr_careteam | Incluye a todas las personas y organizaciones que tienen previsto participar en la coordinación y la entrega de atención. |
| Reclamación | msemr_claim | Lista que emite un proveedor con los servicios y productos profesionales que se han suministrado, o se van a suministrar, a un paciente y que se envía a una aseguradora para reembolso. |
| ClaimResponse | msemr_claimresponse | Proporciona los detalles de resolución del procesamiento de un recurso de reclamación. |
| Condición | msemr_condition | Se utiliza para registrar información detallada sobre condiciones, problemas o diagnósticos reconocidos por un médico. |
| Dispositivo | msemr_device | Este recurso identifica una instancia o un tipo de artículo fabricado que se utiliza en la prestación de atención sanitaria sin que cambie sustancialmente a través de esa actividad. El dispositivo puede ser una máquina, un inserto, una computadora o una aplicación. Incluye equipos médicos duraderos (reutilizables) y equipos desechables utilizados para diagnóstico, tratamiento e investigación en materia de atención sanitaria y salud pública. |
| DiagnosticReport | msemr_diagnosticreport | Los hallazgos e interpretación de las pruebas diagnósticas realizadas a pacientes, grupos de pacientes, dispositivos y ubicaciones, y las muestras derivadas de ellos. El informe incluye contexto clínico, como información del solicitante y del proveedor. También incluye una combinación de resultados atómicos, imágenes, interpretación textual y codificada y representación formateada de informes de diagnóstico. |
| Consulta o examen | msemr_encounter | Una interacción entre un paciente y los profesionales sanitarios para prestar servicios sanitarios o evaluar el estado de salud de un paciente. |
| EpisodeOfCare | msemr_episodeofcare | Una asociación entre un paciente y una organización/proveedores de atención sanitaria durante la que pueden producirse encuentros. La organización administradora asuma un nivel de responsabilidad por el paciente durante este tiempo. |
| Objetivo | msemr_goal | Describe los objetivos previstos del plan de atención médica. |
| Grupo | msemr_group | Representa una colección definida de entidades que podrían discutirse o sobre las que se podría actuar colectivamente. No se espera que estas entidades actúen colectivamente y no están reconocidas formal ni legalmente. |
| Ubicación | msemr_location | Detalles e información de posición para un lugar físico en el que se prestan servicios y recursos y se puede almacenar, encontrar, contener o alojar a participantes. |
| Medicación | msemr_medication | Se utiliza para identificar y definir medicamentos, pero también cubre ingredientes y envases. |
| MedicationRequest | msemr_medicationrequest | Un pedido o solicitud para el suministro de la medicación y las instrucciones para la administración de la medicación a un paciente. El recurso se llama "MedicationRequest" en lugar de "MedicationPrescription" o "MedicationOrder". Utilizamos este término para generalizar su uso en entornos de pacientes hospitalizados y ambulatorios, incluidos los planes de atención, y para armonizarlo con los patrones de flujo de trabajo. |
| Observación | msemr_observation | Medidas y afirmaciones simples hechas sobre un paciente, dispositivo u otro sujeto. |
| Procedimiento | msemr_procedure | Acción que se realiza en un paciente. Esta acción puede ser una actividad física, como una operación, o menos invasiva, como orientación o hipnoterapia. |
| RelatedPerson | msemr_relatedperson | Información sobre una persona que participa en la atención médica de un paciente. Esta persona no es el objetivo de la atención médica ni tiene una responsabilidad formal en el proceso de atención. |
| RiskAssessment | msemr_riskassessment | Una evaluación de los resultados probables para un paciente u otro sujeto, así como la probabilidad de cada resultado. |
| Programa | msemr_schedule | Contendor de intervalos de franjas horarias que pueden estar disponible para reservar citas. |
| Intervalo | msemr_slot | Franja horaria en una programación que puede estar disponible para reservar citas. |
Asignaciones de atributos
Las asignaciones de entidades tienen una o más asignaciones de atributos relacionadas que asignan los elementos individuales en el recurso FHIR.
Para ver una lista de todas las asignaciones de entidades, en la aplicación del kit de herramientas de integración de datos, seleccione la navegación Administrador de agentes en la sección Cambiar área y luego seleccione Asignaciones de entidades en Configuración de las asignaciones.
Estos mapas relacionados proporcionan detalles específicos campo por campo sobre qué valores FHIR corresponden a qué valores de columna de Dataverse. Cada asignación de atributos incluye valores de configuración para la asignación de tipos de datos y fragmentos de código JSONPath personalizados para seleccionar el valor correcto de los mensajes FHIR JSON entrantes.
Para obtener más información sobre cómo configurar asignaciones de atributos, vaya a Configurar asignaciones de atributos.
Administrar registros de asignaciones
Los registros de mapas son componentes "conscientes de la solución", lo que significa que un componente de una solución sabe que es parte de esa solución. Nuestras asignaciones saben que son parte del kit de herramientas de integración de datos. Como están en Dataverse, puede utilizar la aplicación de Administración del ciclo de vida (ALM) para administrar de forma segura los cambios que realice en sus tablas de asignación. Esta característa le permite actualizar sus mapas en un entorno de desarrollo, donde puede probar y validar sus cambios de mapa sin poner en riesgo sus sistemas de datos EHR/EMR de producción.
En el pasado, para transferir cambios de mapas entre entornos, tenía que copiar los datos manualmente. Herramientas como la Configuration Migration Tool podrían ayudar, pero era posible cometer errores manuales. Una vez que se haya asegurado de que sus actualizaciones estén listas, puede implementarlas de manera segura en su entorno de producción como un único paquete. ALM le ahorra tiempo y le ayuda a proteger su negocio a medida que evoluciona y crece. Para obtener más información, vaya a Conceptos de solución de ALM.
Puede eliminar cualquier mapa que cree desde cero. Sin embargo, no puede eliminar algunos de los mapas predeterminados de Microsoft Cloud for Healthcare y mantener otros. Puede eliminar todos los mapas predeterminados quitando la solución administrada que se instala.
Los registros de asignación tienen una jerarquía con mapas de entidades en la parte superior (mapas de entidades > mapas de atributos > mapas de valores de atributos). Dataverse no permite eliminar un registro que tenga registros secundarios (registros relacionados en niveles inferiores). Para eliminar un mapa de entidad, primero busque y elimine todos sus mapas secundarios y luego elimine el mapa de entidad.
Si no desea utilizar un mapa predeterminado, puede ocultar el mapa en su entorno archivándolo. Para archivar un mapa de entidad, seleccione el registro de la cuadrícula y luego seleccione el botón Archivar en la barra de comandos. Cuando archiva un mapa, se desactiva y deshabilita automáticamente el mapa de la entidad. También archiva los mapas de atributos y los mapas de valores de atributos de la entidad.
Puede acceder a los mapas archivados cambiando la vista a Mapas de entidad de servicio de actualización archivados.
Puede restaurar los mapas archivados usando el comando Restaurar. Seleccione el mapa de entidad archivado de la cuadrícula y luego seleccione Restaurar en el panel de acciones.
Puede deshacer los cambios en los mapas predeterminados eliminando la capa activa de cambios en la solución de mapas. Los mapas predeterminados se envían como solución administrada. Cuando realiza cambios en esos mapas, estos se aplican en la capa activa (no administrada). Puede usar las capas de solución para revisar las distintas capas y eliminar la capa activa en cualquier momento. Eliminar la capa activa restaura el mapa a la última capa administrada para ese componente. Para obtener más información, vaya a Capas de solución de ALM. Para conocer los pasos para ver las capas de la solución, vaya a Ver capas de solución.
La última versión proporciona etiquetas de mapas de entidades para ayudarle a identificar de manera única los mapas que agrega a las soluciones. Verá la etiqueta al principio del nombre del mapa de entidades y los nombres de sus mapas de atributos y mapas de valores de atributos. Para agregar una etiqueta, edite el atributo Etiqueta en el encabezado de asignación de entidades.
Cada mapa sólo puede tener una etiqueta asignada a la vez.
Registros
Seleccione Registros para ver las transacciones que ocurren dentro de Dataverse. Los registros le ayudan a comprender cómo fluyen los datos, por qué se envía algo a la Dataverse healthcare API y por qué no se envía algo. Proporcionan una vista de las actividades del kit de herramientas de integración de datos.
La sección de registros contiene información sobre cada servicio, incluida la API personalizada.
Recursos FHIR en Azure
El área Recursos FHIR en Azure define el universo de recursos de FHIR. Debido a que no se pueden visualizar las entidades FHIR directamente para ver todos los recursos, el kit de herramientas de integración de datos proporciona la lista de recursos asignados a una entidad de Dataverse. Los recursos de FHIR se utilizan principalmente en asignaciones de entidades.
Configuración de integración
El área Configuración de integración le da acceso a variables de entorno de Dataverse que definen y controlan la integración de Azure FHIR y Dataverse. Debe establecer estas variables para inicializar el kit de herramientas de integración de datos o hacer ajustes si cambia algo en su entorno de Microsoft Cloud for Healthcare.
Para obtener más información sobre la configuración de integración, vaya a Configurar los ajustes de integración para las Dataverse Healthcare APIs y Configurar ajustes de integración para tablas de datos de salud virtuales.
Datos de atención sanitaria
El módulo de Datos de atención médica permite a los administradores de mapas ver e interactuar con los datos del usuario que ingresan al sistema. Esta característica ayuda a los administradores de asignaciones a comprender y solucionar problemas con los datos.
Los administradores de asignaciones pueden usar el módulo de datos de atención médica para:
- Ver los datos.
- Comprenda lo que ocurre a medida que construyen los mapas.
- Asegurarse de que los datos lleguen correctamente y en el campo correcto.
Por ejemplo, para ver la información del paciente:
Seleccione Datos de la atención sanitaria.
En Administración, seleccione Personas.
Cambiar la vista a Vista de FHIR para pacientes.
El administrador de asignaciones puede ver todos los datos de pacientes que fluyen a Microsoft Cloud for Healthcare, como el identificador de FHIR de un paciente, la última sincronización del paciente, si la sincronización está habilitada para ese registro, y la versión de Azure FHIR del registro.
Ejemplo 1: No se ha sincronizado el contacto
Este ejemplo muestra cómo es posible que tenga una entidad Contacto que no se sincroniza cuando intenta sincronizar un registro de paciente que no está habilitado para la sincronización.
Seleccione Datos de la atención sanitaria.
En la Vista FHIR de pacientes, como ejemplo, busque un paciente que no tenga un ID de FHIR de Azure.
Seleccione el registro del paciente y seleccione Editar. Observe que el valor Sincronización de FHIR en Azure habilitada se establece en No.
Cambie el número de teléfono para el paciente y seleccione Guardar.
En la sección Registros:
- Para la columna Descripción para ese registro, seleccione Controlador de eventos de reescritura procesado con éxito.
- Para la Fuente, seleccione Escritura diferida.
- Para Tipo de entidad, seleccione Contacto.
Observe que el registro no tiene una identificación para Id. de recurso FHIR.
Ejemplo 2: Faltan detalles de FHIR del contacto Azure
Para otro ejemplo, intente sincronizar un paciente existente que no tiene ID de FHIR.
Seleccione Datos de la atención sanitaria.
En la Vista FHIR de pacientes, como ejemplo, busque un paciente que no tenga un ID de FHIR de Azure.
Seleccione el registro del paciente y seleccione Editar. Observe que el valor Sincronización de FHIR en Azure habilitada se establece en No.
Actualice el valor Sincronización de FHIR en Azure habilitada para establecerlo en Sí.
Cambie el número de teléfono para el paciente y seleccione Guardar.
En la sección Registros:
- Para la columna Descripción para ese registro, seleccione Proceso de reescritura fallido.
- Para la Fuente, seleccione Escritura diferida.
- Para Tipo de entidad, seleccione Contacto.
El mensaje indica que el contacto no se puede sincronizar con el extremo de FHIR. Este comportamiento se debe a que falta el identificador de Azure FHIR u otra información de la versión de FHIR para un registro existente que se está actualizando. Un ID de Azure FHIR nulo indica que el contacto no se originó en el servidor FHIR, que es un escenario no admitido para el proceso de escritura diferida.
Ejemplo 3: Entradas del registro de escritura diferida
Cuando un registro de contacto tiene una ID FHIR y usted cambia el registro, puede ver dos mensajes de registro. El primer mensaje indica que se ha iniciado el proceso de escritura diferida. El registro titulado Controlador de eventos de escritura diferida Procesado correctamente indica que los cambios están en cola para enviarse de vuelta al punto final FHIR.
Cuando la actualización logra publicarse en el punto de conexión FHIR, puede ver el registro titulado Proceso de reescritura exitoso. Si selecciona esta descripción, verá el mensaje en el registro. El mensaje especifica el atributo cambiado e indica que se ha enviado al punto de conexión FHIR.
Un mensaje de registro final titulado Escribir de nuevo la procedencia del FHIR indica un mensaje de auditoría final publicado en el punto final de FHIR sobre las actualizaciones publicadas recientemente.
Esta combinación de mensajes indica una actualización exitosa del punto final FHIR a través del proceso de escritura diferida.
Ejemplo 4: flujo de consentimiento
En los datos de la atención sanitaria, puede encontrar un registro de paciente con un identificador de FHIR y el valor Sincronización del Id. de FHIR en Azure habilitada establecido en No. Las Dataverse Healthcare APIs tienen un flujo de consentimiento. El flujo de consentimiento entre FHIR y Dataverse asegura que todo el universo de FHIR no termine en Dataverse. Una gran cantidad de datos de pacientes residen en FHIR y usted solo desea tener estos datos en Dataverse cuando trabaja con ese paciente.
Cuando la sincronización de FHIR está habilitada, la Dataverse Healthcare API sincronizará el universo de pacientes con Dataverse. Sin embargo, no sincroniza todos los datos de un paciente con Dataverse a no ser que Azure FHIR Sync habilitado se establezca en Sí. Esta característica se llama flujo de consentimiento porque, por lo general, un paciente debe dar su consentimiento para que su información se introduzca en un sistema. Cuando el paciente da su consentimiento, por ejemplo, en el Portal de acceso a pacientes, para que su información ingrese al sistema, el valor Sincronización de FHIR en Azure habilitada se establece en Sí. Luego, los datos de ese paciente comienzan a fluir hacia el sistema.
Si el valor Sincronización de FHIR en Azure habilitada está establecido en No y realiza un cambio en el registro del paciente, ve una entrada de registro con un mensaje que dice Los datos no se pueden enviar al servidor Azure FHIR, lo que indica que las actualizaciones de la entidad de contacto no se pueden enviar al punto de conexión de FHIR. La configuración de Sincronización Azure FHIR habilitada en No impide que los datos fluyan a FHIR. También evita que FHIR envíe datos a Dataverse para este paciente.
El flujo de consentimiento es exclusivo para pacientes como contactos. Ninguna otra entidad de registro en Dataverse tiene este flujo de consentimiento incorporado.
Mapas de expansión
Los mapas de expansión en el kit de herramientas de integración de adtos permiten a los administradores transformar los datos de FHIR en tablas de Dataverse expandiendo atributos JSON más complejos y expandiéndolos en múltiples registros de Dataverse relacionados.
Por ejemplo, puede usar mapas de expansión para traer identificadores de pacientes y vínculos de pacientes a Dataverse. Para los vínculos de pacientes, los mapas de expansión permiten a los administradores integrar las solicitudes de combinación de pacientes con los siguientes tipos de vínculos:
- Consulte también
- Sustituye a
- Sustituido por
Para obtener más información sobre estos tipos de enlaces, vaya a Tipo de enlace de FHIR. Con los mapas de expansión, puede especificar atributos de vínculo principal para determinar la relación entre los registros principal y secundario.
Para obtener más información sobre las asignaciones de expansión, vaya a Configurar asignaciones de expansión.