ONLYOFFICE Document Builder v7.2: comandos de JS, biblioteca .Net, conversión de JSON, métodos de objetos OLE y más

6 octubre 2022By Sergey

Hemos mejorado considerablemente la API de Doc Builder, actualizando los wrappers, añadiendo la conversión a y de JSON, más opciones para trabajar con objetos OLE, formularios, Word Art, gráficos y tablas. Descubre todos los detalles a continuación.

Optimización completa

Hemos actualizado completamente la API nativa de ONLYOFFICE Doc Builder para que la generación de documentos sea más cómoda usando los comandos de JS en vez de los de texto.

La integración API incluye nuevas clases y métodos que facilitan el trabajo con los tipos de datos С/С++.

CValue oApi = oGlobal["Api"]; 
CValue oDocument = oApi.Call("GetDocument"); 
CValue oParagraph = oApi.Call("CreateParagraph"); 
oParagraph.Call("SetSpacingAfter", 1000, false); 
oParagraph.Call("AddText", "Hello, world!"); 
CValue oContent = oContext.CreateArray(1); 
oContent[0] = oParagraph; 
oDocument.Call("InsertContent", oContent);

Además, hemos añadido la biblioteca .Net doctrenderer que permite trabajar con la API de Doc Builder en tu aplicación basada en .Net. También vamos a añadir la opción de Java wrapper un poco más tarde.

Conversión de JSON

Con los nuevos métodos FromJSON y ToJSON, puedes convertir el objeto JSON especificado en el objeto de Document Builder del tipo correspondiente y viceversa – convertir el objeto ApiDocument en el objeto JSON. Esto se aplica a elementos como hiperenlaces, párrafos, numeraciones, tablas, diapositivas, etc.

builder.CreateFile("docx");
var oDocument = Api.GetDocument();
.....
var sJSON = oDocument.ToJSON(false, false, true, true);
....
builder.SaveFile("docx", "ToJSON.docx");
builder.CloseFile();

Métodos OLE

Hemos añadido la clase ApiOleObject a la API de Doc Builder. Por ejemplo, con el método CreateOleObject, puedes crear un objeto OLE con los parámetros especificados. En la práctica, esto permite añadir y editar hojas de cálculo como objetos OLE incrustados en documentos de texto, hojas y diapositivas lo que puede ser útil cuando trabajas con estadísticas e informes inteligentes.

builder.CreateFile("xlsx"); 
var oWorksheet = Api.GetActiveSheet(); 
oWorksheet.AddOleObject("https://i.ytimg.com/vi_webp/SKGz4pmnpgY/sddefault.webp", 130 * 36000, 90 * 36000, "https://youtu.be/SKGz4pmnpgY", "asc.{38E022EA-AD92-45FC-B22B-49DF39746DB4}", 0, 2 * 36000, 4, 3 * 36000); 
builder.SaveFile("xlsx", "AddOleObject.xlsx"); 
builder.CloseFile();

Nuevos métodos de formulario

Gracias a los nuevos métodos de formulario, ahora es posible recuperar una lista de todas las etiquetas que se utilizan para los controles de contenido y los formularios en el documento, así como obtener una lista de todos los controles de contenido y los formularios con el nombre de etiqueta especificado.

Esto simplifica el trabajo con los campos en el modo automático, por ejemplo, cuando es necesario analizar un documento sin abrirlo.

OBTENER DOC BUILDER

Notas al final, notas al pie, Word Art

Crea documentos con notas al final y notas al pies:

builder.CreateFile("docx"); 
var oDocument = Api.GetDocument();  
var oParagraph = oDocument.GetElement(0);  
oParagraph.AddText("This is just a sample text."); 
oDocument.AddEndnote();
builder.SaveFile("docx", "AddEndnote.docx");
builder.CloseFile();

Además, ahora puedes crear objetos de Word Art al generar documentos de texto, hojas de cálculo y presentaciones.

Más métodos para gráficos y dibujos

Los nuevos métodos para gráficos incluyen:

ApplyChartStyle para aplicar un estilo al gráfico actual por el ID del estilo;
SetLegendFill para establecer un relleno a la leyenda del gráfico;
SetSeriaValues para establecer los valores del rango especificado a la serie especificada;
SetTitleFill para establecer el relleno del título del gráfico;
y más.

Entre los métodos para dibujos actualizados encontrarás:

ReplaceDrawing para sustituir un dibujo por uno nuevo;
GetLockValue para recuperar el valor de bloqueo para el tipo de bloqueo especificado del dibujo actual;
SetDrawingPrFromDrawing para establecer las propiedades de otro dibujo en el actual;
y otros más.

Otras actualizaciones

Con los métodos UpdateAllTOC y UpdateAllTOF, es posible actualizar todas las tablas de contenido y todas las tablas de ilustraciones del documento actual.

Los nuevos métodos de tabla para los documentos de texto permiten establecer/obtener la descripción de la tabla y el título/subtítulo de la tabla.

Consulta la lista completa de los nuevos métodos con sus descripciones