Cómo integrar ONLYOFFICE Docs con Redmine en Ubuntu

ONLYOFFICE Docs es una suite ofimática de código abierto distribuida bajo licencia GNU AGPL v3.0. Incluye visores basados en web y editores colaborativos para documentos de texto, hojas de cálculo y presentaciones altamente compatibles con los formatos OOXML.

ONLYOFFICE Docs puede integrarse con varios servicios en la nube, como Nextcloud, ownCloud, Seafile, Alfresco, Plone, etc., así como incrustarse en tu propia solución. Los editores también pueden utilizarse como parte de la completa solución de productividad ONLYOFFICE Workspace.

Redmine es una herramienta de gestión de proyectos y seguimiento de incidencias gratuita y de código abierto que incluye wikis y foros por proyecto, seguimiento del tiempo y control de acceso flexible basado en roles. Con ONLYOFFICE Docs integrado, puedes editar y ser coautor de documentos ofimáticos directamente desde Redmine.

En este tutorial, aprenderemos a conectar las instancias de ONLYOFFICE Docs y Redmine mediante una aplicación de integración.

Ten en cuenta que ONLYOFFICE es compatible con Redmine v.4.0.0 o superior.

Paso 1: Instalar ONLYOFFICE Docs

Para poder editar documentos en Redmine, necesitas una instancia de ONLYOFFICE Docs (Servidor de Documentos) que sea resoluble y conectable tanto desde Redmine como desde cualquier cliente final. ONLYOFFICE Docs también debe poder publicar en Redmine directamente.
La forma más sencilla de instalar la última versión del paquete con todas las dependencias es utilizar Docker ejecutando el siguiente comando:

sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver

Puedes encontrar las instrucciones detalladas en este tutorial de HowtoForge.

Paso 2: Instalar la aplicación de integración

Descarga el conector ONLYOFFICE para Redmine. Clona la rama maestra desde GitHub:

git clone https://github.com/ONLYOFFICE/onlyoffice-redmine

o descarga y descomprime la última versión archivada:

wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/v1.0.0.tar.gz
tar -xvzf v1.0.0.tar.gz

También puedes obtener la app del directorio de plugins de Redmine.

El subdirectorio de plugins debe llamarse onlyoffice_redmine. Cambia el nombre de la carpeta clonada onlyoffice-redmine o descomprimida onlyoffice_redmine-x.y.z a onlyoffice_redmine.

mv onlyoffice-redmine onlyoffice_redmine
mv onlyoffice-redmine-1.0.0 onlyoffice_redmine

A continuación, asegúrate de que la instancia de Redmine está detenida y coloca el directorio de plugins onlyoffice_redmine en la carpeta redmine/plugins.

Ve al directorio raíz de Redmine e instala las dependencias:

cd redmine
bundle install
Initialize/update the database:
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

Una vez hecho esto, reinicia la instancia de Redmine.

Paso 3: Configurar la aplicación de integración

Una vez que tengas instalado el conector, configúralo a través de la interfaz de Redmine. Ve a Administración -> Plugins -> Plugin ONLYOFFICE Redmine -> Configurar. Especifica los siguientes ajustes:

  • La URL y el puerto del Servidor de Documentos de ONLYOFFICE instalado.
  • Clave secreta para activar el JWT que protege tus documentos de accesos no autorizados. También debes especificar la misma clave secreta en el archivo de configuración del Servidor de Documentos ONLYOFFICE para habilitar la validación.
  • Ajustes de personalización del editor si es necesario.

Ajustes

Paso 4: Utilizar ONLYOFFICE Docs dentro de Redmine

Puedes ver, editar y colaborar en documentos de texto, hojas de cálculo y presentaciones subidos a los módulos Asuntos, Archivos, Documentos, Wiki o Noticias dentro de Redmine. Para cada módulo, los derechos de acceso para ver o editar archivos dependen de los permisos del rol de usuario.

Configuración de permisos

Actualmente, puedes editar y colaborar en archivos DOCX, XLSX y PPTX.

Integración de ONLYOFFICE en Redmine

Puedes visualizar otros formatos: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP.
En cuanto a las funciones de colaboración, están disponibles las siguientes: modos de coedición en tiempo real y con bloqueo de párrafos, seguimiento de cambios, comentarios y chat integrado.
¡Eso es todo! Ahora puedes editar y ser coautor de documentos ofimáticos directamente dentro de tu Redmine utilizando ONLYOFFICE Docs.

También te podría gustar...