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.
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
