Novedades de la API para desarrolladores: ONLYOFFICE Docs 9.1 y DocSpace 3.5

Bienvenido a la última ronda de actualizaciones de la API del ecosistema ONLYOFFICE. Con el lanzamiento de ONLYOFFICE Docs 9.1 y DocSpace 3.5, presentamos una serie de nuevas funciones y mejoras diseñadas para ofrecer a los desarrolladores mayor control, flexibilidad y eficiencia.

Esta publicación te guiará por las actualizaciones clave: desde el nuevo soporte de formatos y opciones de personalización en Docs, hasta importantes mejoras en el SDK de DocSpace. Veamos qué traen estas nuevas versiones para tus proyectos de desarrollo.

Actualizaciones en ONLYOFFICE Docs 9.1

La versión 9.1 de ONLYOFFICE Docs incluye diversas mejoras en la API.

Nuevo soporte de formatos y conversión

Para ampliar la compatibilidad de documentos, hemos añadido soporte para nuevos formatos y ampliado las capacidades de conversión:

• Apertura de archivos HML;
• Conversión de presentaciones PPTX al formato TXT.

Personalización

Ahora tienes más control sobre la apariencia de los editores. El parámetro editorConfig.customization.uitheme,que define el tema del editor, ya está disponible para los editores móviles. Esto permite crear una experiencia visual coherente en todas las plataformas.

También hemos actualizado el requisito de tamaño para el logotipo personalizado editorConfig.customization.logo.image. Ahora puedes usar una imagen con dimensiones de 300×20 píxeles para mostrar tu logotipo personalizado en el encabezado del editor.

const config = {  
   editorConfig: {    
     customization: {
      logo: {        
      image: "https://example.com/logo.png",
      ....
      uiTheme: "theme-dark", ...

Integración WOPI

Para quienes utilizan la interfaz Web Application Open Platform Interface (WOPI), hemos introducido la nueva propiedad UserCanOnlyComment en la operación CheckFileInfo.
Esta propiedad booleana permite especificar si un usuario debe tener permisos solo para comentar, restringiendo otros tipos de edición.

Además, hemos mejorado el manejo de errores. Si un documento no puede bloquearse mediante WOPI, ahora se abrirá en modo de solo visualización con un mensaje de error apropiado, garantizando una experiencia de usuario más fluida.

Nuevo método para complementos

Hemos ampliado la API para hojas de cálculo y presentaciones con el método RemoveOleObject (para hojas / para diapositivas). Este método te permite eliminar programáticamente un objeto OLE de un libro de trabajo o una presentación usando su ID interno, brindando un mayor control sobre el contenido incrustado.

expression.RemoveOleObject(internalId);

API de Office

La versión 9.1 introduce una gran cantidad de nuevos métodos en la API JavaScript de Office. Estas incorporaciones abren nuevas y potentes posibilidades para la manipulación programática de documentos, especialmente dentro de las hojas de cálculo. Las principales áreas de expansión incluyen:

• Formato condicional: Conjunto completo de métodos para gestionar reglas de formato condicional, incluyendo por encima del promedio, escalas de color, barras de datos, conjuntos de iconos, top 10 y valores únicos.
• Geometría y trazado: Nuevos métodos para trabajar con geometrías, trayectorias y comandos de trazo, ofreciendo un control más preciso sobre formas y dibujos.
• XML personalizado: Métodos para interactuar con partes de XML personalizadas dentro de los documentos.
• Gestión de objetos y propiedades: Nuevos métodos de conversión y herramientas para gestionar las propiedades de los documentos.
• Control avanzado de objetos: Métodos mejorados para trabajar con secciones, libros de trabajo, tablas dinámicas, rangos y presentaciones.

Consulta la lista completa de nuevos métodos en la documentación oficial

SDKs actualizados y ejemplos de integración

Para dar soporte a estas actualizaciones, se ha lanzado un SDK de Java actualizado compatible con Docs 9.1. Incluye soporte para la conversión de presentaciones a TXT y la gestión del formato HTML.

También se han actualizado los ejemplos de prueba para la conexión de los editores, incluyendo ejemplos en Node.js que muestran la compatibilidad de formatos en la versión 9.1 de Docs. Puedes consultarlos en GitHub

Actualizaciones en ONLYOFFICE DocSpace 3.5

La versión DocSpace 3.5 incorpora diversas mejoras destinadas a potenciar a los desarrolladores, con SDKs optimizados y una API de backend actualizada.

SDK de plugins de DocSpace 2.0.0

El nuevo SDK de plugins introduce varios cambios clave enfocados en mejorar la seguridad y la funcionalidad de los cuadros de diálogo modales.

• Seguridad de archivos mejorada: Las configuraciones de seguridad de archivos se han movido a un nuevo enum FilesSecurity, lo que proporciona una organización y claridad superiores. La interfaz IFileItem ahora incluye las propiedades fileSecurity y security.
• Diálogos modales mejorados: Ahora puedes crear cuadros de diálogo modales con mayor control sobre su apariencia mediante las propiedades withoutBodyPadding y withoutHeaderMargin. También se ha agregado la acción updateCreateDialogModal para permitir actualizaciones dinámicas.
• Diálogos de creación más inteligentes: La interfaz ICreateDialog se ha mejorado con nuevas propiedades, isAutoFocusOnError, errorText, onError, onChange, isCloseAfterCreate, isCreateDisabled. Estas adiciones te brindan un control más detallado sobre la interacción del usuario y la validación de formularios.

También puedes consultar los plugins del sistema actualizados basados en SDK 2.0.0 en funcionamiento dentro de DocSpace:

• draw.io
• Markdown
• PDF Converter
• Speech-to-Text

SDKs de la API actualizados para DocSpace v3.5

Para alinearnos con el lanzamiento de DocSpace 3.5, hemos actualizado nuestros SDKs de la API en varios lenguajes de programación. Estos SDKs ofrecen una forma práctica de interactuar con la API de DocSpace, permitiendo gestionar archivos, usuarios y salas de manera programática.

Los SDKs actualizados están disponibles para:

• TypeScript: @onlyoffice/docspace-api-sdk en npm
• C#: DocSpace.API.SDK en NuGet
• Python: docspace-api-sdk en PyPI

Comienza a desarrollar hoy

Las últimas actualizaciones de ONLYOFFICE Docs y DocSpace proporcionan un conjunto de herramientas más completo y potente para los desarrolladores. Desde un mayor control y personalización de la API en los editores, hasta un SDK más robusto para los plugins de DocSpace, estas mejoras están diseñadas para ayudarte a crear soluciones más integradas y con más funcionalidades.

Te animamos a explorar la documentación actualizada, descargar los nuevos SDKs e implementar estas nuevas capacidades en tus proyectos.
Estamos deseando ver lo que crearás.

Obtén la última versión de ONLYOFFICE para desarrolladores:

DESCARGAR