ONLYOFFICE Document Builder v7.2: comandi JS, libreria .Net, conversione JSON, metodi OLE object e altro

6 ottobre 2022By Elena

Abbiamo notevolmente migliorato l’API Doc Builder aggiornando i wrapper, aggiungendo la conversione da e verso JSON, più opzioni per lavorare con oggetti OLE, moduli, Word Art, grafici e tabelle. Scopri tutti i dettagli di seguito.

ONLYOFFICE Document Builder v7.2: JS commands, .Net library, JSON conversion, OLE object methods, and more

Completamente ottimizzato

Abbiamo aggiornato completamente l’API nativa di ONLYOFFICE Doc Builder per rendere più agevole la generazione di documenti utilizzando i comandi JS anziché quelli di testo. L’API di integrazione include nuove classi e metodi che semplificano il lavoro con i tipi di dati С/С++.

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

Inoltre, abbiamo aggiunto la libreria .Net doctrenderer che consente di lavorare con l’API Doc Builder nella tua app basata su .Net. Aggiungeremo anche l’opzione wrapper Java un po’ più tardi.

Conversione JSON

Con i nuovi metodi FromJSON e ToJSON puoi convertire l’oggetto JSON specificato nell’oggetto Document Builder del tipo corrispondente e viceversa — convertire l’oggetto ApiDocument nell’oggetto JSON. Questo vale per elementi come collegamenti ipertestuali, paragrafi, numerazioni, tabelle, diapositive, ecc.

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

Metodi OLE

Abbiamo aggiunto la classe ApiOleObject all’API Doc Builder. Ad esempio, con il metodo CreateOleObject puoi creare un oggetto OLE con i parametri specificati. In pratica, ciò consente di aggiungere e modificare fogli di lavoro come oggetti OLE incorporati in documenti di testo, fogli e diapositive, cosa può essere utile quando si lavora con statistiche e report intelligenti.

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

Nuovi metodi di modulo

Grazie ai nuovi metodi dei moduli, ora è possibile recuperare un elenco di tutti i tag utilizzati per Content Controls e moduli nel documento, nonché recuperare un elenco di Content Controls e moduli con il nome del tag specificato. Questo semplifica il lavoro con i campi in modalità automatica, ad esempio durante l’analisi di un documento senza aprirlo.

OTTIENI DOC BUILDER

Note di chiusura, note a piè di pagina, Word Art

Crea documenti con note di chiusura e note a piè di pagina:

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

Inoltre, ora puoi creare oggetti Word Art durante la generazione di documenti di testo, fogli di calcolo, e presentazioni.

Altri metodi per grafici e disegni

Nuovi metodi grafici includono:

  • ApplyChartStyle per impostare uno stile per il grafico presente in base all’ID stile;
  • SetLegendFill per impostare un riempimento nella legenda del grafico;
  • SetSeriaValues per impostare i valori dalla gamma specificata alla serie specificata;
  • SetTitleFill per impostare il riempimento nel titolo del grafico;
  • e altro.

Tra i metodi di disegno aggiornati troverai:

  • ReplaceDrawing per sostituire un disegno con uno nuovo;
  • GetLockValue per recuperare il valore di blocco per il tipo di blocco specificato del disegno presente;
  • SetDrawingPrFromDrawing per impostare le proprietà da un altro disegno a quello attuale;
  • e molti altri.

Altri aggiornamenti

Con i metodi UpdateAllTOC e UpdateAllTOF, puoi aggiornare tutti i sommari e tutti gli indici nel documento corrente. I nuovi metodi delle tabelle per i documenti di testo consentono di impostare/ottenere la descrizione della tabella e il titolo/didascalia della tabella. Esplora l’elenco completo dei nuovi metodi con le descrizioni