ONLYOFFICE Docs 8.2 para desarrolladores: las actualizaciones de la API

31 octubre 2024By Sergey

Junto con el lanzamiento de las nuevas características de la versión 8.2, hemos actualizado la API para los editores, la API de oficina y los plugins, hemos añadido el Framework Java para el Document Builder, así como el SDK de integración de PHP. Descubre todos los detalles a continuación.

Implementación sin tiempo de inactividad

La implementación sin tiempo de inactividad es una excelente forma de actualizar una aplicación sin necesidad de pausas. De este modo, es posible actualizar los editores sin tener que desconectarlos.

¿Cómo funciona? La instancia de ONLYOFFICE Docs (Document Server, DS) con la nueva versión se lanza en paralelo al Document Server actualmente en ejecución. Se abren nuevas sesiones de edición en el nuevo DS. La versión anterior del DS funciona hasta que los usuarios terminan sus sesiones de edición. Solo después de eso el DS anterior se para.

Si hablamos de ONLYOFFICE Docs Shards, aquí podemos dirigir una sesión de edición al DS específico en el clúster. Por lo tanto, es posible tener Document Servers de diferentes versiones trabajando en paralelo. No olvides tener en cuenta que la duplicación de recursos y el propio proceso de actualización pueden llevar algún tiempo.

Ojo: La implementación sin tiempo de inactividad está disponible para ONLYOFFICE Docs distribuido como Kubernetes Shards. ¿Quieres obtener más información? Ponte en contacto con nosotros a través de sales@onlyoffice.com.

SDK de integración de PHP

Integra fácilmente ONLYOFFICE Docs en tu aplicación escrita en PHP. El SDK incluye el código general para integraciones PHP, creando la configuración de inicialización y manejando métodos comunes en el backend. Compruébalo aquí

El SDK de PHP ya está implementado, por ejemplo, en la integración de ONLYOFFICE y Chamilo.

Nuevos estilos de interfaz

El parámetro editorConfig.customization.features incluye dos campos más – tabStyle y tabBackground. De este modo, puedes ajustar la apariencia del editor a tu gusto.

El primero permite establecer el estilo Relleno (las pestañas de la barra de herramientas superior se muestran claramente) o Línea (las pestañas de la barra de herramientas superior se resaltan con subrayado).

El segundo define si el fondo de las pestañas de la barra de herramientas superior coincide con el fondo del encabezado o con el fondo de la barra de herramientas.

ONLYOFFICE Docs 8.2 para desarrolladores: las actualizaciones de la API

Además, hemos añadido el campo imageLight al parámetro editorConfig.customization.logo. Define la ruta al archivo de imagen utilizado para el encabezado claro, por ejemplo, en el tema Gris recién añadido.

ONLYOFFICE Docs 8.2 para desarrolladores: las actualizaciones de la API

const logo = {
  image: "https://example.com/logo.png",
  imageDark: "https://example.com/dark-logo.png",
  imageLight: "https://example.com/light-logo.png",
  url: "https://example.com",
  visible: true,
}

Inserción de texto de fuentes de terceros

El tipo de selección de documento insert-text se ha añadido al parámetro c del método setRequestedDocument. De esta forma, los usuarios pueden seleccionar un documento del archivo local/URL/almacenamiento para insertar su contenido en el documento actual.

docEditor.setRequestedDocument({
  c: "insert-text",
  fileType: "docx",
  url: "https://example.com/url-to-example-document.docx",
...

Comprobación del estado de los documentos

El parámetro users se añade ahora a la respuesta del comando info. Este parámetro define la lista de los identificadores de los usuarios que abrieron el documento para su edición. Cuando el documento haya sido modificado, los usuarios devolverán el identificador del usuario que fue el último en editar el documento.

{
  "error": 0,
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0", "78e1e841"]
}

¿Qué más ha cambiado en la API de Docs?

Nuevos parámetros de solicitud de la API de conversión WOPI para trabajar con documentos protegidos: Password PasswordToOpen.
La dirección https://documentserver/coauthoring/CommandService.ashx del servicio de comandos se sustituye por https://documentserver/coauthoring/command.
El campo editorConfig.location queda obsoleto. Por favor, utiliza en su lugar el campo editorConfig.region para definir las unidades de medida predeterminadas en todos los tipos de editor.
El campo editorConfig.customization.toolbarNoTabs está obsoleto, por favor utiliza en su lugar los campos editorConfig.customization.features.tabStyle y editorConfig.customization.features.tabBackground.

Obtén la última versión de ONLYOFFICE Docs Developer:

DESCARGAR AHORA

Notificaciones por correo electrónico: advertencias sobre el límite de licencias y cuotas

Ahora es posible enviar notificaciones por correo electrónico, por ejemplo, de que la licencia está a punto de expirar o de que se va a alcanzar el límite de conexiones.

¿Cómo funciona? Hemos añadido la posibilidad de configurar el servidor de correo en la configuración del servidor. Para enviar las notificaciones se utiliza un servidor de correo externo, cuya conexión se realiza a través de la biblioteca Nodemailer. Muchos ajustes de la configuración del servidor se transfieren directamente a esta biblioteca.

Mejoras de la API para plugins

La API para plugins también ofrece mejoras útiles, como métodos para realizar acciones de Deshacer y Rehacer.

api.prototype.Undo = function()
api.prototype.Redo = function()
api.prototype.CanUndo = function()
api.prototype.CanRedo = function()

Consulta la lista completa de actualizaciones de la API para plugins.

Framework Java para el Document Builder

Para el Document Builder de ONLYOFFICE ahora está disponible el framework Java Builder. Contiene una colección de bibliotecas, clases y funciones que hacen mucho más fácil desarrollar rápidamente aplicaciones en Java que cuentan con capacidades de creación de documentos.

ONLYOFFICE Docs 8.2 para desarrolladores: las actualizaciones de la API