En el Square Kilometre Array utilizamos Confluence de Atlassian como principal herramienta para compatir y gestionar conocimiento. Confluence es un wiki con bastantes añadidos para mejorar su usabilidad, y con excelente integración con otros productos de Atlassian, como JIRA. También tiene la facultad de utilizar macros de diferentes proveedores para conseguir funciones no cubiertas por el propio producto.
Una de las macros disponibles es draw.io Diagrams for Confluence. draw.io (now diagrams.net) es una aplicación web para generar múltiples tipos de figuras y diagramas, y como podréis imaginar es bastante útil en un entorno ingenieril. La macro de draw.io proporciona la misma experiencia de draw.io online, pero embebida en Confluence.
Sin embargo, en ocasiones uno necesita poder editar un diagrama que originalmente se creó como diagrama embebido en Confluence para poder editarlo sin acceso a internet con la aplicación de escritorio draw.io, o puede que quieras compatirlo con una audiencia distinta, e incluso colaborar con ellos directamente desde la versión online de draw.io.
Para eso, tienes que seguir los siguientes pasos:
- Primero hay que obtener el archivo draw.io de Confluence. La macro draw.io almacena dos adjuntos en Confluence: una vista previa del diagrama en formato Portable Network Graphics (PNG), y el auténtico archivo editable en formato
drawio(que está basado en XML y contiene formas en formato XML, codificado en base64, y luego pasado por deflate… pero eso es otra historia). Si tu diagrama, por ejemplo, se llama Figura1, tendrás dos adjuntos: Figura1.png, y Figura1. Si haces clic en el triangulo que apaparece a la izquierda de Figura1, descargarás el archivo si haces clic en la última versión (que aparece con el sufijo current). Por ejemplo, suponiendo que tengas dos versiones, haz clic en Version 2 (current) bajo Figura1. Se decargará un archivo llamado Figura1, sin extensión. - Añade la extensión
.drawioal archivo descargado. Después de esto el archivo que se llamaba Figura1 pasará a llamarse Figura1.drawio. - Ahora, puedes usar draw.io en la web yendo a https://draw.io, y luego usando File > Import… para cargar el sistema desde tu ordenador, o si has descargado ya la aplicación de escritorio draw.io, puedes hacer doble clic sobre el archivo y empezar a editarlo online en dicha aplicación.
Una vez que hayas acabado, para importar los cambios en Confluence tienes que:
- Abrir el diagrama en Confluence haciendo doble clic en el diagram en la página correspondiente, seleccionándolo todo, y eliminándolo.
- A continuación, si utilizaste la aplicación de escritorio de draw.io desktop application, puedes usar File > Import… para importar el archivo Figure1.drawio modificado.
- Si utilizaste la versión online version, necesitas obtener el archivo
.drawiobien desde Google Drive, Dropbox, Box, OneDrive, o culesquiera otro servicio de almacenamiento que estuvieseis usando como respaldo. Desde Google Drive es necesario utilizar el interfaz web endrive.google.com para descargar el archivo, en lugar de abrirlo. - Una vez importado, haz clic en Save & Exit para que los cambios permanezcan.
Después de los pasos anteriores, tendrás una versión actualizada del diagrama en Confluence, y si chequeas el número de versión, verás que ha aumentado, como era de esperar.
¡Espero que os sirva!