Drupal

Características principales

• Edición y visualización de documentos de texto, hojas de cálculo, presentaciones y formularios PDF.
• Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), el modo Control de cambios, comentarios y chat integrado.
• Soporte JWT para asegurar tu tráfico de modo que nadie pueda acceder a tus documentos excepto los usuarios con los derechos adecuados.
• Vista previa de archivos en páginas públicas.

Formatos compatibles

• Para edición: DOCX, XLSX, PPTX, formularios PDF.
• Solo para visualización: DJVU, DOC, DOCM, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTML, MHT, ODT, OTT, OXPS, PDF, RTF, TXT, XPS, XML, CSV, FODS, ODS, OTS, XLS, XLSM, XLT, XLTM, XLTX, FODP, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM.

Requisitos

• ONLYOFFICE Docs (Document Server) v7.1 o superior.

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

  Por favor, consulta la página de documentación oficial para aprender más sobre la instalación de ONLYOFFICE Docs.
• Módulo núcleo de Drupal versión 10 o superior.
• La versión firebase/php-jwt: 6.0.0 o superior.
• Conector ONLYOFFICE para Drupal

Instalación a través de la interfaz de usuario de Drupal

1. En la página del proyecto en la barra de herramientas de administración en drupal.org, desplázate a la sección Versiones al final de la página. Haz clic en el enlace Ver todas las versiones.
2. Elige la versión requerida de la lista.
3. Copia la dirección del enlace tar.gz. Dependiendo de tu dispositivo y navegador, puedes hacer esto haciendo clic derecho y seleccionando Copiar dirección del enlace.
4. En el menú administrativo Gestionar, navega a Extender (admin/modules). Aparecerá la página Extender.
5. Haz clic en el botón Añadir nuevo módulo. Aparecerá la página Añadir nuevo módulo.
   
6. Pega el enlace de descarga copiado en el campo Añadir desde una URL.
   
7. Haz clic en Instalar para subir y descomprimir el nuevo módulo en el servidor. Los archivos se descargan en el directorio de módulos.
8. Para aplicar la configuración de localización, ejecuta los siguientes comandos:

   drush locale-check

   drush locale-update

Instalación a través de Composer

Introduce el siguiente comando en la raíz de tu sitio Drupal:

composer require onlyoffice/onlyoffice-drupal

Si el directorio de instalación es web/modules/contrib/drupal, ejecuta los siguientes comandos para aplicar la configuración de localización:

drush locale-check

drush locale-update

Activando el módulo de integración ONLYOFFICE a través de la interfaz de usuario de Drupal

1. Abre la página Extender (admin/modules) desde el menú administrativo Gestionar.
2. Localiza el módulo Conector ONLYOFFICE y marca la casilla correspondiente.
   
3. Haz clic en Instalar para activar el módulo.

Activando el módulo de integración ONLYOFFICE mediante línea de comandos

1. Ejecuta el siguiente comando Drush, proporcionando el nombre del proyecto como parámetro:

   drush pm:enable onlyoffice

2. Sigue las instrucciones del asistente.

Cómo funciona

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

Las nociones principales usadas en esta documentación se explican a continuación.

El lado cliente incluye:

• Administrador de documentos - la lista de documentos mostrada en el navegador del usuario donde este puede seleccionar el documento necesario y realizar algunas acciones con él (dependiendo de los derechos otorgados, el usuario puede abrir el documento para verlo o editarlo, compartir el documento con otros usuarios).
• Editor de documentos - la interfaz para ver y editar documentos con todas las funciones de edición conocidas disponibles, usada como medio entre el usuario y el servicio de edición de documentos.

El lado 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 apropiados. Proporciona los IDs y enlaces de estos documentos al administrador de documentos que el usuario ve en el navegador.
• Servicio de edición de documentos - el servicio del servidor que permite realizar la visualización y edición de documentos (en caso de que el usuario tenga los derechos adecuados para hacerlo). Se usa la interfaz del editor de documentos 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 del documento al formato Office Open XML apropiado (docx para documentos de texto, xlsx para hojas de cálculo y pptx para presentaciones) para su edición o descarga.
• Servicio de creación de documentos - el servicio del servidor que permite construir un documento fácilmente sin necesidad de ejecutar un editor de procesamiento de documentos.

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

Activando JWT para la integración de ONLYOFFICE y Drupal

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

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

ONLYOFFICE Docs valida el token. Los datos del payload se consideran válidos y se usan en lugar de los datos correspondientes de los parámetros principales. Si el token es inválido, el comando no se ejecuta. Para aprender más, lee la guía de seguridad de la API.

Para proteger tus documentos con JWT en Drupal, abre la página ~/config/system/onlyoffice-settings con la configuración administrativa para la sección ONLYOFFICE. Alternativamente, sigue estos pasos:

1. Abre la página Extender (admin/modules) desde el menú administrativo Gestionar.
2. Haz clic en la flecha en la descripción del módulo Conector ONLYOFFICE para abrir una lista desplegable.
3. Elige la opción Configurar.
4. Introduce la clave secreta en el campo Clave secreta.
   
5. En el archivo de configuración de ONLYOFFICE Document Server, especifica la misma clave secreta y habilita la validación.

Subiendo archivos a Drupal

1. Ve a Gestionar > Contenido.
2. Haz clic en el botón Agregar contenido.
3. Haz clic en el tipo de contenido requerido.
4. Introduce el título, idioma y cuerpo, y configura el formato de texto.
5. En el campo Agregar un nuevo archivo, haz clic en el botón Examinar y elige el archivo desde el disco duro de tu PC.
6. Marca o desmarca la casilla Publicado según tus preferencias.
7. Haz clic en el botón Guardar.

Visualización, edición y gestión de archivos en Drupal

1. Ve a Gestionar > Contenido.
2. Cambia a la pestaña Medios en la parte superior de la pantalla.
3. Encuentra el archivo requerido en la lista o usa el campo de búsqueda en la parte superior.
4. Haz clic en la flecha en la columna Operations para elegir si quieres Editar las propiedades del archivo, Editar en ONLYOFFICE o Eliminar el archivo.
   

Añadiendo archivos a las publicaciones

Al crear una publicación, puedes añadir el nuevo elemento ONLYOFFICE.

1. Ve a Estructura > Tipos de contenido > haz clic en Gestionar campos junto al campo de contenido requerido. En la página abierta, haz clic en Agregar campo. Añade un nuevo campo: General, Número, Referencia o Texto. Establece la etiqueta y guarda.
   
2. Para el campo Archivo añadido, especifica las extensiones de archivo. Ve a Estructura > Tipos de contenido > Gestionar campos, o permanece en la página abierta. En el campo Extensiones de archivo permitidas, especifica los formatos de archivo que se mostrarán en los editores (docx, xlsx, pptx).
   
3. Para el campo Medios añadido, marca la casilla Documento.
   
4. Ve a Estructura > Tipos de medios > Documento > abre la lista desplegable y elige la opción Gestionar la visualización.
   
5. Para el campo Documento, especifica el formato Vista previa de ONLYOFFICE. Al hacer clic en el símbolo de engranaje, puedes especificar las dimensiones de la ventana del editor embebido.
   

   Cuando termines con la configuración previa, puedes crear publicaciones en la pestaña Contenido. Haz clic en el botón Agregar contenido y selecciona el contenido creado.

   

1. Especifica un título y selecciona un archivo (si el contenido contiene campos Archivo).
2. Para la sección Medios, especifica el nombre del archivo previamente subido.
3. Los visitantes de tu sitio también podrán ver la página creada (Personas > Permisos > Ver contenido publicado).

Trabajando con formularios PDF

Creando/subiendo un formulario PDF

1. Ve a Gestionar → Contenido → Formulario ONLYOFFICE.
2. Haz clic en el botón Crear y cargar.
3. Elige la opción En blanco del menú desplegable Crear formulario desde e introduce el nombre del archivo en el campo correspondiente para crear un archivo nuevo.
4. Para subir un archivo PDF existente, elige la opción Subir del menú desplegable Crear formulario desde.
5. El archivo ahora está disponible en la página Formularios PDF.

Publicando un formulario PDF

Preconfiguración

1. Ve a Gestionar → Estructura → Tipo de contenido.
2. Elige la opción Gestionar campos junto al tipo de contenido requerido.
3. Haz clic en el botón Crear un nuevo campo en la esquina superior izquierda de la página Gestionar campos recién abierta.
4. Elige la opción Formulario ONLYOFFICE.
5. Introduce el nombre requerido en el campo Etiqueta.
6. El tipo de contenido elegido en el paso 2 ahora tiene asignado el tipo de formulario ONLYOFFICE.

Publicación

1. Ve a Gestionar → Contenido → Contenido.
2. Haz clic en el botón Agregar contenido en la esquina superior izquierda.
3. Elige el tipo de contenido al que previamente asignaste el tipo ONLYOFFICE form.
4. Introduce el nombre del formulario creado en el campo Formulario ONLYOFFICE. Si no hay un formulario creado previamente, haz clic en el botón Crear nuevo formulario de ONLYOFFICE.
5. Haz clic en el botón Guardar para crear una página de formulario en Drupal.

Rellenando un formulario PDF

1. Rellena el campo del formulario.
2. Haz clic en el botón Completar y enviar en la barra de herramientas superior.
3. Puedes descargar una copia del formulario rellenado. Haz clic en el botón ⋮ en la esquina superior derecha y elige si quieres descargarlo como archivo .docx o .pdf.

Para aprender más sobre cómo rellenar formularios, consulta la guía siguiente.

Trabajando con formularios rellenados

1. Ve a Gestionar → Contenido → Formulario ONLYOFFICE → Formularios enviados.
2. Todos los formularios rellenados están agrupados por el nombre de la plantilla. Haz clic en el nombre de la plantilla para ver todos los formularios asociados.
3. Puedes ver, descargar o eliminar cualquiera de los formularios.