ONLYOFFICE Document Builder v7.2: JS-Befehle, .Net-Bibliothek, JSON-Konvertierung, Methoden für OLE-Objekte und mehr

Wir haben die Doc Builder-API erheblich verbessert, indem wir die Wrappers aktualisiert, die Konvertierung von und nach JSON sowie weitere Optionen für die Arbeit mit OLE-Objekten, Formularen, Word Art, Diagrammen und Tabellen hinzugefügt haben. Erfahren Sie in diesem Beitrag alle Details.

Vollständig optimiert

Wir haben die native ONLYOFFICE Doc Builder API vollständig aktualisiert, um die Dokumentenerstellung mit JS-Befehlen statt Textbefehle komfortabler zu machen.

Die Integrations-API enthält neue Klassen und Methoden, die die Arbeit mit С/С++-Datentypen vereinfachen.

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

Außerdem haben wir die .Net doctrenderer-Bibliothek hinzugefügt, die das Arbeiten mit der Doc Builder API in Ihrer .Net-basierten App ermöglicht. Wir werden auch die Java Wrapper-Option später ergänzen.

JSON-Konvertierung

Mit den neuen Methoden FromJSON und ToJSON können Sie das angegebene JSON-Objekt in das Document Builder-Objekt des entsprechenden Typs umwandeln und umgekehrt — das ApiDocument-Objekt ins JSON-Objekt konvertieren. Dies gilt für Elemente wie Hyperlinks, Absätze, Nummerierungen, Tabellen, Folien, usw.

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

OLE-Methoden

Wir haben die Klasse ApiOleObject zur Doc Builder-API hinzugefügt. Mit der Methode CreateOleObject können Sie zum Beispiel ein OLE-Objekt mit den angegebenen Parametern erstellen. In der Praxis ermöglicht dies das Hinzufügen und Bearbeiten von Tabellenkalkulationen als OLE-Objekte, die in Textdokumente, Blätter und Folien eingebettet sind, was bei der Arbeit mit intelligenten Statistiken und Berichten nützlich sein kann.

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

Neue Methoden für Formulare

Dank der neuen Formularmethoden ist es jetzt möglich, eine Liste aller Tags abzurufen, die für Inhaltssteuerelemente und Formulare im Dokument verwendet werden, sowie eine Liste aller Inhaltssteuerelemente und Formulare mit dem angegebenen Tagnamen zurückzubekommen.

Dies vereinfacht die Arbeit mit Feldern im automatischen Modus, zum Beispiel beim Parsen eines Dokuments, ohne es zu öffnen.

DOC BUILDER ERHALTEN

Endnoten, Fußnoten, Word Art

Erstellen Sie Dokumente mit Endnoten und Fußnoten:

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

Außerdem können Sie jetzt Word-Art-Objekte beim Erstellen von Textdokumenten, Tabellenkalkulationen und Präsentationen.

Weitere Methoden für Diagramme und Zeichnungen

Zu den neuen Methoden für Diagramme gehören:

• ApplyChartStyle, um einen Stil für das aktuelle Diagramm nach der Stil-ID festzulegen;
• SetLegendFill, um eine Füllung für die Diagrammlegende festzulegen;
• SetSeriaValues, um Werte aus dem angegebenen Bereich auf die genannte Reihe zu übertragen;
• SetTitleFill, um die Füllung auf den Diagrammtitel zu setzen;
• und mehr.

Unter den aktualisierten Zeichnungsmethoden finden Sie:

• ReplaceDrawing, um eine Zeichnung durch eine neue Zeichnung zu ersetzen;
• GetLockValue, um den gesperrten Wert für den angegebenen Sperrtyp der aktuellen Zeichnung zurückzubekommen;
• SetDrawingPrFromDrawing, um die Eigenschaften einer anderen Zeichnung in die aktuelle Zeichnung zu übernehmen;
• und einige andere.

Sonstige Updates

Mit den Methoden UpdateAllTOC und UpdateAllTOF können Sie alle Inhaltsverzeichnisse und alle Abbildungsverzeichnisse des aktuellen Dokuments aktualisieren.

Neue Methoden für Tabellen in Textdokumenten ermöglichen das Setzen/Abrufen der Tabellenbeschreibung und des Tabellentitels/der Tabellenüberschrift.

Die vollständige Liste der neuen Methoden mit Beschreibungen