HCEService

Para comprender el funcionamiento de HCEService, es necesario visualizarlo como la capa de servicios de «trastienda» o el motor de comunicación que alimenta la Historia Clínica Electrónica de Aragón.

Dentro de la arquitectura de GUHARA, HCEService es un componente crítico que permite la interoperabilidad interna y externa. Su funcionamiento se detalla en los siguientes puntos:

1. Naturaleza Técnica: La Capa de Servicios Web

HCEService es una aplicación Java independiente dentro del ecosistema de HCE que publica Servicios Web (Web Services).

  • Protocolos: Utiliza principalmente servicios basados en SOAP o REST para recibir y enviar datos.
  • Uso Interno: Es consumida por otros módulos de la propia arquitectura (como Consultahce o hceconnect) para realizar operaciones que requieren lógica de negocio compleja o acceso a datos que no residen en la base de datos local de HCE.

2. Flujo de Recuperación de Información

Su funcionamiento principal ocurre cuando un profesional sanitario abre el visor de GUHARA y solicita ver datos que están «vivos» en otros sistemas. El proceso sigue este orden:

  1. Petición: El usuario solicita, por ejemplo, los últimos resultados de laboratorio de un paciente.
  2. Intermediación: La interfaz de HCE no va directamente a la base de datos de laboratorio; en su lugar, hace una llamada a HCEService.
  3. Consulta: HCEService sabe a qué sistema externo (como Modulab para analíticas o el RIS para radiología) debe preguntar.
  4. Transformación: HCEService recibe los datos del sistema externo, los «traduce» al formato estándar de GUHARA y los devuelve para que se muestren de forma uniforme en el visor.

3. Integración con el Gestor Documental

Una de las funciones más importantes de HCEService es la gestión de la documentación clínica:

  • Recuperación de PDFs: Se encarga de conectar con el Repoinformes (Repositorio de Informes) para recuperar los documentos firmados digitalmente.
  • Gestión de Plantillas: HCEService interactúa con el módulo de plantillas para asegurar que, cuando un facultativo rellena un formulario, los datos se guarden correctamente siguiendo la jerarquía de Plantilla-Arquetipo-Dato Básico.

4. Seguridad y Trazabilidad (Auditoría)

Dado que HCEService maneja el flujo de datos sensibles entre sistemas, incorpora mecanismos de seguridad estrictos:

  • Uso de Tokens: Como se ha mencionado anteriormente, las llamadas a HCEService suelen estar protegidas por tokens de seguridad para asegurar que solo aplicaciones autorizadas puedan pedir datos.
  • Logging: Todas las transacciones que pasan por HCEService se registran mediante log4j, permitiendo auditorías para saber exactamente qué servicio solicitó qué información de qué paciente.

5. Diferencia con hceeventos

Es común confundirlos, pero funcionan de forma distinta:

  • hceeventos: Funciona de forma asíncrona. «Escucha» cambios (como una fusión de pacientes o un alta) y los guarda.
  • HCEService: Funciona de forma síncrona. El usuario pide algo y el servicio responde en ese momento con la información solicitada.

En resumen, HCEService es el facilitador de datos; es el componente encargado de que la información clínica fluya entre los distintos silos departamentales y se presente al médico de forma coherente y en tiempo real.