Artículo
· 30 sep, 2024 Lectura de 3 min

Herramientas de desarrollo para la visibilidad de la transformación IRIS CCDA a SDA

Existen muchas aplicaciones para trabajar con mensajes HL7 V2, pero las herramientas para trabajar con XML en el Portal de Gestión o los IDE de IRIS son limitadas. Aunque hay muchas utilidades externas e IDEs que funcionan con mensajes XML e incluso documentos C-CDA, hay una razón convincente para poder hacer pruebas directamente en el marco de trabajo C-CDA de IRIS.

Hacer pruebas dentro del entorno de IRIS os proporciona el contexto necesario:

  • Configuración del analizador XML
  • Contexto del espacio de nombres XML
  • Configuración de facilidades y OID
  • Manejo de cabeceras IHE
  • Los paquetes HS.IHE.Util, HS.Util.XSLTTransformer y %XML.XSLT.Transformer
  • Aprovechamiento de la base de código XSL en /csp/xslt

El paquete CCD DevTools os proporciona una API que expone capacidades básicas de XSL y XPath dentro de IRIS. Una interfaz sencilla facilita tareas comunes de los desarrolladores de C-CDA, como la evaluación de XPath y la modificación del documento fuente para ciclos de prueba iterativos. La ejecución ocurre dentro de IRIS para aprovechar el entorno, mientras que la interfaz os permite visibilidad, repetitivilidad y la capacidad de aislar modificaciones y módulos para pruebas.

Primeros Pasos: 

  1. La solución CCD DevTools está disponible en Open Exchange: CCD DevTools
  2. Una vez instalada, la interfaz se ejecuta en un contenedor Docker. Seguid las instrucciones en el archivo README para construir y arrancar Docker.
  3. Abrid la interfaz en: http://localhost:4000
  4. Los CCDs de ejemplo están incluidos en la carpeta de pruebas: iris-ccd-devtools/testing/sample_dat

Página Home:

Evaluador XPath

  • Un conjunto de XPaths preconfigurados os proporciona el formato esperado para los XPaths de CCD en IRIS.
  • Podéis pegar y editar valores de XPath adicionales.
  • Se puede cargar un documento fuente desde un archivo local o pegarlo en la ventana.
  • Se pueden hacer modificaciones manuales al documento fuente para volver a hacer pruebas.


El botón "Viewer" alterna entre una vista del documento con formato agradable y colapsable, y la vista de texto sin formato. La vista de texto es editable.


Transformaciones de CCDA a SDA

Esta ventana os permite seleccionar una de las transformaciones XSL base estándar de IRIS y aplicarla al documento de entrada. El resultado contiene la salida en formato SDA.

Podéis hacer modificaciones al documento de entrada y volver a enviarlo para evaluar cómo los cambios afectan al resultado.


El botón "Viewer" puede usarse tanto en la entrada como en la salida para una mejor visibilidad.


Prueba de Plantillas XSL

Construir transformaciones de C-CDA a SDA normalmente implica escribir plantillas XSL modulares que actúan sobre un XPath específico o una sección del documento fuente. El objetivo del tester de plantillas XSL es permitiros escribir o pegar el contenido de una plantilla en la ventana de prueba y aplicarla a un documento fuente.

La plantilla se evalúa junto con la plantilla de identidad, de modo que solo se modificará la ubicación objetivo.


Con una mejor visibilidad de los documentos de entrada y salida, y la capacidad de hacer pequeñas modificaciones y volver a probar, la interfaz de CCD DevTools tiene como objetivo acelerar el ciclo de construcción/pruebas unitarias para las transformaciones de CCD, así como reducir la curva de aprendizaje para que los desarrolladores adquieran conocimientos del dominio y se familiaricen con el trabajo con los formatos C-CDA y SDA en IRIS.

¿Habéis trabajado con CCDs? ¿Qué herramientas habéis utilizado? ¿Qué modificaciones o adiciones futuras podrían hacer que esta herramienta sea más eficaz para vuestros casos de uso?

¡Nos encantaría recibir vuestros comentarios!

Comentarios (0)1
Inicie sesión o regístrese para continuar