Sintaxis y configuración de plantillas

Sintaxis y configuración de plantillas Historial de versiones Versión Versión Fecha Notas Responsable documento framework 1.0 0.1 30-10-2010 Versión inicial Pablo Pazos Gutiérrez (pablo.swp@gmail.com Índice Sintaxis y configuración de plantillas...1 Historial de versiones...1 Índice...1 1. Introducción...2 1.1 Sintaxis para plantillas...2 1.1.1 Cabezal:...2 1.1.2 Cuerpo:...3 1.1.3 Referencias a arquetipos:...3 1.1.4 Referencias a nodos del arquetipo:...3 1.1.5 Transformaciones:...4 1.1.6 Sobreescrituras:...4 1.2 Configuración de plantillas dentro del framework...5 1.2.1 Identificación de las plantillas...5 1.2.2 Ubicación de los templates...5 1.2.3 Inclusión de las plantillas en la aplicación...6

1. Introducción Las plantillas o templates, son metadatos de alto nivel que, junto a los arquetipos y a las terminologías clínicas, forman la Base de Conocimiento Clínico (CKB). Los templates sirven para modelar pantallas de registro de información clínica. Las pantallas se crean a partir de un conjunto de arquetipos (que modelan los conceptos clínicos) que son referenciados desde cada template. Los templates, luego de ser definidos, deben ser configurados en el framework para que éste genere una entrada en el menú, que permita acceder a las pantallas que modelan estos templates. Si bien OpenEHR propone una sintaxis para la definición de templates, su especificación está en desarrollo, y la sintaxis propuesta es muy compleja. Aquí se propone una sintaxis de templates más simple, que considera las necesidades particulares para la generación de pantallas de éste framework. Igualmente, la sintaxis propuesta es suficientemente genérica y fácilmente extensible a otras realidades, ya que está basada en XML. En este documento se especifica la sintaxis para los templates y la forma de configurarlos dentro del framework. 1.1 Sintaxis para plantillas En los templates se incluye toda la información que no se encuentra en los arquetipos, y que a su vez es necesaria para generar la interfaz de usuario (pantallas de registro de datos clínicos). Entre esta información se encuentra: la inclusión de arquetipos la inclusión/exclusión de nodos particulares de un arquetipo la selección de los controles que se mostrarán en los formularios La inclusión/exclusión de nodos de un arquetipo permite, que al tener un arquetipo muy complejo, se puedan utilizar solo las partes del arquetipo necesarias para un contexto determinado. Pudiendo reutilizar el mismo arquetipo para su aplicación en diversos contextos. La sintaxis aquí propuesta para los templates, se basa en XML. Tiene un cabezal con información del propio template, y un cuerpo donde se define la inclusión de arquetipos. A continuación se describe esta sintaxis en detalle. 1.1.1 Cabezal: El cabezal incluye el identificador de la plantilla y su nombre en texto libre para facilitar la comprensión por humanos. <template> <id>evaluacion_primaria-via_aerea</id> <name>evaluacion de vía aérea (a1)</name>

...  </template> 1.1.2 Cuerpo: El cuerpo tiene dos secciones, la primera es la referencia al arquetipo raíz, y la segunda la lista de referencias a los arquetipos incluidos en el arquetipo raíz. Esta notación alcanza para modelar el árbol de arquetipos a utilizar, ya que los arquetipos utilizados por el framework tienen como máximo un nivel de anidamiento (característica a mejorar para conseguir N niveles de anidamiento).  <root_archetype>  </root_archetype> <included_archetypes>  </included_archetypes>  1.1.3 Referencias a arquetipos: Las referencias a arquetipos indican: el tipo del concepto general del arquetipo ( observation en este caso) el identificador del arquetipo ( openehr-ehr-observation.frecuencia_cardiaca.v1 en este caso) la ubicación en pantalla de los controles que se generen a partir de este arquetipo (uno de left, right, content o bottom ) una bandera que indica si se incluyen todos los nodos del arquetipo en la generación de la interfaz de usuario (en caso de que includeall sea true, no se deben especificar referencias a los nodos del arquetipo). <archetype type="observation" id="openehr-ehr-observation.frecuencia_cardiaca.v1" pagezone="left" includeall="true">  </archetype> 1.1.4 Referencias a nodos del arquetipo: Las referencias a nodos son las que especifican que nodos del arquetipo estarán representados en la interfaz de usuario. Cada nodo es referenciado mediante su ruta dentro del arquetipo (cada

nodo del arquetipo es identificado por su ruta desde la raíz). A su vez se pueden definir transformaciones y sobrescribir los nombres de los controles generados a partir de este nodo. <field path="/data[at0001]/events[at0002]/data[at0003]">  </field> 1.1.5 Transformaciones: Una transformación permite indicar que el valor ingresado por el usuario para el campo referenciado mediante una determinada ruta, se le debe aplicar una transformación para ser almacenado en la base de datos. En este ejemplo, el valor ingresado por el usuario será dividido entre 60 para ser ingresado en la base de datos. Esta característica es útil para realizar transformaciones entre distintas unidades de medida, aunque se debe tener cuidado porque las transformaciones pueden acarrear errores debido al truncamiento o redondeo de los decimales. Por ejemplo si x/60 = y, puede darse que y*60!= x. <transform path="/data[at0001]/events[at0002]/data[at0003]/item[at0004]/value/magnitude" operation="/" operand="60" /> 1.1.6 Sobreescrituras: Este elemento sirve para sobrescribir la etiqueta de un campo del arquetipo referenciado por su ruta dentro del arquetipo. En este ejemplo, la ruta referencia a un nodo cuyo campo units está en Hz, y se desea expresar el mismo en ciclos por minuto (CPM), donde 1 CPM equivale a 1/60 Hz (ver ejemplo previo de transformaciones ). Entonces en pantalla se verá CPM en lugar de Hz, siendo Hz la unidad que está especificada dentro del arquetipo para el nodo con ruta /data[at0001]/events[at0002]/data[at0003]/item[at0004]/value/units. <overwrite path="/data[at0001]/events[at0002]/data[at0003]/item[at0004]/value/units" with="cpm" /> En las próximas versiones de la sintaxis de templates, se buscará incluir formas de especificar condiciones de validación complejas (para validar datos ingresados para múltiples arquetipos), permitir mayor parametrización para la generación de pantallas (definir tipo de cada control, aspecto, controles ocultos, etc.). Otro aspecto interesante para extender las plantillas, es para calcular indicadores en base a la información registrada para los arquetipos referenciados.

1.2 Configuración de plantillas dentro del framework En esta sección se especifican las convenciones usadas en cuanto a la identificación de los templates, a su nombrado, a su ubicación dentro del framework, y a cómo son incluidas y usadas dentro del mismo. 1.2.1 Identificación de las plantillas El identificador de las plantillas está formado por el nombre (puede corresponder con el nombre de la etapa del proceso asistencial a la que pertenece el registro), y el nombre de la pantalla de registro particular que representa la plantilla. Por ejemplo, la Base de Conocimiento Clínico de una Historia Clínica Electrónica para emergencia en trauma, cuenta con las siguientes plantillas: ADMISION-contexto_del_evento ADMISION-prehospitalario INGRESO-triage ANAMNESIS-resumen_clinico EVALUACION-PRIMARIA-via_aerea EVALUACION-PRIMARIA-columna_vertebral EVALUACION-PRIMARIA-ventilacion EVALUACION-PRIMARIA-estado_circulatorio EVALUACION-PRIMARIA-disfuncion_neurologica PARACLINICA-pedido_imagenes PARACLINICA-pedido_laboratorio EVALUACION-SECUNDARIA-exposicion_corporal_total DIAGNOSTICO-diagnosticos COMUNES-movimiento_paciente 1.2.2 Ubicación de los templates La convención utilizada ubicar los templates dentro de la aplicación es que todos sean guardados en el directorio /templates/hce/dominio de la misma. Donde dominio define el contexto de aplicación de las plantillas, como puede ser emergencia, internación, ambulatorio, etc. De esta forma, el gestor de plantillas puede buscar y cargar plantillas desde ese directorio, cuando estas sean solicitadas por el framework. El nombre de los archivos de plantillas es _identificador_plantilla_.xml, donde _identificador_plantilla_ es el identificador de la plantilla en cuestión.

1.2.3 Inclusión de las plantillas en la aplicación La inclusión de plantillas en la aplicación se realiza mediante configuración en el archivo de configuración de la aplicación ( /grails-app/conf/config.groovy ). En este archivo se define una estructura que a cada etapa le hace corresponder un conjunto de registros o subetapas, donde el nombre de la etapa y el nombre del registro forman el nombre de la plantilla correspondiente. A continuación se muestra un ejemplo de configuración: templates { hce { trauma { INGRESO ADMISION = ['triage'] = ['prehospitalario', 'contexto_del_evento'] ANAMNESIS = ['resumen_clinico'] EVALUACION_PRIMARIA = ['via_aerea', 'columna_vertebral', 'ventilacion', 'estado_circulatorio', 'disfuncion_neurologica'] PARACLINICA = ['pedido_imagenes', 'pedido_laboratorio'] EVALUACION_SECUNDARIA = ['exposicion_corporal_total'] DIAGNOSTICO = ['diagnosticos'] COMUNES = ['movimiento_paciente'] emergencia_general { // etapas de otro proceso asistencial internacion_cti { // etapas de otro proceso asistencial ambulatorio { // etapas de otro proceso asistencial En este caso, los nombres de las etapas del proceso asistencial son: INGRESO ADMISION ANAMNESIS EVALUACION_PRIMARIA PARACLINICA EVALUACION_SECUNDARIA DIAGNOSTICO COMUNES Esta estructura sirve para integrar las plantillas al sistema de registro clínico, ya que a partir de los nombres de etapas se forma el menú principal de la interfaz de usuario. Si la etapa seleccionada tiene más de un registro o subetapa, en la interfaz de usuario es verá un menú de registro que permite navegar entre los distintos registros de la etapa actual (ver fig. f63).

De esta forma se integran las plantillas a la aplicación y mediante la selección de los registros desde el menú de registro, se generan dinámicamente los formularios de ingreso de información clínica.