ONLYOFFICE 10.0 para desarrolladores: novedades

ONLYOFFICE 10.0 trae un conjunto sólido de actualizaciones para los desarrolladores que construyen sobre los editores. Obtiene nuevos puntos finales que facilitan el manejo de archivos, edición de PDF en Document Builder y una API de plugins modernizada con métodos asíncronos. La versión también añade nuevos controles para características de IA y configuraciones más seguras en todo el servidor.

A continuación, un breve recorrido por los cambios que más importan para tus integraciones, además de algunos cambios en el comportamiento que debes revisar antes de actualizar.

Herramientas de IA, opciones de personalización de IA y gestión de IA en el servidor

ONLYOFFICE Docs 10.0 trae las herramientas de IA a cada editor. Más que una generación básica de texto, comprenden la estructura del documento, reconocen elementos, conectan contenido a través de secciones y crean referencias clicables para una navegación más fácil. Puedes conectar cualquier modelo de IA, incluidos modelos locales para casos de uso sensibles a la privacidad, y asignar diferentes modelos a diferentes tareas.

En las ediciones comerciales de ONLYOFFICE Docs 10.0, los administradores pueden configurar proveedores de IA una vez en el Panel de administración. Una vez configurados, los usuarios del editor obtienen herramientas de IA listas para usar sin tener que ingresar sus propias claves de API. Los administradores pueden asignar diferentes modelos a tareas específicas, conectar servidores MCP para acceder a herramientas externas y controlar si la búsqueda en la web está disponible. Una vez guardada una configuración en el servidor, los usuarios quedan limitados a los proveedores y modelos aprobados: ya no pueden agregar sus propias claves ni cambiar qué modelo se utiliza. Más información

Tú decides si las herramientas de IA aparecen en tu producto. La versión 10.0 te ofrece dos niveles de control:

• Por instancia de editor: Usa editorConfig.customization.ai con el parámetro disabled para ocultar las funciones de IA en una configuración específica del editor.
• A nivel de servidor: Usa la configuración del servidor aiSettings.enable para desactivar las funciones de IA y excluir las Herramientas de IA de /plugins.json.

Esto es útil si ofreces diferentes niveles de servicio a los clientes o si algunas implementaciones necesitan permanecer libres de IA por razones de cumplimiento.

Aplicaciones modulares

ONLYOFFICE Docs 10.0 introduce aplicaciones modulares – una nueva forma de extender los editores sin cambiar su núcleo. Aplicaciones como Agentes de IA, Formularios, Salas y Archivos se integran en ONLYOFFICE Docs y añaden nueva funcionalidad.

Para los desarrolladores, esto significa que puedes habilitar solo las capacidades que tus usuarios necesitan, mantener tu integración ligera y expandir paso a paso a medida que tu producto crece.

Mejoras en seguridad y arquitectura

La versión 10.0 mueve varias protecciones a «activado por defecto», para que las nuevas integraciones empiecen desde una base más segura.

• JWT habilitado por defecto. JWT está ahora activado en default.json.
• Manejo de tokens más estricto. Si un secreto está vacío o no se establece, incluidos los secretos del inquilino, ONLYOFFICE Docs ahora rechaza el token en lugar de verificarlo o firmarlo.
• Tokens con alcance para las APIs de servicio. /converter, /docbuilder y /command ya no aceptan un token de la configuración del editor. Un nuevo campo operation en el token es opcional para estas solicitudes y obligatorio para /converter/from-file y /docbuilder/from-file.
• Verificación de integridad para archivos descargados. Cuando tu integración envía encabezados de integridad, el servidor verifica los archivos descargados en función de ellos. Los encabezados soportados incluyen Content-Digest, Repr-Digest, x-amz-checksum-*, y WOPI SHA256. Esto se controla mediante services.CoAuthoring.requestDefaults.checksumVerification, que es true por defecto.
• Anfitriones WOPI explícitos. Los anfitriones WOPI deben ahora ser permitidos por una regla de filtro IP. La regla comodín allow: * ya no es suficiente, por lo que especifica cada anfitrión de forma explícita.
• Controles de acceso a la API. Usa services.CoAuthoring.server.convertServiceEnable y services.CoAuthoring.server.docbuilderEnable para desactivar las API públicas de conversión y Document Builder. Ambas están true por defecto.
• Configuración de tiempo de ejecución más ajustada. Solo el nivel de logging de log4js ahora se puede cambiar a través de runtime.json.

Un vistazo más cercano a las últimas correcciones de seguridad

Edición de PDF en Document Builder

Document Builder ahora puede editar PDFs, lo que abre la puerta a muchos nuevos escenarios de automatización:

• OpenFile maneja PDFs de manera inteligente. Formularios PDF creados en ONLYOFFICE se abren en el editor de documentos. Otros PDFs se abren en el editor de PDF con acceso completo a la API PDF.
• PDFs protegidos por contraseña. El nuevo parámetro m_sPassword en OpenFile te permite abrir archivos protegidos.
• Creación de formularios PDF. Llama a CreateFile con el tipo pdf para crear formularios PDF.

En el lado del servidor, los formularios guardados como un PDF normal ahora se firman cuando los usuarios los envían. Esto te brinda una capa adicional de confianza en tus flujos de trabajo de formularios.

Alexander Trofimov, Jefe del Equipo de Desarrollo de Editores en ONLYOFFICE:

Con ONLYOFFICE Docs 10.0, hemos hecho que los editores sean aún más seguros para tus integraciones. Además, esta versión trae soporte completo de PDF a Document Builder, por lo que desarrolladores y usuarios finales pueden crear, editar y gestionar PDFs directamente desde Builder sin depender de soluciones alternativas o herramientas de terceros.

Actualizaciones de implementación y administración

Ejecutar ONLYOFFICE Docs en producción también se ha vuelto más fácil:

• El Panel de administración se inicia con el servidor. En las ediciones comerciales, el Panel de administración ahora se lanza automáticamente por defecto. También incluye bloques para ver el secreto JWT y botones para abrir e iniciar o detener el ejemplo de prueba.
• Creación de administradores desde la CLI. Ahora puedes crear el primer administrador a través de la CLI del host documentserver-admin, usando create-admin y reset-admin-password. Esto reemplaza la antigua página web que dependía de los logs de bootstrap.
• Recuperación automática de cambios no guardados. Si el servidor se apaga, los cambios no guardados se recuperan automáticamente en «archivos olvidados». Se ha eliminado el script separado changes2forgotten.
• Nuevo puerto por defecto. Las instalaciones DEB y RPM ahora utilizan el puerto 8083 por defecto. Actualiza tus reglas de proxy y firewall si es necesario.
• Mejor monitoreo. La nueva métrica coauth.connections incluye etiquetas mode (editar, vista en vivo, ver) y replica.
• Indicador de actualización de escritorio. En Windows, la opción de línea de comandos --prefer-alternate-url permite a los Desktop Editors descargar actualizaciones de una fuente alternativa.
• Página de bienvenida renovada. La página de bienvenida del servidor tiene un nuevo diseño.

Soporte de nuevos formatos de archivos

La versión 10.0 añade dos actualizaciones de formato que te ayudan a manejar más documentos con menos trabajo personalizado:

• Visualización y conversión de OFD. Puedes abrir y convertir archivos ofd. Al igual que con xps, se abren en modo de solo lectura.
• Conversión a XLS. Puedes convertir cualquier formato de hoja de cálculo al clásico formato xls. Esto es útil cuando tus usuarios o socios aún dependen de sistemas heredados.

Puntos finales multiparte para la carga directa de archivos

Hasta ahora, los servicios de conversión y Document Builder descargaban archivos fuente desde una URL. Eso significaba que tenías que alojar el archivo en algún lugar al que el servidor pudiera acceder. La versión 10.0 agrega dos nuevos puntos finales que eliminan este paso:

• POST /converter/from-file
• POST /docbuilder/from-file

Ambos aceptan datos en formato multipart/form-data. Puedes enviar un archivo o un script directamente en la solicitud, por lo que no necesitas exponerlo a través de una URL temporal.

Esta es una opción más limpia para muchos flujos de trabajo. Por ejemplo, un servicio backend puede convertir subidas de usuario al instante o ejecutar un script de Document Builder sin tener que preparar archivos primero.

Ejemplo de solicitud: convirtiendo TXT a DOCX

curl -f -X POST "https://documentserver/converter/from-file" 
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Título del Documento Ejemplo.txt"}' 
  -F 'file=@example.txt' 
  -o "Título del Documento Ejemplo.docx"

Modernización de la API de plugins

La API de plugins y macros recibió su mayor actualización en un tiempo.

Un nuevo objeto Editor global

Los métodos ahora se llaman como funciones regulares que devuelven una Promesa. En lugar de dirigir cada llamada a través de window.Asc.plugin.executeMethod, puedes escribir código asíncrono limpio:

const text = await Editor.GetSelectedText();

El resultado es un código más corto y legible que se adapta de forma natural a los proyectos modernos de JavaScript.

Nuevos métodos y eventos

La versión 10.0 también agrega nuevas herramientas para construir plugins más ricos:

• Métodos: Editor.RunMacro, GetRestrictions, SetButtonDisabled, GetOFormRole
• Eventos: onFloatActionButtonClick, onSelectionEnd, onSelectionCancel

Por ejemplo, los eventos de selección permiten que tu plugin reaccione en el momento en que un usuario finaliza o cancela una selección.

Consulta la lista completa de cambios para la API de plugins

Comienza a construir con ONLYOFFICE 10.0

La versión 10.0 te ofrece APIs más limpias, más potencia de automatización y configuraciones más seguras. Aquí tienes un plan rápido para aprovecharlo al máximo:

• Revisa los cambios en el comportamiento. Verifica el uso de tokens, las reglas de filtro IP de WOPI y el nuevo puerto por defecto.
• Actualiza tus plugins. Cambia al objeto global Editor y sustituye cualquier método renombrado o eliminado.
• Prueba los nuevos puntos finales. Pon a prueba /converter/from-file y /docbuilder/from-file en tus flujos de trabajo de conversión.
• Decide sobre la IA. Configura editorConfig.customization.ai o aiSettings.enable para adaptarlo a las necesidades de tu producto.

DESCARGAR

¿Está construyendo con la versión en la nube de ONLYOFFICE Docs?  Prueba Docs Connect para una forma más fácil de conectar los editores con plataformas y servicios externos. A diferencia de la versión autoalojada de ONLYOFFICE Docs, que requiere que despliegues y mantengas los editores en tus propios servidores, Docs Connect maneja el alojamiento, el mantenimiento y las actualizaciones regulares por ti.

Consulta el registro de cambios completo para cada detalle y comparte tus comentarios en el foro de la comunidad de ONLYOFFICE. ¡Estamos ansiosos por ver lo que construyes!