Strapi

Acerca de la integración de ONLYOFFICE y Strapi

Strapi es un sistema de gestión de contenidos de código abierto utilizado para crear API. ONLYOFFICE ofrece un conector oficial para integrar ONLYOFFICE Docs con Strapi y editar documentos de ofimática en tu biblioteca multimedia de Strapi. Puedes obtener el plugin de integración de ONLYOFFICE desde la biblioteca de npm o desde la página de GitHub. El conector se distribuye bajo la licencia Apache-2.0.

nota

Para obtener más información sobre cómo funciona el conector de ONLYOFFICE para Strapi, visita nuestra página de documentación de la API.

Características principales

• Edición y visualización de documentos de texto, hojas de cálculo y presentaciones.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), el modo Control de cambios, comentarios y el chat integrado.
• Compatibilidad con JWT para proteger tu tráfico de modo que nadie pueda acceder a tus documentos, salvo los usuarios con los derechos adecuados.

Formatos compatibles

• Para ver y editar: DOCX, XLSX, PPTX
• Solo para ver: 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

Novedades de la versión 2.0.1

Cambiado

• Dependencias del motor actualizadas

El registro de cambios completo está disponible aquí.

Conectar ONLYOFFICE Docs con Strapi

Requisitos

• ONLYOFFICE Document Server v7.1 (versión de servidor o de nube) o posterior

  Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y accesible tanto desde Strapi como desde cualquier cliente final. Debe poder enviar solicitudes POST directamente a Strapi.

  nota

  Consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.

• Strapi v4.2.0 o posterior

• Conector de ONLYOFFICE v1.1.0 para Strapi

Instalar el plugin de integración de ONLYOFFICE para Strapi

1. Para permitir la inserción de un marco con el editor y la carga de api.js, sustituye la línea strapi::security del archivo strapi/config/middlewares.js por la siguiente configuración:

   {
     name: "strapi::security",
     config: {
       contentSecurityPolicy: {
         useDefaults: true,
         directives: {
           "script-src": ["'self'", "https:", "http:"],
           "frame-src": ["'self'", "https:", "http:"],
         },
       },
     }
   },

   Si ya existe dicha configuración, solo tienes que añadir directives.

2. Instala el plugin en tu proyecto de Strapi:

   npm install onlyoffice-strapi --save

3. Recompila y reinicia Strapi para incluir el plugin de ONLYOFFICE en la interfaz de administración. Ejecuta:

   # using yarn
   yarn build
   yarn develop
   
   # using npm
   npm run build
   npm run develop

   Ahora el plugin de integración de ONLYOFFICE para Strapi está instalado y listo para ser configurado. Se puede acceder al plugin desde el panel izquierdo en la sección Plugins bajo el nombre ONLYOFFICE.

   

Configurar el plugin de integración de ONLYOFFICE para Strapi

Para configurar el plugin de integración de ONLYOFFICE en Strapi:

1. Abre la sección Settings (Ajustes) en el panel izquierdo.

2. En la sección Global settings (Ajustes globales), haz clic en el elemento de menú ONLYOFFICE.

3. En la página de ajustes de ONLYOFFICE, introduce la Document server address (Dirección del servidor de documentos), es decir, la URL de ONLYOFFICE Docs instalado.

   nota

   La dirección de ONLYOFFICE Docs debe ser accesible desde Strapi, y la dirección de Strapi debe ser accesible desde ONLYOFFICE Docs.

Cómo funciona

La interacción entre el usuario y el documento se realiza tanto en el lado del cliente como en el del servidor.

A continuación se explican las nociones principales utilizadas en esta documentación.

El lado del cliente incluye:

• Gestor de documentos: la lista de documentos que se muestra en el navegador del usuario, donde este puede seleccionar el documento necesario y realizar algunas acciones con él (según los derechos concedidos, el usuario puede abrir el documento para verlo o editarlo, y compartirlo con otros usuarios).
• Editor de documentos: la interfaz de visualización y edición de documentos con todas las funciones de edición más conocidas, que sirve de medio entre el usuario y el servicio de edición de documentos.

El lado del servidor incluye:

• Servicio de almacenamiento de documentos: el servicio del servidor que almacena todos los documentos disponibles para los usuarios con los derechos de acceso adecuados. Proporciona los ID de documento y los enlaces a esos documentos al gestor de documentos que el usuario ve en el navegador.
• Servicio de edición de documentos: el servicio del servidor que permite ver y editar documentos (si el usuario tiene los derechos adecuados para hacerlo). La interfaz del editor de documentos se utiliza para acceder a todas las funciones del servicio de edición de documentos.
• Servicio de comandos de documentos: el servicio del servidor que permite realizar comandos adicionales con el servicio de edición de documentos.
• Servicio de conversión de documentos: el servicio del servidor que permite convertir el archivo de documento al formato Office Open XML adecuado (docx para documentos de texto, xlsx para hojas de cálculo y pptx para presentaciones) para editarlos o descargarlos.
• Servicio de generación de documentos: el servicio del servidor que permite crear un documento fácilmente sin necesidad de ejecutar un editor de documentos.

Ten en cuenta que ONLYOFFICE Document Server incluye el editor de documentos, el servicio de edición de documentos, el servicio de comandos de documentos, el servicio de conversión de documentos y el servicio de generación de documentos. El gestor de documentos y el servicio de almacenamiento de documentos están incluidos en Community Server o deben ser implementados por los integradores de software que utilicen ONLYOFFICE Document Server en su propio servidor.

Habilitar JWT para la integración de ONLYOFFICE y Strapi

JWT o JSON Web Token es una cadena de texto que el cliente envía al servidor dentro de la solicitud HTTP para validar la autenticidad del cliente. JWT se guarda solo en el lado del cliente, por lo que la transmisión entre las partes está protegida y firmada digitalmente.

El token se genera mediante el estándar JWT (JSON Web Tokens). Los tokens están firmados con la clave del servidor, de modo que el cliente puede verificar que el token es legítimo.

ONLYOFFICE Docs valida el token. Los datos de la carga útil se consideran válidos y se utilizan en lugar de los datos correspondientes de los parámetros principales. Si el token no es válido, el comando no se ejecuta. Para obtener más información, lee la guía de seguridad de la API.

Para proteger tus documentos con JWT,

1. Abre la sección Settings (Ajustes) en el panel izquierdo.

2. En la sección Global settings (Ajustes globales), haz clic en el elemento de menú ONLYOFFICE.

3. En la página de ajustes de ONLYOFFICE, introduce la clave secreta en el campo Document server JWT secret key (Clave secreta JWT del servidor de documentos). Puedes encontrar más información aquí.

   

   Ahora que el plugin de integración de ONLYOFFICE está configurado, puedes empezar a usarlo.

Empezar a usar ONLYOFFICE Docs en Strapi

Para que los usuarios puedan editar los documentos de ofimática de Strapi en los editores de ONLYOFFICE Docs y guardar los cambios de nuevo en Strapi, sube los archivos y establece los derechos de acceso correspondientes.

Subir archivos a Strapi

1. En la sección Plugins en el panel izquierdo, abre la página Media Library (Biblioteca multimedia).

2. Haz clic en el botón Add new assets (Añadir nuevos recursos) en la esquina superior derecha.

   

3. Se abre la ventana Add new assets (Añadir nuevos recursos). Elige si quieres subir un archivo desde tu ordenador o desde una URL haciendo clic en la pestaña correspondiente del panel superior.

   

Ver, editar y gestionar archivos en Strapi

Para ver, editar y coeditar documentos añadidos a la biblioteca multimedia de Strapi,

1. En la sección Plugins en el panel izquierdo, abre la página de archivos ONLYOFFICE dentro de Strapi.

2. Para abrir el archivo en el editor de ONLYOFFICE, haz clic en el nombre del archivo o haz clic en el botón Edit in ONLYOFFICE (Editar en ONLYOFFICE) de la derecha.

   

Para guardar archivos en el formato necesario directamente en el editor,

1. Ve a la pestaña Archivo.
2. Haz clic en la opción Descargar como... y elige el formato necesario.

Para marcar archivos como favoritos directamente en el editor, haz clic en el icono Marcar como favorito de la barra de herramientas superior.

Para volver a la lista de archivos,

1. Ve a la pestaña Archivo.
2. Haz clic en la opción Abrir ubicación del archivo en el menú de la derecha.

Derechos de acceso

Para gestionar los derechos de acceso a los archivos añadidos a la biblioteca multimedia de Strapi:

1. Ve a la pestaña Settings (Ajustes) situada en la sección General del panel izquierdo.
2. En la sección Administration panel (Panel de administración), ve a la pestaña Roles.
3. Edita el rol haciendo clic en el icono Edit (Editar) a la derecha del nombre del rol.

Para permitir que los usuarios editen archivos, establece los derechos de acceso Update + Delete (Actualizar + Eliminar) para el rol de usuario necesario.

Para permitir que los usuarios solo vean archivos, establece el derecho de acceso Access the Media Library (Acceder a la biblioteca multimedia) para el rol de usuario necesario.

nota

Para obtener más información sobre los problemas más comunes y cómo resolverlos, visita nuestra guía de solución de problemas.