ONLYOFFICE Docs 9.3 für Entwickler: PDF‑API, neue Methoden für die Office JavaScript‑API und mehr

ONLYOFFICE Docs 9.3 bringt zahlreiche Neuerungen für Entwickler. Diese Version erweitert die Möglichkeiten unserer API deutlich und bietet mehr Kontrolle und Flexibilität bei der Integration und Erweiterung der Editoren. Werfen wir einen Blick auf die wichtigsten Verbesserungen.

Einführung der neuen PDF‑API

Eine der bedeutendsten Neuerungen in Version 9.3 ist die brandneue PDF‑API. Dieses leistungsstarke Tool‑Set ermöglicht die programmatische Erstellung und Bearbeitung von PDF‑Dokumenten. Sie können jetzt komplexe PDF‑Dateien von Grund auf erstellen und verschiedene Elemente wie Text, Bilder, Tabellen und Formen hinzufügen.

Die API bietet umfangreiche Kontrolle über die Dokumentstruktur und -inhalte. Seiten lassen sich verwalten, Textformatierungen flexibel anpassen, Zeichnungen und andere Objekte präzise einfügen. Dadurch eröffnen sich neue Möglichkeiten zur Automatisierung der Dokumenterstellung und zur Entwicklung maßgeschneiderter, PDF-basierter Lösungen innerhalb Ihrer Anwendungen.

Beispielcode zum Erstellen einer neuen PDF‑Datei:

// PDF-Datei mit ONLYOFFICE Document Builder erstellen
builder.CreateFile("pdf")

// Neue Variable 'oDocument' anlegen und das erstellte Dokument abrufen
const oDocument = Api.GetDocument()

// Neuen Absatz für den PDF-Inhalt erzeugen
const oParagraph = Api.CreateParagraph()

// Text im Absatz zentrieren
oParagraph.SetJc("center")

// Ein Wort „Center“ hinzufügen
oParagraph.AddText("Center")

// Absatz in das Dokument einfügen
oDocument.Push(oParagraph)

// Das fertige PDF-Dokument als „example.pdf“ speichern und schließen
builder.SaveFile("pdf", "example.pdf")
builder.CloseFile()

Umfangreiche Updates für die Office JavaScript‑API

Die Office JavaScript‑API wurde umfassend überarbeitet. Zahlreiche neue Methoden in unterschiedlichen Modulen erweitern die Möglichkeiten zur Automatisierung und Interaktion in Dokumenten.

Verbesserungen für Formulare

Es steht jetzt eine Vielzahl neuer Methoden für die Arbeit mit Formularen zur Verfügung. Damit lassen sich Formularfelder wie Buttons, Kontrollkästchen, Kombinationsfelder und Textfelder programmatisch verwalten. So können Sie dynamische Formulare erstellen und steuern – perfekt für fortgeschrittene Datenerfassungsprozesse.

Erweiterte Funktionen für Zeichnungen und Anmerkungen

Die API für Zeichnungen und Anmerkungen wurde stark verbessert. Neue Methoden ermöglichen eine noch präzisere Steuerung von Formen, Geometrien und visuellen Eigenschaften wie Füllungen und Linien. Dazu gehören neue Methoden zur Verwaltung von:

• Anmerkungen (Caret, Kreis, Highlight, Tinte usw.)
• Geometrien und Pfaden
• Füllungen (Verläufe, Farben) und Linien

Beispielcode für die ApiStroke/GetFill-Methode (Spreadsheet‑API):

// Erstellt eine Form mit farbiger Umrandung und ruft deren Füllung ab
let worksheet = Api.GetActiveSheet();
let fill = Api.CreateSolidFill(Api.CreateRGBColor(255, 200, 100));
let stroke = Api.CreateStroke(2 * 36000, Api.CreateSolidFill(Api.CreateRGBColor(0, 0, 255)));
let shape = worksheet.AddShape("rect", 60 * 36000, 40 * 36000, fill, stroke, 3, 0, 2, 2);
let strokeObj = shape.GetLine();
if (strokeObj) {
    let strokeFill = strokeObj.GetFill();
    if (strokeFill) {
        worksheet.GetRange("A1").SetValue("Stroke fill type: " + strokeFill.GetType());
    }
}

Erweiterte Methoden für Diagramme und Tabellen

Die Arbeit mit Diagrammen und Tabellen ist jetzt noch flexibler. Neue ApiChart‑ und ApiTable‑Methoden ermöglichen mehr Kontrolle bei der Erstellung und Bearbeitung – ideal, um dynamische, datenreiche Dokumente zu erzeugen.

Weitere JavaScript‑API‑Erweiterungen

• Filter und Validierung: Neue Methoden für Autofilter, Filter und Validierung erleichtern die Verwaltung von Tabellendaten.
• Fußnoten und Endnoten: Diese lassen sich nun programmatisch hinzufügen und verwalten.
• Hyperlinks und Übergänge: Erweitertes Handling von Hyperlinks und Folienübergängen in Präsentationen.

Die vollständige Liste der neuen Methoden finden Sie hier

Verbesserungen für Plugins‑ und Makro‑APIs

Auch die API für Plugins und Makros wurde in Version 9.3 deutlich erweitert. Diese Verbesserungen geben Entwicklern mehr Möglichkeiten, die Funktionalität der ONLYOFFICE‑Editoren zu erweitern. So lassen sich leistungsfähigere Plugins entwickeln, komplexe Workflows automatisieren und Features noch gezielter auf spezifische Anforderungen zuschneiden.

Beispiel: Die IsFormSigned-Methode prüft, ob ein bestimmtes Formular digital signiert wurde:

window.Asc.plugin.executeMethod ("IsFormSigned", [], function(isSigned) {    
console.log ("Form is signed: " + isSigned);
});

Die neu eingeführte API für Makros im PDF‑Editor erlaubt das Hinzufügen, Löschen und Bearbeiten von Seiten, Formularen, Anmerkungen, Formen, Tabellen, Bildern und Diagrammen. Beispiel: Die SetMacros‑Methode innerhalb von window.Asc.plugin.executeMethod für die PDF‑API:

window.Asc.plugin.executeMethod ("SetMacros", [JSON.stringify (Content)], function () {    
window.Asc.plugin.executeCommand ("close", "");
});

Sehen Sie sich das vollständige Changelog für die Plugins- und Makro‑API an