ONLYOFFICE Document Builder v7.2: comandi JS, libreria .Net, conversione JSON, metodi OLE object e altro
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.
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.
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