ONLYOFFICE Document Builder v7.2: comandos JS, biblioteca .Net, conversão JSON, métodos de objeto OLE e muito mais

6 October 2022 By Klaibson 0 40

Aprimoramos consideravelmente a API do Doc Builder atualizando wrappers, adicionando conversão de e para JSON, mais opções para trabalhar com objetos OLE, formulários, Word Art, gráficos e tabelas. Saiba todos os detalhes abaixo.

Completamente otimizado

Atualizamos totalmente a API nativa ONLYOFFICE Doc Builder para tornar a geração de documentos mais confortável usando comandos JS em vez de comandos de texto.

A API de integração inclui novas classes e métodos que facilitam o trabalho com tipos de dados С/С++.

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);

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);

Além disso, adicionamos a biblioteca .Net doctrenderer que permite trabalhar com a API Doc Builder em seu aplicativo baseado em .Net. Também vamos adicionar a opção Java wrapper um pouco mais tarde.

Conversão JSON

Com o novo FromJSON e ToJSON métodos, você pode converter o objeto JSON especificado no objeto Document Builder do tipo correspondente e vice-versa — converter o objeto ApiDocument no objeto JSON. Isso se aplica a elementos como hiperlinks, parágrafos, numerações, tabelas, slides, etc.

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

builder.CreateFile("docx");

var oDocument = Api.GetDocument();

.....

var sJSON = oDocument.ToJSON(false, false, true, true);

....

builder.SaveFile("docx", "ToJSON.docx");

builder.CloseFile();

Método OLE

Nós adicionamos o ApiOleObject classe para a API do Doc Builder. Por exemplo, com o método CreateOleObject, você pode criar um objeto OLE com os parâmetros especificados. Na prática, isso permite adicionar e editar planilhas como objetos OLE incorporados em documentos de texto, planilhas e slides, o que pode ser útil ao trabalhar com estatísticas e relatórios 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();

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();

Novos métodos de formulário

Graças aos novos métodos de formulário, agora é possível recuperar uma lista de todas as tags usadas para Controle de conteúdos Controls e formulários no documento, bem como obter de volta uma lista de todos Controles de conteúdos e formulários com o nome de tag especificado.

Ele simplifica o trabalho com campos no modo automático, por exemplo, ao analisar um documento sem abri-lo.

OBTENHA O DOC BUILDER

Notas de fim, notas de rodapé, Word Art

Crie documentos com notas de fim e notas de rodapé:

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();

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();

Além disso, agora você pode criar objetos Word Art ao gerar documentos de texto, planilhas, e apresentações.

Mais métodos de gráficos e desenhos

Novos métodos de gráfico incluem:

ApplyChartStyle para definir um estilo para o gráfico atual por ID de estilo;
SetLegendFill para definir um preenchimento para a legenda do gráfico;
SetSeriaValues para definir valores do intervalo especificado para a série especificada;
SetTitleFill para definir o preenchimento do título do gráfico;
e mais.

Entre os métodos de desenho atualizados, você encontrará:

ReplaceDrawing substituir um desenho por um novo;
GetLockValue para recuperar o valor de bloqueio para o tipo de bloqueio especificado do desenho atual;
SetDrawingPrFromDrawing para definir as propriedades de outro desenho para o atual;
e vários outros.