Professional Documents
Culture Documents
8
Generador de Sistemas de Historia Clnica
Electrnica openEHR
Autor: Ing. Pablo Pazos Gutirrez
Director en CaboLabs.com
pablo.pazos@cabolabs.com
Traduccin y revisin: Lic. Brbara Cardozo
v1.1
Fecha
Versin
Comentarios
Autor
19-05-2013
1.1
Correcciones menores
Pablo Pazos
06-04-2013
1.0
Primer borrador
Pablo Pazos
2013 CaboLabs.com
ndice:
1. Sobre EHRGen ....................................................................................................................................... 3
1.1. Cdigo abierto .................................................................................................................................. 3
1.2. Licencia ............................................................................................................................................ 3
1.3. Comunidad y soporte gratuito .......................................................................................................... 3
1.4. Soporte comercial ............................................................................................................................ 4
1.5. Casos de xito.................................................................................................................................. 4
2. Gua de EHRGen .................................................................................................................................... 5
2.1. Instalacin y requerimientos............................................................................................................. 5
2.1.1. Requerimientos.......................................................................................................................... 5
2.1.2. Instalacin y ejecucin:.............................................................................................................. 6
2.2. Arquitectura ...................................................................................................................................... 7
2.2.1. Modelo de seguridad ................................................................................................................. 7
2.2.2. Modelo de datos ........................................................................................................................ 8
2.3. Gestin de pacientes...................................................................................................................... 12
2.3.1. Admisin y gestin de pacientes ............................................................................................. 12
2.4. Integracin y Extensin de EHRGen.............................................................................................. 13
2.4.1. Integracin ............................................................................................................................... 13
2.4.2. Multilenguaje (internacionalizacin)......................................................................................... 13
2.4.3. Terminologa............................................................................................................................ 13
2.4.4. Extensin ................................................................................................................................. 13
Anexo A: Gestin de dominios, flujos de trabajo y definiciones de registros clnicos............................... 14
A.1. Gestin de registros clnicos y flujos de trabajo............................................................................. 14
A.2. Definiendo el registro clnico desde cero ....................................................................................... 21
2013 CaboLabs.com
1. Sobre EHRGen
EHRGen es un marco de trabajo de cdigo abierto que permite crear sistemas de Historia Clnica
Electrnica orientados a la gestin del conocimiento. Con EHRGen puede crear sistemas completos de
HCE sin tener que comenzar desde cero. Adems es una herramienta altamente configurable y
extensible, que implementa el estndar openEHR y est diseada para soportar otros estndares como
HL7 y DICOM.
1.2. Licencia
EHRGen puede utilizarse bajo la licencia Apache 2.0, que garantiza el copyright del cdigo fuente a
quin lo desarroll, y la capacidad de copiarlo, modificarlo y distribuirlo, siempre y cuando se conserven
las notas de copyright y licencia en el cdigo distribuido, atribuyendo el trabajo original a los autores
originales. Para esto, todos los cambios y agregados al cdigo fuente original deben estar claramente
marcados. Los contribuidores al proyecto conceden automticamente una licencia sobre sus
modificaciones a los autores originales.
Por ms informacin:
http://www.apache.org/licenses/LICENSE-2.0.txt
http://www.oss-watch.ac.uk/resources/apache2
2013 CaboLabs.com
http://www.youtube.com/user/TheSOStelemedicina
http://www.redclara.net/news/Presentaciones_dvs/Hector_Arrechedera.pdf
https://github.com/sostelemedicina/SOS-HME
2013 CaboLabs.com
2. Gua de EHRGen
2.1. Instalacin y requerimientos
EHRGen requiere cierto software de base para poder ser instalado y ejecutado correctamente. A
continuacin se lista el software de base, en orden de instalacin, y se ofrecen links a los sitios oficiales
donde encontrar guas y archivos de instalacin. Si ud. ya cuenta con el software de base, no es
necesario reinstalarlo.
Los siguientes puntos se han creado bajo el supuesto de que el lector posee conocimientos mnimos
sobre descargar archivos de internet, descompresin de archivos (ZIP, TAR.GZ), instalacin de
programas, y configuracin de variables de entorno.
2.1.1. Requerimientos
1. JDK6:
a. instalacin pgina de Oracle (ingls)
b. instalacin paso a paso (ingls)
c. Modificar variables de entorno en Windows:
i.http://vlaurie.com/computers2/Articles/environment.htm
2. Grails 1.3.7 (no funciona en Grails 2.x)
a. descarga
b. instalacion
3. Base de datos: (una sola opcin)
a. MySQL: http://www.mysql.com/downloads/mysql/
b. PostgreSQL: http://www.postgresql.org/download/
4. Configurar conexin a la base de datos en::
a. ehrgen/grails-app/config/Datasource.groovy
b. Aqu encontrar ms informacin sobre cmo configurar la conexin con la base de
datos:
i. https://code.google.com/p/open-ehr-genframework/wiki/ConfiguracionBasesDeDatos
c. Por defecto el framework viene configurado para utilizar MySQL con una base de datos
llamada oehr_dev, NO OLVIDE modificar el nombre de usuario y clave de su base de
datos previamente a ejecutar EHRGen.
Ms informacin:
http://code.google.com/p/open-ehr-gen-framework/wiki/Instalacion
https://code.google.com/p/open-ehr-gen-framework/wiki/ConfiguracionBasesDeDatos
2013 CaboLabs.com
2013 CaboLabs.com
Aumente la memoria Xmx y MaxPermSize y vuelva a correr EHRGen utilizando Grails. Mantenga
VisualVM abierto para controlar el uso de memoria, y verificar los nuevos parmetros de ejecucin de
Grails, tal como se muestra en la siguiente imagen:
2.2. Arquitectura
Si desea saber ms sobre las funcionalidades bsicas de EHRGen y su arquitectura, se recomienda leer
el artculo presentado en el Congreso Argentino de Informtica en Salud (CAIS) 2012:
http://www.41jaiio.org.ar/sites/default/files/15_CAIS_2012.pdf
http://code.google.com/p/open-ehr-gen-framework/wiki/Seguridad
2013 CaboLabs.com
Etapas, las cuales representan las distintas etapas del proceso asistencial. Cada flujo de trabajo est
asociado a un conjunto de Roles de usuario, que habilita a los usuarios que tengan uno de esos roles a
ejecutar el flujo. Esta caracterstica es parte del modelo de seguridad mencionado en el punto anterior.
Por ejemplo, el dominio de Atencin de Urgencia, puede tener un flujo de trabajo definido para el rol
Mdico y otro para el rol Enfermera. El flujo mdico, consta de las etapas: anamnesis, evaluacin
clnica, orden de estudios, indicaciones y resumen de la atencin.
Tanto los flujos de trabajo como sus etapas son totalmente configurables en EHRGen, pudiendo definir
flujos simples o complejos, asociados a uno o ms roles para cada dominio. En el Anexo A podr
encontrar la gua para gestionar dominios, flujos de trabajo y definiciones de registros clnicos.
http://www.openehr.org/releases/1.0.2/architecture/overview.pdf
2013 CaboLabs.com
EHRGen utiliza las restricciones definidas en los arquetipos openEHR para validar los datos ingresados
por los usuarios en los formularios de registro, y con los datos crea estructuras de registro clnico que
sern almacenadas en la base de datos. Las estructuras de registro de datos siguen el modelo de
informacin del estndar openEHR 2 , lo que garantiza que la informacin puede ser extrada,
transformada y comunicada a cualquier sistema, utilizando cualquier formato de intercambio, por
ejemplo HL7 3 .
Mientras el registro se encuentre en estado incompleto, el usuario podr registrar nueva informacin y
editar la actualmente registrada. Cuando se firma el registro, ste se cierra. A un registro cerrado no se
le puede registrar ms informacin o editar la informacin que contiene.
2
3
http://www.openehr.org/releases/1.0.2/architecture/rm/ehr_im.pdf
http://www.hl7.org
2013 CaboLabs.com
10
http://code.google.com/p/open-ehr-gen-framework/wiki/ProcesosAsistencialesTrazabilidad
http://code.google.com/p/open-ehr-gen-framework/issues/detail?id=106
Authorization: representa las credenciales de seguridad que garantizan que el usuario es quien
dice ser.
Dominio (Domain)
Etapa (Stage)
Plantilla (Template)
Arquetipo (Archetype)
2013 CaboLabs.com
11
Manteniendo la informacin de los pacientes de forma local, EHRGen trabaja como un sistema
autocontenido. Si la informacin de los pacientes se mantiene en un sistema externo, EHRGen se
conecta al sistema externo y utiliza su informacin. Este segundo modo de funcionamiento permite
integrar una Historia Clnica Electrnica EHRGen a un sistema de informacin existente, de modo de no
duplicar datos, garantizando que stos estn actualizados y sean correctos.
EHRGen permite crear listas de admisin que contienen la informacin de los pacientes que un mdico
debe atender. Estas listas de admisin se gestionan de distintas formas segn el modo de
funcionamiento. Con informacin de pacientes local, un usuario administrativo debe crear las
admisiones dentro de EHRGen. Con informacin de pacientes en sistemas externos, un sistema externo
se encarga de la admisin y notifica a EHRGen cuando hay un paciente nuevo para atender. EHRGen
agrega al paciente a la lista de admisin correspondiente.
2013 CaboLabs.com
12
2.4.3. Terminologa
EHRGen cuenta con un servicio terminolgico interno, capaz de ser extendido para consultar servicios
externos. Este servicio resuelve los trminos solicitados ya sea por nombre o por cdigo, y soporta la
solicitud de nombres o descripciones de conceptos en distintos idiomas.
2.4.4. Extensin
EHRGen implementa un mecanismo de extensin de la funcionalidad del framework mediante la
ejecucin de eventos. Un desarrollador puede agregar eventos propios, por ejemplo para enviar
notificaciones a sistemas externos.
http://code.google.com/p/open-ehr-genframework/source/browse/#svn%2Ftrunk%2Fehrgen%2Fsrc%2Fgroovy%2Fevents%253Fstate%253Dcl
osed
2013 CaboLabs.com
13
2013 CaboLabs.com
14
Fig. A.3: Listado de registros, para el paciente seleccionado, en todos los dominios
Desde el escritorio clnico (fig. A.1) es posible crear nuevos dominios. En la fig. A.4 se muestra la
pantalla de creacin de dominios, donde el nico dato necesario es el nombre del dominio. Slo
usuarios con los permisos correspondientes pueden crear nuevos dominios.
2013 CaboLabs.com
15
Desde el escritorio clnico (fig. A.1) se puede acceder a la seccin de administracin de arquetipos. La
primer pantalla que se muestra es el listado de arquetipos cargados (fig. A.5). Desde esa pantalla es
posible agregar nuevos arquetipos, tal como se muestra en la fig. A.6. Para los arquetipos de
instrucciones, se solicita adems seleccionar qu roles vern las rdenes, prescripciones, pedidos e
instrucciones creados utilizando este arquetipo (ver fig. A.7). Esto es parte de la gestin de rdenes que
ser implementada en la prxima versin de EHRGen (ver seccin 2.2.2.6).
2013 CaboLabs.com
16
Fig. A.7: Seleccin de roles para ejecucin de la instruccin definida por un arquetipo agregado
2013 CaboLabs.com
17
Desde el escritorio clnico (fig. A.1.) es posible crear nuevas definiciones de registros clnicos, es decir
plantillas. Cada plantilla representa un formulario para ingreso de datos dentro de una etapa de un flujo
de trabajo (ver seccin 2.2.2).
En la figura A.8 se muestra la pantalla de creacin de plantillas donde se debe ingresar un identificador
y un nombre para la nueva plantilla, y seleccionar un arquetipo que define la estructura interna del
registro clnico. Una vez creada la plantilla puede ser agregada a un flujo de trabajo desde la edicin de
un dominio (figs. A.9 y A.10). Al crear una plantilla, EHRGen genera la interfaz de usuario para el
ingreso, visualizacin y edicin de datos, utilizando las definiciones de los arquetipos referenciados.
En la fig. A.10 se muestra la pantalla de edicin de un dominio, donde se pueden agregar flujos de
trabajo, etapas a los flujos y asociar las etapas con plantillas. Cada entidad se identifica con su icono
respectivo (ver seccin 2.2.2.8).
2013 CaboLabs.com
18
2013 CaboLabs.com
19
2013 CaboLabs.com
20
En estos cinco pasos se pueden crear todos los elementos necesarios para la definicin de un registro
clnico completo dentro de EHRGen. Luego, al ingresar a un dominio, podr ver un flujo de trabajo
distinto segn el rol que tenga, y ver todas las etapas y registros clnicos para comenzar a ingresar
datos.
Por ahora slo se soportan arquetipos de SECTION o ENTRY (OBSERVATION, EVALUATION, INSTRUCTION
y ACTION), por lo que los arquetipos que se agreguen al sistema deben ser de estos tipos y no contener SLOTS a
arquetipos de otras clases como ITEM_STRUCTURE, CLUSTER, etc.
2013 CaboLabs.com
21