ONLYOFFICE Docs 7.2 para desarrolladores: actualizaciones de la API

6 octubre 2022By Sergey

Además de las nuevas características de la versión 7.2, hemos actualizado la API para los editores y plugins. Descubre los detalles a continuación.

ONLYOFFICE Docs 7.2 para desarrolladores: actualizaciones de la API

Visor en vivo y nuevos parámetros de licencia

El visor en vivo permite a los usuarios ver los cambios realizados por otros colaboradores en tiempo real cuando abren un documento, una hoja de cálculo o una presentación en el modo de sólo visualización. Más información

Para implementar esta característica, necesitas obtener una nueva licencia que incluirá campos separados para el visor en vivo: connections_view y users_view_count para el número de conexiones y usuarios, y users_view para la cuota de usuarios. Para saber más, consulta la información de respuesta de la licencia.

Ten en cuenta que las conexiones del servidor para el visor en vivo se cuentan por separado del número total de conexiones simultáneas*.

*El número de pestañas del navegador con documentos que se pueden abrir para editar al mismo tiempo.

Trabajo con documentos desde el exterior

Una nueva clase API permite interactuar con documentos de texto, hojas de cálculo, presentaciones y formularios rellenables desde el exterior. De este modo, puedes crear un conector especial para realizar cambios en los documentos utilizando tus propios botones/métodos en lugar de los botones del editor. Por ejemplo, puedes generar un feed con los comentarios de todos tus documentos, responder a ellos y cerrar los comentarios en un solo lugar, o rellenar automáticamente los formularios con los datos exportados de las bases de datos.

Ojo: la clase API para conectores está incluida en la API avanzada y por el momento sólo está disponible como demo (se añadirá a la documentación de la API con la próxima actualización – versión 7.2.1). Si quieres probarla ahora, ponte en contacto con nuestro equipo de ventas a través de sales@onlyoffice.com.

Mejoras en la API para los plugins

Marketplace de plugins. El nuevo gestor de plugins permite a los usuarios explorar todos los plugins disponibles e instalar o eliminar cualquier plugin con un solo clic directamente en los editores. En este sentido, hemos actualizado las instrucciones en la documentación de la API sobre la creación y adición de plugins. También puedes leer esta entrada del blog.

Esquema de localización actualizado. Ahora puedes añadir un archivo langs.json en la carpeta con las traducciones. Más información

El nuevo archivo contiene los nombres de los archivos con las traducciones para un idioma específico y comprende una matriz del siguiente tipo:

[ 
  "cs-CZ",
  "de-DE",
  "es-ES",
  "fr-FR",
  "ru-RU"
]

Nuevos métodos: ChangeOleObject, GetAllForms, GetFileToDownload, GetFormsByTag, GetFormValue, GetImageDataFromSelection, GetInstalledPlugins, InstallPlugin, PutImageDataToSelection, RemovePlugin, SetFormValue, ShowButton, UpdatePlugin, etc.

Consulta el registro de cambios completo de la API para los plugins

JWT habilitado por defecto

A partir de la versión 7.2 se genera automáticamente un secreto JWT aleatorio y sólo hay que añadirlo en el lado de la aplicación principal. Puedes obtener el secreto JWT por defecto y sustituirlo por una clave personalizada si es necesario. Más información

Otras actualizaciones de la API

Tema Contraste oscuro. Habilita una nueva variación del tema Oscuro en el parámetro editorConfig.customization.uiTheme. Tiene tonos aún más oscuros, mientras que la interfaz del editor es casi negra.

"customization": { ......
   "uiTheme": "theme-contrast-dark",
    }, .......

Ajuste de la sección Acerca de. Ahora puedes añadir el número de teléfono de tu empresa en la sección Acerca de en los editores, junto con tu logotipo, dirección, correo electrónico, etc. Para ello, configura el parámetro editorConfig.customization.customer.

"editorConfig": {         
    "customization": { ........
         "customer": {
         "address": "My City, 123a-45",
           .....
         "phone": "37188888888"
           },

Códigos de idioma de cuatro letras. El parámetro editorConfig.lang que define el idioma de la interfaz del editor admite códigos de cuatro letras. Por ejemplo, para establecer el idioma portugués, especifica pt-pt, mientras que pt-br indica el portugués de Brasil.

"editorConfig": {
.....
 "lang": "pt-pt",

Lo mismo ocurre con los códigos de idioma zh-cn (chino simplificado) y zh-tw (chino tradicional).

Nueva acción para WOPI discovery. La acción embedview en WOPI discovery muestra una vista no editable de un documento optimizada para su incrustación en una página web:

<action name="embedview" ext="docx"...

Funciona en nuestra integración WOPI con SharePoint sustituyendo la URL según estas instrucciones y es relevante para todos los integradores WOPI independientes.

Calculadora de precios actualizada

La nueva calculadora de paquetes permite configurar más parámetros como multiinquilinato y multiservidor, acceso a la API avanzada, visor en vivo, etc. Más información

CALCULAR AHORA