ONLYOFFICE Docs v7.3 para desarrolladores: actualizaciones de la API y del Doc Builder

7 febrero 2023Por Sergey

Junto con el lanzamiento de las nuevas características de la versión 7.3, hemos actualizado la API para los editores, plugins y el Document Builder. Descubre todos los detalles a continuación.

Mayor compatibilidad con WOPI

Ahora puedes trabajar con formatos binarios como doc, ppt, y xls en las integraciones con WOPI. Hemos implementado el esquema correspondiente que incluye la acción convertir en la detección WOPI. Convierte archivos binarios en docx, pptx, y xlsx para su edición posterior.

Además, hemos añadido la API de conversión de WOPI para facilitar el trabajo con distintos formatos de archivos ofimáticos.

<form action="https://documentserver/cool/convert-to/docx" enctype="multipart/form-data" method="post">     
File: <input type="file" name="data"><br/>     
<input type="submit" value="Convert to DOCX">
</form>

Otras mejoras son:

La propiedad UserCanNotWriteRelative en la operación CheckFileInfo de WOPI especifica si un usuario tiene permisos para crear nuevos archivos en el servidor WOPI o no;
La operación WOPI PutRelativeFile crea un nuevo archivo en el host basado en el archivo actual.

Inserción de datos externos en hojas de cálculo

El nuevo parámetro document.referenceData define un objeto generado por el integrador para identificar de forma única un archivo en su sistema.

Junto con el método setReferenceData implementado y el evento onRequestReferenceData ahora es posible actualizar los datos mediante un enlace a un archivo, cuando un usuario intenta actualizar valores insertados desde el archivo externo haciendo clic en el botón correspondiente del cuadro de diálogo Enlaces externos. Más información

var onRequestReferenceData = function () {
var referenceData =  event.data.referenceData;
var path = event.data.path;
   ...
docEditor.setReferenceData({
 "fileType": "xlsx",
 "path": "sample.xlsx",
 "referenceData": {
"fileKey": "BCFA2CED",
"instanceId": "https://example.com"
 },
 "url": "https://example.com/url-to-example-document.xlsx"
 });
};
var docEditor = new DocsAPI.DocEditor("placeholder", {
"events": {
"onRequestReferenceData": onRequestReferenceData, 
 ...
    },
 ...
});

Personalización de la interfaz

Los usuarios de ONLYOFFICE Docs Developer Edition con la licencia extendida obtienen nuevas opciones para personalizar el frontend de los editores a través del archivo de configuración:

ajustar el tipo de fuente de los elementos de la interfaz, como botones, pestañas, etc.;
definir el valor inicial de la visibilidad del panel derecho/izquierdo: mostrado u oculto.

Actualizaciones de la API para plugins y macros

Tipo Sign en el parámetro de configuración initDataType.
Método GetVBAMacros que devuelve todas las macros VBA del documento.
Método OnDropEvent que implementa la emulación externa de arrastrar y soltar.
Métodos Spreadsheet Api y Presentation Api disponibles para window.Asc.plugin.executeMethod.

Comprueba este ejemplo de código para el método OnDropEvent:

window.Asc.plugin.executeMethod("OnDropEvent", [{
  type: "ondrop",
  x : pos.x,
  y : pos.y,
  text : "test text",
  html : "test html"
}]);

Consigue la última versión de ONLYOFFICE Docs Developer Edition:

DESCARGAR AHORA

Actualizaciones de la API del Document Builder

En la API de DocBuilder, hemos añadido un montón de nuevos métodos para comentarios, tablas de contenido, etc., entre los que se incluyen los siguientes: