Redmine

Características principales

• Visualización y edición de documentos de texto, hojas de cálculo y presentaciones desde los módulos de Redmine dependiendo de los derechos de acceso del usuario.
• Creación y llenado de formularios en línea.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), modo Control de Cambios, comentarios y un chat integrado.
• Soporte JWT para asegurar tu tráfico de manera que nadie, excepto los usuarios con los derechos adecuados, pueda acceder a tus documentos.
• Creación de nuevos archivos adjuntos utilizando plantillas que consideran la preferencia de idioma del usuario.

Formatos soportados

• Para crear: DOCX, DOCXF, XLSX, PPTX
• Para editar: DOCM, DOCX, DOCXF, DOTM, DOTX, *EPUB, *FB2, *HTML, *ODT, *OTT, PDF, *RTF, *TXT, *CSV, *ODS, *OTS, XLSM, XLSX, XLTM, XLTX, *ODP, *OTP, POTM, POTX, PPSM, PPSX, PPTM, PPTX
• Para visualizar: DJVU, DOC, DOCM, DOCX, DOCXF, DOT, DOTM, DOTX, *EPUB, *FB2, FODT, HTM, *HTML, MHT, MHTML, *ODT, OFORM, *OTT, OXPS, PDF, *RTF, STW, SXW, *TXT, WPS, WPT, XML, XPS, *CSV, ET, ETT, FODS, *ODS, *OTS, SXC, XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX, DPS, DPT, FODP, *ODP, *OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI

Novedades en la versión 3.1.0

Características

• Llenado de PDF en lugar de oform.

Corregido

• Corregida la verificación de dependencia de versión manual.

El registro completo de cambios está disponible aquí.

Requisitos

• Servidor de documentos de ONLYOFFICE v7.1 (servidor o versión en la nube) o posterior

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y conectable tanto desde Redmine como desde cualquier cliente final. Debe poder realizar POST a Redmine directamente.

  Por favor, consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.
• Redmine v4.0.0 - v5.0.x. Si eres nuevo en Redmine, instálalo siguiendo estas instrucciones.
• Ruby: Utilice una versión de Ruby compatible con su instalación de Redmine (recomendado: Ruby 2.7+ / 3.x).
• Conector de ONLYOFFICE v2.0.0 para Redmine

Instalando el conector de ONLYOFFICE para Redmine

Para instalar el complemento, necesitará Redmine v. 4.2 o superior, o Redmine v. 5.0 o superior. El complemento es compatible con Ruby v. 2.7.2 o superior, o Ruby v. 3.0.0 o superior.

Además, es posible que necesites zstd para descomprimir el complemento.

1. Instale Redmine siguiendo las instrucciones oficiales de Redmine.
2. Una vez que haya instalado Redmine, descargue el complemento.

   curl --location https://github.com/ONLYOFFICE/onlyoffice-redmine/releases/latest/download/onlyoffice_redmine.tar.zst --output onlyoffice_redmine.tar.zst

3. Descomprima el complemento descargado en el directorio plugins.

   tar --extract --file onlyoffice_redmine.tar.zst --directory plugins

4. Instale las dependencias del complemento si Redmine no lo hizo automáticamente.

   bundle install

5. Realizar la migración.

   RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

6. Reiniciar Redmine.

Lea más sobre la instalación del complemento en la página Wiki de Redmine.

Configurando el conector de ONLYOFFICE para Redmine

Ve al panel de Administración > Plugins, encuentra el plugin de integración de ONLYOFFICE para Redmine y haz clic en Configurar. Especifica los siguientes parámetros:

• Dirección del Servicio de Edición de Documentos - ingresa la dirección URL y el puerto donde está instalado ONLYOFFICE Docs (por ejemplo, https://documentserver:8080). Este campo es obligatorio.
  La dirección de ONLYOFFICE Docs debe ser accesible desde Redmine, así como la dirección de Redmine debe ser accesible desde ONLYOFFICE Docs.
• La sección de Configuración avanzada del servidor puede usarse si tu configuración de red no permite solicitudes entre el Redmine instalado y ONLYOFFICE Docs usando las direcciones públicas. En este caso, especifica direcciones para solicitudes internas en los campos correspondientes:
  • Dirección de ONLYOFFICE Docs para solicitudes internas desde el servidor - especifica la dirección que se usa para acceder al Servicio de Edición de Documentos desde Redmine.
  • Dirección del servidor para solicitudes internas desde ONLYOFFICE Docs - especifica la dirección que se usa para acceder a Redmine desde el Servicio de Edición de Documentos.
• Clave secreta - especifica la clave secreta utilizada para firmar los datos.
  A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Para más detalles, consulta la sección Habilitando JWT para la integración de ONLYOFFICE y Redmine de este artículo.
• Desactivar la verificación del certificado (inseguro) - marca esta casilla para desactivar la verificación del certificado y permitir que Redmine establezca conexión con ONLYOFFICE Docs si estás utilizando un certificado autofirmado para tu ONLYOFFICE Docs (de lo contrario, Redmine no validará un certificado autofirmado y no permitirá la conexión hacia/desde ONLYOFFICE Docs). Esta es una solución insegura, y recomendamos encarecidamente que reemplaces el certificado por uno emitido por alguna CA.
• Verifica las siguientes configuraciones de personalización si es necesario:
  • Mostrar el botón del menú Chat.
  • Mostrar el encabezado de una manera más compacta.
  • Mostrar el botón del menú Soporte de Retroalimentación.
  • Mostrar el botón del menú Ayuda.
  • Mostrar el encabezado de la barra de herramientas en monocromo.

Haz clic en el botón Aplicar en la parte inferior para guardar los cambios.

Habilitando JWT para la integración de ONLYOFFICE y Redmine

Para proteger los documentos del acceso no autorizado, los editores de ONLYOFFICE utilizan el JSON Web Token (JWT). El token se añade en la configuración cuando se inicializa el Editor de Documentos y durante el intercambio de comandos entre los servicios internos de ONLYOFFICE Docs. La clave secreta se utiliza para firmar el token web JSON y validar el token al solicitar a ONLYOFFICE Docs.

A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Necesitas encontrar tu clave secreta en el archivo de configuración de ONLYOFFICE Docs, luego especificar la misma clave secreta en la configuración del conector.

Paso 1: Encuentra tu clave secreta en el archivo de configuración de ONLYOFFICE Docs

1. Abre el archivo local.json con cualquier editor de texto disponible.
   • Para Linux - /etc/onlyoffice/documentserver/local.json
   • Para Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Para Docker – entra al contenedor de ONLYOFFICE Docs usando el comando docker exec -it <containerID> bash y abre /etc/onlyoffice/documentserver/local.json

     Alternativamente, puedes usar el siguiente comando para encontrar la clave secreta predeterminada sin abrir local.json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   El archivo local.json debería verse así:

   {"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}

2. El valor true está especificado en tres secciones. Esto significa que la validación del token está habilitada.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. La clave secreta generada automáticamente está especificada en tres secciones. Puedes reemplazar el valor secreto predeterminado con tu propia clave secreta. La clave secreta debe ser la misma en las tres secciones.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Si realizas cambios, guárdalos y reinicia los servicios para que los cambios de configuración surtan efecto.

   supervisorctl restart all

Paso 2: Especifica la misma clave secreta en la configuración del conector

En la configuración del conector, especifica la misma clave secreta en el campo Clave secreta y guarda la configuración.

Conectando al demo de ONLYOFFICE Docs

A partir de la versión 2.0.0 del conector de ONLYOFFICE, puedes probar los editores en línea de ONLYOFFICE dentro de Redmine sin instalar ONLYOFFICE Docs.

Para activar la conexión, marca la casilla Conectar al Servidor de Documentos de ONLYOFFICE demo y haz clic en el botón Guardar.