Negonation Blog » Programación

Ejemplo completo de integración de Tractis Identity con asp.net c#

Jose Luis Gordo Romero — Thu, 03 Mar 2011 13:56:47 +0000

Nos complace anunciar el gran trabajo realizado por David Marzo: una demo completa de integración de las verificaciones de identidad de Tractis en asp.net c#. Desde aquí, ¡muchas gracias! por compartir el código con el resto de la comunidad y montar un sitio demo.

Puedes probar el ejemplo en vivo y en directo en la siguiente dirección:

http://extranet.solnatec.com/tractis/

Y descargar el código fuente desde el proyecto de github:

https://github.com/dmarzo/Tractis_aspnet_demo

La lista de Módulos de Autenticación Tractis para distintos lenguajes, frameworks y CMS’s sigue creciendo. Nunca antes añadir autenticación con certificados electrónicos a tu sitio web fue tan sencillo.

Sé el próximo en integrarte

Si decides integrar en algún proyecto las verificaciones de identidad de Tractis no dudéis en contárnoslo. Nos encantará ver cómo lo habéis hecho

Adáptalo a tu lenguaje/framework/cms favorito

Si tienes en mente crear nuevos plugins para Tractis Identity, ya sea para un lenguaje, un framework, un CMS o… lo que sea, revisa la documentación disponible y coméntanos tu idea. Intentaremos ayudarte en todo lo que podamos.

Tractis Identity: Autenticación con DNI-e en PHP

Jose Luis Gordo Romero — Fri, 21 Aug 2009 11:29:58 +0000

Siguiendo con la serie de desarrollos de integraciones con Tractis Identity, hoy anunciamos una clase + ejemplo para la integración de sitios desarrollados con PHP.

El por qué de desarrollar una clase genérica para el lenguaje de programación PHP, es para facilitar el trabajo a aquellas webs que no usan uno de los frameworks con plugins desarrollados (como Rails o CakePHP), y servir como base a futuros desarrollos de integraciones más complejas.

El código necesario para ofrecer autenticación en tu sitio web se reduce a unas pocas líneas de código:

Creación del objeto tractis_identity
Generación del formulario
Comprobación de la validación

// tractis_identity contructor class (api_key, notification_callback, public_verification (true/false), image_button_url)
$tractis_identity = new tractis_identity ("Your API KEY HERE", $notification_callback, "false", "/your/url/to/images/trac_but_bg_lrg_b_en.png");

// print auto-generated form
echo $tractis_identity->show_form();

// Check the auth
if ($user = $tractis_identity->check_auth()) {
   // Correct auth, User info from Tractis on $user array
   print_r($user);
} else {
   // Not tractis auth
}

Hemos liberado el código de esta librería para que podáis revisarlo y adaptarlo a lo que necesitéis. Tenéis toda la información sobre esta librería en la sección correspondiente de la ayuda de Tractis. Desde allí podréis acceder también al repositorio donde lo hemos publicado.

Pruébalo, te llevará 10 minutos realizar la integración en tu sitio y darle valor añadido ofreciendo autenticación con DNI-e (y otros certificados) con la máxima seguridad y completamente gratis.

Tractis Identity: Autenticación con DNI-e en Java

David García — Fri, 14 Aug 2009 07:58:56 +0000

Estamos muy contentos con la gran acogida que está recibiendo Tractis Identity. Tras los plugins de Drupal, Rails y CakePHP, hoy hacemos lo propio con Java.

En el caso de Java estamos hablando de un lenguaje y no de un CMS (Drupal) o de un framework (Rails, CakePHP), así que hemos querido acotar la cosa a un escenario mas concreto. Para ello hemos creado una serie de taglibs para JSP que permitan integrar de manera sencilla los servicios de identidad en una plataforma web basada en J2EE.

De este modo la integración se simplifica al extremo quedando como única dificultad definir dentro de tu página de login

<%@ taglib uri="/taglib.tld"  prefix="tractis" %>

Pon aquí tu código html....

y otra página a donde Tractis redirija el resultado de la verificación. Esta página solamente debe contener el código

<%@ taglib uri="/taglib.tld"  prefix="tractis" %>

 Pon aquí tu código HTML...

En este último caso este tag automáticamente efectúa las validaciones internas pertinentes contra Tractis y pone en sessión los atributos recuperados.
A partir de ahí la cosa es tan simple como coger los atributos y usarlos.


<%= session.getAttribute("tractis:attribute:name") %>

Hemos abierto el código de esta librería para que podáis usarlo y modificarlo para adaptarlo a lo que necesitéis. Tenéis toda la información sobre esta librería en la sección correspondiente de la ayuda de Tractis. Desde allí podréis acceder también al repositorio donde lo hemos publicado.

Ya no hay excusas para ofrecer autenticación con DNI-e (y otros certificados) con la máxima seguridad y completamente gratis en vuestro sitio web.

Tractis Identity: Integración con el componente Auth de CakePHP

David Blanco — Fri, 07 Aug 2009 16:18:02 +0000

Javier Matíes no para. Tras desarrollar la integración de Tractis Identity con CakePHP, hoy mismo ha anunciado en su blog la integración de Tractis Identity con el componente Auth de Cake PHP. En otras palabras, ahora dispones de código específico para integrar Tractis Identity con el sistema de autenticación de usuarios en CakePHP. Aquí tenéis un ejemplo de uso con el código en acción.

Mmmmm… Ahora, el pastel, aún más rico. ¡Gracias Javier!

Tractis Identity: Autenticación con DNI-e en CakePHP

David Blanco — Wed, 05 Aug 2009 06:00:57 +0000

Solo 10 días después del lanzamiento de Tractis Identity, del plugin para Drupal y del plugin para Rails. Javier Matíes, freelance especializado en desarrollo web, ha creado un plugin para CakePHP, su framework favorito, y ha compartido el código con el resto de la comunidad. Desde aquí, ¡muchas gracias!. Javier también ha montado un ejemplo de Tractis Identity funcionando con CakePHP en la dirección: http://wifi.planetalmeria.com/usuarios/tractis.

Si no sabes de qué estamos hablando, Tractis Identity es el nuevo servicio de Tractis que te permite verificar la identidad real de tus usuarios haciendo uso del DNI-e y otros certificados y de forma completamente gratuita. Con Tractis Identity puedes crear “Verificaciones de Identidad” que luego puedes utilizar, tanto para ofrecer “Pasarelas de autenticación”, como para crear “Perfiles certificados” en tu página web donde tus usuarios puedan mostrar su identidad real.

Aunque ha pasado muy poquito tiempo desde el lanzamiento, ya puedes ver Tractis Identity en acción en varios sitios web. Échale un ojo a la Pasarelas de autenticación creadas sobre Drupal en el sitio web de Atenea Tech y en la intranet de Crisalia Servicios Financieros y a los Perfiles certificados creados con Tractis Identity sobre Rails en Todosiniestros.com y Mercadelia.

El plugin de CakePHP es el segundo plugin disponible para un framework de desarrollo (el primero fue Rails) y, también, el segundo plugin en ser creado por desarrolladores fuera de Tractis (el plugin de Drupal fue creado por Atenea Tech). Ojala vayan apareciendo muchos más y la gente los comparta. Así todos podremos disfrutar de las ventajas del DNIe en minutos, gratis y sin tener que reinventar la rueda. Si tienes en mente crear nuevos plugins para Tractis Identity, ya sea para un lenguaje, un framework, un CMS o… lo que sea, revisa la documentación disponible y coméntanos tu idea. Intentaremos ayudarte en todo lo que podamos.

Usando maven

David García — Thu, 26 Mar 2009 16:24:54 +0000

Normalmente no suelo escribir sobre aspectos tecnológicos que no tengan que ver con la firma digital o con el servicio que Tractis presta.

Hoy sin embargo me gustaría centrarme en una herramienta muy presente en mi día a día y que me esta haciendo la vida bastante mas fácil: maven.

No daré ningún tutorial de como funciona la cosa, porque para eso ya hay muchísima documentación que lo explica bastante mejor de lo que yo lo haría. Explicaré como nos ayuda maven en la gestión de la configuración en nuestros proyectos.

Un poco de introducción

El principal problema con el que me encontraba a la hora de gestionar el gran numero de pequeños subsistemas Java que tenemos en el backend de Tractis es que gestionar el ciclo de vida de éstos requiere de muchas tareas repetitivas que pueden ser automatizadas y la inclusión de muchas librerías de terceros.

Para esta automatización usábamos Ant de Apache que nos ayudaba a la gestión de tareas repetitivas durante el desarrollo de nuestros proyectos.

Ant es muy bueno para automatizar tareas repetitivas pero la gestión de librerías externas no es todo lo potente que podría ser. La manera común de usar una librería en uno de nuestros proyectos era bajar la versión adecuada, ponerla en un directorio del proyecto e incluirla mediante el classpath en nuestra aplicación.

Esta manera de gestionar las librerías puede funcionar cuando tienes pocos proyectos o los proyectos tienen muy pocas librerías en común. Por el contrario, si cuando buscas una librería en todos tus proyectos obtienes 10 resultados: tienes un problema con la gestión de librerías; y más aun si te paras a ver las distintas versiones de la librería en cada uno de los proyectos.

Es por esto que Ant, pese a que puede ser una alternativa razonable si tienes pocos proyectos, se queda corto conforme vamos teniendo un número considerable de proyectos para gestionar.

Maven al rescate

Maven es una tecnología más que asentada y que se usa en la mayoría de proyectos Open Source Java, pero nunca esta de mas reconocer las enormes ventajas que su aplicación nos aporta.

Esta tecnología ayuda a gestionar el ciclo de vida de los proyectos.Para ello se definen las fases del proyecto (compilación, test, empaquetado, despliegue) en un fichero de meta-información llamado POM donde se recogen detalles de las tareas a realizar en cada fase. También se recogen detalles de la naturaleza del proyecto como por ejemplo sus dependencias respecto a librerías de terceros.

Maven permite la gestión automatizada de estas dependencias de librerías de un modo mas que notable. Simplemente es necesario incluir la referencia a la librería dentro del fichero POM así como la versión requerida y maven la bajará del repositorio por defecto (o de otro que se encuentre configurado dentro del POM) y la incluirá en el repositorio local.

Esto facilita la gestión de la configuración muchísimo ya que los proyectos no van engordando con librerías que se encuentran duplicadas a lo largo de nuestro sistema de control de versiones.

Además la gran mayoría de los proyectos Open Source o bien tienen sus librerías dentro del repositorio por defecto de maven o disponen de un repositorio propio.

En resumen

Yo en un principio pensaba que con mi ant ya me iba bien pero despues de probar maven te quedas con la misma sensación que tienes con gem en ruby o apt-get en debian o ubuntu…¿Como he vivido tanto tiempo sin esto?!

Tractis estrena nueva sección de Ayuda

David Blanco — Wed, 24 Sep 2008 09:42:22 +0000

La semana pasada lanzamos “por lo bajinis” la nueva sección de Ayuda de Tractis.

Un tour de la nueva Ayuda

Visualmente, hemos hecho algunos cambios para que sea más fácil encontrar la Ayuda cuando la necesitas. Aparte del habitual enlace a pie de página, encontrarás otro en el menú principal. Además hemos aplicado a la sección de Ayuda una combinación de colores azules que la distinguen claramente del resto de la aplicación.

Externamente, la nueva sección de Ayuda sustituye a la antigua página-listado y supera muchas de sus limitaciones:

Una pregunta. Un enlace: Muchos nos habeis comentado que, para contratar online, primero hay que vencer el desconocimiento y las reticencias iniciales de la otra parte. En concreto queríais que fuese posible enviar a la otra parte enlaces con la información concreta que le preocupa (p.ej: qué es la firma electrónica, qué validez legal tiene, qué certificados electrónicos aceptamos, etc) y no toda la página-listado donde la otra parte se iba a marear con información sin saber muy bien que leer y que no. Pues bien, ahora ya es posible. Cada pregunta ya tiene su propia página y dirección web.
Categorías y subcategorías: Además las preguntas están agrupadas por categorías y subcategorías, con lo que puedes hacer referencia a bloques de información más o menos extensos. Por ejemplo, desde la categoría “Información general sobre Tractis“, pasando por la subcategoría “Seguridad tecnológica en Tractis“, hasta llegar a algo tan concreto como “Seguridad en la preservación de contratos“.
Ayuda para principiantes: Si eres nuevo en Tractis, puedes pulsar el botón “Primeros Pasos” (claramente visible en la portada de la Ayuda) y accederas a un listado de artículos sencillos dirigidos especialmente a principiantes: ¿Qué es Tractis?, ¿Cuanto cuesta?, ¿Cómo puedo publicar una plantilla en la librería pública?, etc.
Solución de problemas: Si ya eres usuario de Tractis y surgen problemas, te atascas en algún momento del proceso de contratación o tienes problemas para firmar, puedes pulsar el botón “Solucionador de problemas” (también claramente visible en la portada de la Ayuda de Tractis) y accederás a un lista de preguntas con soluciones a los problemas más comunes.
Navegacion y búsqueda: Si te pierdes consultando la Ayuda, podrás averiguar rápidamente donde te encuentras, mirando el “breadcrumb” (“rastro de migas”) que hay al inicio de cada página. Así podrás volver al inicio o a una categoría/subcategoría intermedia. De la misma forma, puedes utilizar la caja de búsqueda para encontrar todas las preguntas relacionadas con un tema.

Internamente, la nueva sección de Ayuda utiliza, al igual que este blog, un WordPress personalizado con varios plugins. WordPress nos proporciona múltiples funcionalidades y opciones para documentar Tractis: ordenación de categorías, traducción de la Ayuda a distintos idiomas, control de cambios, etc.

Tenemos grandes planes para mejorar el soporte en Tractis

Este lanzamiento marca punto de inflexión. Por un lado, es el fin de un ciclo de desarrollo en el que nos hemos dedicado a solucionar las 3 peticiones más demandadas por nuestros usuarios: Mejoras en la configuración de permisos, Mejoras en el editor de contratos y Mejoras en la ayuda. Por otro lado, es el comienzo de una nueva etapa en la que vamos a dedicar la mayor parte de nuestros esfuerzos a ayudar a utilizar Tractis.

Aunque por el momento veais que la nueva Ayuda tiene poco contenido, este irá aumentando rápidamente durante los próximos semanas, con incorporaciones prácticamente diarias. Ahora mismo, hay un poco de todo, preguntas breves y otras bastante largas. Estamos migrando todas las preguntas de la antigua página-listado así como otras páginas separadas (certificados aceptados, Tractis Score, legislación internacional, documentación de la API…). El objetivo es que TODA la información esté accesible desde un ÚNICO sitio.

El siguiente paso será incorporar contenido y herramientas nuevas: muchas más preguntas y secciones, videotutoriales, ayuda contextual dentro de la aplicación, foros donde los usuarios puedan solucionar dudas o sugerir mejoras, casos de uso de Tractis, ejemplos de implementación, código y librerías gratuítas, apertura de la API, etc.

Tu feedback siempre es bienvenido pero ahora, en esta nueva etapa, es un momento especialmente bueno para darlo. Solo tienes que pulsar el botón de “Feedback” en la portada de la Ayuda y decirnos qué información echas a faltar y cómo podemos ponertelo fácil para que puedas utilizar Tractis con tus clientes, proveedores, empleados y partners.

Mejoras en la edición de contratos: Migración a WymEditor

David Blanco — Mon, 25 Aug 2008 09:00:37 +0000

Hoy estrenamos múltiples mejoras en la edición de contratos y un nuevo motor de edición de contratos basado en el código de WymEditor.

WYSIWYG vs WYSIWYM

Tractis permite editar contratos online, directamente en el navegador web y de forma colaborativa con el resto de participantes. La edición de texto online es clave para alcanzar la read/write web que imaginó Tim Berners-Lee. Durante los últimos años se ha avanzado bastante pero sigue sin ser un tema resuelto en internet. La edición de contratos es una de las áreas, junto con la configuración de permisos y la Ayuda -seguimos en ello-, donde más emails y peticiones nos habeis envíado.

Un comentario recurrente suele ser “El editor de Tractis no permite cambiar el estilo del texto (tipo de fuente, tamaño, etc)” y “¿Por qué no utilizais TinyMCE Editor o el ‘editor X’?“. Nuestra respuesta es que ese tipo de funcionalidades y editores corresponden a un enfoque de edición de texto WYSIWYG o “What You See Is What You Get” (lo que ves es lo que consigues) mientras que en Tractis apostamos por un enfoque de edición de texto WYSIWYM o “What You See Is What You Mean” (lo que ves es lo que quieres decir).

Microsoft Word nos ha (mal)acostumbrado a los editores WYSIWYG, es decir, a que el aspecto del documento en pantalla tenga que ser prácticamente igual al del documento una vez impreso. El problema de este enfoque es que la mayoría empleamos más tiempo jugueteando con el tipo de letra o el indentado de un párrafo que en producir contenido de calidad. El resultado es una productividad nefasta y gente que sigue pensando en términos de “papel” en vez de en “web”. Por el contrario, un editor WYSIWYM se olvida de la apariencia y obliga al usuario a concentrarse en el contenido y su estructura (p.ej: “Esto es un título 1“, “Esto es un título 2“, “Esto es un párrafo“, etc).

No nos malinterpreteis: WYSIWYM no está reñido en absoluto con la creación de preciosos documentos donde se cuida hasta el último detalle visual. La apariencia de tus contratos es muy importante y proyecta una imagen positiva o negativa de tí a la otra parte. Solo decimos que la creación y negociación de un contrato no es el momento apropiado de preocuparse por el estilo.

Las principales ventajas de este enfoque WYSYWYM en Tractis son:

Al evitar distracciones de estilos durante el proceso de creación de texto, logramos una forma más productiva y eficiente de crear y negociar contratos.
En el futuro, la separación absoluta de presentación y contenido nos permitirá ofrecer numerosas plantillas de estilos de diseño profesional que podrás aplicar a tus contratos. Podrás reutilizar plantillas de estilos de terceros en la librería pública de Tractis, probar distintos estilos en tus contratos con un solo clic o actualizar tu documentación corporativa en segundos (piensa en como CSS Zen Garden aplica distintos estilos CSS al mismo contenido).

Nuestra apuesta actual: editor semántico y código abierto

Existen mutitud de editores y opciones a considerar, ¿WYSIWYG o WYSIWYM?, ¿gratuíto o de pago?, ¿desarrollo propio o de terceros?, ¿de código abierto o propietario?, ¿javascript o flash?… Desde el principio decidimos no utilizar editores de pago ni lenguajes de programación cerrados (flash). Un breve repaso a la historia de Tractis muestra que hemos probado casi todas las combinaciones restantes y experimentado las ventajas y desventajas de cada una. Esta es la cronología:

2006: WYSIWYG + desarrollo propio + código propietario: Durante gran parte de la Beta de Tractis, utilizamos un editor WYSWYG desarrollado íntegramente por nosotros. Tuvimos multitud de problemas de compatibilidad entre navegadores y el editor se volvía lento e inestable con documentos grandes. Nunca liberamos el código.
Sept 2006: WYSIWYG + desarrollo de terceros + código abierto: Cambiamos a Dojo Editor, un editor compatible con la mayoría de navegadores cuyo desarrollo estaba liderado por el equipo de Jotspot, entre otros. Dojo es un gran editor pero, en Julio 2007, decidimos apostar por un enfoque WYSIWYM.
Julio 2007: WYSIWYM + desarrollo propio + código abierto: Desarrollamos internamente “Protomean”, un editor WYSIWYM sencillo y mantenible, basado en Prototype y que reaprovechaba las mejores ideas de varios editores. El desarrollo corrió a cargo de Choan Gálvez, colaborador de Negonation. Tras su puesta en producción, liberamos el código. Protomean ha resultado ser un gran editor (Choan recibió un Premio Glider por él) pero, concentrados como estamos con Tractis, nunca lo promocionamos debidamente y el mantenimiento del código, corrección de bugs y compatibilidad con Safari probó ser una tarea demasiado ardua para un proyecto de una sola empresa.
Agosto 2008: WYSIWYM + desarrollo de terceros + código abierto: Hoy anunciamos la migración a WymEditor como motor de edición de contratos en Tractis. A pesar de su corta edad, WymEditor es el primer editor web WYSIWYM y un paso en la dirección adecuada. WymEditor está realmente bien estructurado y es altamente parametrizable. Hemos podido añadir todas las modificaciones que necesitabamos sin tener que cambiar ni una sola linea del codigo del editor. Además, incluye un parser de xhtml que se encarga de sanitizar el código mientras escribes. Todo esto se traduce en un editor más sólido (sobre todo en el manejo de las listas) y en compatibilidad con mayor número de navegadores (¡ya es posible editar contratos en Safari!).

Si el pasado sirve para predecir el futuro, todo apunta que este no es el final del camino, solo una iteración más. Quedan algunos bugs menores por pulir y tenemos planeadas muchas mejoras más (más botones en la barra de edición para eliminar scrolls innecesarios, “Guardar” con ajax y sin recarga de página, Autosaving, permalinks a nivel de párrafos, etc).

Para terminar, queremos aprovechar para agradeceros todo el feedback que nos estais envíando para mejorar Tractis. Que no decaiga.

Mejoras en la configuración de permisos

David Blanco — Thu, 31 Jul 2008 13:11:07 +0000

Hoy anunciamos varias mejoras en la configuración de permisos en contratos, un área de Tractis que necesitaba una revisión urgente.

Cada letra cuenta

Junto con las contínuas peticiones para mejorar la sección de Ayuda (estamos en ello), la mejora en la configuración de permisos en contratos ha sido uno de los feedbacks más habituales que hemos recibido. Y con razón. El copy anterior de la configuración de permisos era francamente malo:

Primero preguntabamos “¿Quien puede acceder este contrato?” y el usuario podía elegir entre 2 opciones bastantes crípticas y radicales: “Solo yo” y “Todo el mundo en Tractis”.

“Solo yo” era la opción a elegir si querías crear un contrato privado. Sin embargo, el copy no indicaba esto. Debería haber sido algo más descriptivo, algo como “Solo yo y las personas a las que invite“.
“Todo el mundo en Tractis” era la opción si querías crear un contrato público.

Esto ya era bastante malo pero lo peor aún estaba por llegar. Cuando preguntabamos cosas como “¿Quienes pueden ver los participantes?“, “¿Quienes pueden ver las versiones?” y “¿Quienes pueden ver los comentarios?“, dabamos al usuario la posibilidad de elegir entre dos opciones:

“Nadie“.
“Todo el mundo“.

Con ambas respuestas nos referíamos a quienes, de entre los que podían acceder al contrato, podían ver participantes, versiones y comentarios… pero ¡No lo explicabamos!. De nuevo, el copy debería haber sido más descriptivo, por ejemplo: “Nadie, de los que pueden acceder, pueden ver los comentarios” o “Todos los que pueden acceder pueden ver las versiones“.

Cuando los usuarios se enfrentaban a la opción aterradora de que “Todo el mundo” pudiese ver sus versiones o que “Todo el mundo” pudiese escribir comentarios en sus contratos, sobra decir que muchos elegían la opción “Nadie”, lo que provocaba más problemas. El usuario accedía al contrato, no veía el botón de participantes (ni el de versiones ni el de comentarios) y nos escribían diciendo “Tractis es genial pero ¿cómo demonios invito participantes al contrato?”.

Mal copy en la aplicación > Decisiones equivocadas > Más frustración > Más solicitudes de soporte > Más trabajo.

Desfaciendo el entuerto

A partir de ahora, la configuración de permisos en Tractis es mucho más sencilla y potente.

Sencilla porque ahora el copy indica claramente la información que se pide al usuario:

¿Quien puede acceder al contrato?
¿Qué recursos pueden utilizar?

Potente porque ahora podrás configurar más recursos del contrato (Participantes, Comentarios, Versiones y Firmas) y contarás con más opciones de configuración:

Nadie
Solo mi equipo
Todos los equipos
Todo el mundo (opción solo disponible para contratos públicos).

Esta no es la versión final (con vuestra ayuda seguiremos mejorando esta y otras partes de Tractis) pero, sin duda, supone una mejora sustancial con respecto a la situación anterior.

A modo de reflexión final, si Tractis fuese una autopista, da miedo pensar cuanta gente habrá muerto en esta curva hasta el día de hoy. Un ejemplo perfecto de que, en una aplicación web, el copy es interface y cada letra cuenta.

Mejoras en la exportación de contratos

David García — Fri, 11 Jul 2008 07:00:00 +0000

En Tractis todo el proceso de negociación y firma se realiza sobre contratos escritos en XHTML 1.0, un formato ideal para la manipulación y edición de documentos en entornos web. Sin embargo, mucha gente necesita disponer de sus contratos en una variedad de formatos (pdf, word, texto plano…) para impresión, distribución, back-up, generación de informes o, simplemente, porque prefieren editarlos en entornos offline. Tractis incorpora una funcionalidad de importación y exportación de documentos que permite convertir documentos desde una variedad de formatos a XHTML y viceversa, de XHTML a Word, OpenOffice, texto plano, pdf y html, entre otros.

Desde el lanzamiento de la importación y exportación de plantillas y contratos en Octubre 2007, hemos venido sufriendo problemas en la prestación de esta funcionalidad, desde exportaciones a pdf, word,… extremadamente lentas a caídas del servicio. Esta semana hemos añadido varias mejoras, tanto en software como en infraestructura, que confíamos mejorarán sensiblemente la calidez, rapidez y estabilidad de importaciones y exportaciones.

Este post explica el “Antes” y el “Ahora” de la importación y exportación de contratos en Tractis; todo ello aderezado con consejos, pistas y enlaces interesantes para aquellos que necesiten montar una funcionalidad similar.

Antes

La funcionalidad de importación y exportación no es algo sencillo de implementar ya que hay que lidiar con las particularidades de los distintos formatos y las transformaciones implicadas en estas conversiones no son algo a tomar a broma. Como se trataba de un proceso complejo optamos por examinar las herramientas disponibles en el mercado, tanto open source como de pago, y llegamos a la conclusión de que la herramienta que mejor se adaptaba a nuestras necesidades era OpenOffice.

Optamos por emplear OpenOffice 2.2 (que permite su uso en modo server para conversión sin usar su IGU) como servicio core de conversión y jod-converter como libreria de acceso al servicio para poder dar el servicio de conversión como un servicio web creando un nuevo componente dentro de nuestra arquitectura SOA.

El problema era que OpenOffice 2.2 en modo server es terriblemente inestable y presentaba una colección de bugs enormes en la conversión de documentos que hacian muy incomodo su uso. Todo ello nos obligó utilizar trucos poco elegantes pero necesarios para poder prestar el servicio.

Para evitar las caidas disponiamos de un complejo sistema de watchdogs que cada vez que la instancia de OpenOffice moría las resucitaba … pero eso no es vida . Y como la suerte del open source es que, si algo no te gusta lo puedes cambiar, optamos por liarnos la manta a la cabeza y tirar por el camino salvaje.

Ahora

La gente de OpenOffice ha liberado recientemente la versión 2.3, mucho más estable que la 2.2 en modo server pero no lo bastante como para dar un servicio en un entorno de producción con garantias suficientes. Así que aplicamos un axioma de mi cosecha: “si tus trabajadores se mueren con frecuencia… ponlos en cluster” .

A partir de esta simple premisa desarrollamos una ampliación de JodConverter. Esta ampliación permite tener un conjunto de n trabajadores y un algoritmo de asignación de trabajo mediante un algoritmo de round robin que permite que si un trabajador cae otro ocupe su lugar inmediatamente, sin que se pierda ninguna transacción. Además el propio JodConverter gestiona el ciclo de vida de los trabajadores reiniciándolos si no responden o arrancándolos si su proceso muere. Esto evita la necesidad de disponer de un watchdog externo para garantizar la disponibilidad de trabajadores.

Disponer de herramientas como OpenOffice o JodConverter es un regalo y es justo contribuir nuestra ampliación sobre JodConverter con sus creadores por si les interesa usarla… a repartir buen karma .

Resumiendo, a todos los que hayáis padecido el problema de tener que implementar un sistema de conversión de documentos, espero que este post y el código compartido os sirva de ayuda. A nuestros clientes, esto es un pasito más para mejorar la calidad de Tractis. Ahora exportamos mejor, más rápido y con un servicio mucho más estable (congrats al creador del feed).

Y sin más demora, aquí os dejamos unos links de regalo: JodConverter como servicio web, Open Office como servidor y como instalar OpenOffice 2.3 en Ubuntu Feisty.