ONLYOFFICE Docs 9.3 para desarrolladores: API de PDF, nuevos métodos para API JavaScript de Office y más

ONLYOFFICE Docs 9.3  trae una gran cantidad de actualizaciones para desarrolladores. Esta versión amplía significativamente las capacidades de nuestra API, ofreciendo mayor control y flexibilidad para integrar y extender los editores. Veamos las mejoras clave.

Introducción de la nueva API de PDF

Una de las adiciones más importantes en la versión 9.3 es la nueva API de PDF. Este potente conjunto de herramientas permite crear y manipular documentos PDF de manera programática. Ahora puedes construir archivos PDF complejos desde cero, agregando diversos elementos como texto, imágenes, tablas y formas.

La API ofrece un control amplio sobre la estructura y el contenido del documento. Puedes gestionar páginas, trabajar con formato de texto enriquecido e insertar dibujos y otros objetos con precisión. Esto abre nuevas posibilidades para automatizar la generación de documentos y crear soluciones personalizadas basadas en PDF dentro de tus aplicaciones.

Ejemplo de código para crear un nuevo archivo PDF:

// create a PDF file with ONLYOFFICE Document Builder
builder.CreateFile("pdf")

// create a new 'oDocument' variable and get the created PDF document
const oDocument = Api.GetDocument()

// create a new paragraph for the PDF content
const oParagraph = Api.CreateParagraph()

// set the paragraph justification to center the text
oParagraph.SetJc("center")

// add a text containing a single 'Center' word to the paragraph
oParagraph.AddText("Center")

// push the paragraph to the document
oDocument.Push(oParagraph)

// save the resulting PDF document as a file in the .pdf format with the 'example.pdf' name and close it
builder.SaveFile("pdf", "example.pdf")
builder.CloseFile()

Actualizaciones en la API JavaScript de Office

La Office JavaScript API ha recibido una mejora sustancial, con numerosos métodos nuevos en diferentes módulos para mejorar la automatización e interacción con documentos.

Mejoras en formularios

Se ha añadido un conjunto completo de métodos para trabajar con formularios. Ahora puedes gestionar programáticamente los campos de formulario, incluyendo botones, casillas de verificación, cuadros combinados y campos de texto. Esto permite la creación e interacción dinámica de formularios, facilitando la construcción de soluciones sofisticadas para la entrada de datos.

Capacidades ampliadas de dibujo y anotación

La API para dibujos y anotaciones se ha mejorado significativamente. Los nuevos métodos permiten un control más fino sobre formas, geometría y propiedades visuales como rellenos y trazos. Esto incluye métodos nuevos para gestionar:

• Anotaciones (caret, círculo, resaltado, tinta, etc.)
• Geometrías y trayectorias
• Rellenos (degradados, colores) y trazos

Ejemplo de código para el método ApiStroke/GetFill (API de hojas de cálculo):

// Creates a shape with a colored border and retrieves its fill properties.
let worksheet = Api.GetActiveSheet();
let fill = Api.CreateSolidFill(Api.CreateRGBColor(255, 200, 100));
let stroke = Api.CreateStroke(2 * 36000, Api.CreateSolidFill(Api.CreateRGBColor(0, 0, 255)));
let shape = worksheet.AddShape("rect", 60 * 36000, 40 * 36000, fill, stroke, 3, 0, 2, 2);
let strokeObj = shape.GetLine();
if (strokeObj) {
    let strokeFill = strokeObj.GetFill();
    if (strokeFill) {
        worksheet.GetRange("A1").SetValue("Stroke fill type: " + strokeFill.GetType());
    }
}

Métodos avanzados para gráficos y tablas

Trabajar con gráficos y tablas ahora es más flexible. Los nuevos métodos ApiChart y ApiTable proporcionan un mayor control programático sobre su creación y modificación, permitiendo construir documentos más dinámicos y ricos en datos.

Otras adiciones notables a la API JavaScript

• Filtros y validación: Se han introducido nuevos métodos para Autofilter, Filter, y Validation para gestionar mejor los datos en hojas de cálculo.
• Notas al pie y finales: Agrega y gestiona programáticamente notas al pie y notas finales en tus documentos.
• Hipervínculos y transiciones: Obtén más control sobre hipervínculos y transiciones de diapositivas en presentaciones.

Consulta la lista completa de métodos nuevos

Mejoras en la API de plugins y macros

La API para plugins y macros también recibe actualizaciones importantes en la versión 9.3. Estas mejoras están diseñadas para ofrecer a los desarrolladores más opciones para ampliar la funcionalidad de los editores ONLYOFFICE. Ahora puedes crear plugins más potentes e integrados, automatizar flujos de trabajo complejos con macros y ofrecer funciones personalizadas adaptadas a necesidades específicas de los usuarios.

Por ejemplo, el método IsFormSigned verifica si el formulario especificado ha sido firmado digitalmente.

window.Asc.plugin.executeMethod ("IsFormSigned", [], function(isSigned) {    
console.log ("Form is signed: " + isSigned);
});

La API recién introducida para macros en el Editor de PDF permite agregar, eliminar y editar páginas, formularios, anotaciones, formas automáticas, tablas, imágenes y gráficos. Por ejemplo, aquí está el método SetMacros dentro de window.Asc.plugin.executeMethod para la API de PDF:

window.Asc.plugin.executeMethod ("SetMacros", [JSON.stringify (Content)], function () {    
window.Asc.plugin.executeCommand ("close", "");
});

Consulta el changelog completo para la API de plugins y macros