ONLYOFFICE 10.0 für Entwickler: Was gibt es Neues

ONLYOFFICE 10.0 bringt eine solide Reihe von Updates für Entwickler, die auf den Editoren aufbauen. Sie erhalten neue Endpunkte, die das Dateihandling einfacher machen, die PDF-Bearbeitung im Document Builder und eine modernisierte Plugin-API mit asynchronen Methoden. Das Release fügt auch neue Steuerungen für KI-Funktionen und sicherere Standardeinstellungen über den Server hinzu.

Nachfolgend finden Sie eine schnelle Übersicht über die Änderungen, die für Ihre Integrationen am wichtigsten sind, sowie einige Verhaltensänderungen, die Sie vor dem Upgrade überprüfen sollten.

KI-Tools, KI-Anpassungsoptionen & serverseitige KI-Verwaltung

ONLYOFFICE Docs 10.0 bringt KI-Tools in jeden Editor. Mehr als die grundlegende Textgenerierung verstehen sie die Dokumentstruktur, erkennen Elemente, verbinden Inhalte über Abschnitte hinweg und erstellen klickbare Verweise für eine einfachere Navigation. Sie können jedes KI-Modell anschließen, einschließlich lokaler Modelle für datenschutzempfindliche Anwendungsfälle, und verschiedenen Modellen unterschiedliche Aufgaben zuweisen.

In den kommerziellen Ausgaben von ONLYOFFICE Docs 10.0 können Administratoren KI-Anbieter einmal im Admin-Panel konfigurieren. Nach der Einrichtung erhalten die Editoren-Benutzer sofort verwendbare KI-Tools, ohne ihre eigenen API-Schlüssel eingeben zu müssen. Administratoren können verschiedene Modelle spezifischen Aufgaben zuweisen, MCP-Server für den Zugriff auf externe Tools verbinden und steuern, ob eine Websuche verfügbar ist. Nach dem Speichern einer serverseitigen Konfiguration sind die Benutzer auf die genehmigten Anbieter und Modelle beschränkt – sie können keine eigenen Schlüssel mehr hinzufügen oder ändern, welches Modell verwendet wird. Erfahren Sie mehr

Sie entscheiden, ob KI-Tools in Ihrem Produkt erscheinen. Version 10.0 bietet Ihnen zwei Kontrollstufen:

• Pro Editor-Instanz: Nutzen Sie editorConfig.customization.ai mit dem disabled-Parameter, um KI-Funktionen in einer bestimmten Editor-Konfiguration auszublenden.
• Serverweit: Verwenden Sie die aiSettings.enable Server-Einstellung, um KI-Funktionen auszuschalten und KI-Tools aus /plugins.json auszuschließen.

Dies ist praktisch, wenn Sie verschiedene Kundenschichten bedienen oder wenn einige Bereitstellungen AI-frei bleiben müssen, um Compliance-Anforderungen zu erfüllen.

Modulare Apps

ONLYOFFICE Docs 10.0 führt modulare Apps ein – eine neue Möglichkeit, die Editoren zu erweitern, ohne deren Kern zu ändern. Apps wie KI-Agenten, Formulare, Räume und Dateien integrieren sich in ONLYOFFICE Docs und fügen neue Funktionen hinzu.

Für Entwickler bedeutet dies, dass Sie nur die Funktionen aktivieren können, die Ihre Benutzer benötigen, Ihre Integration schlank halten und schrittweise erweitern können, während Ihr Produkt wächst.

Sicherheits- und Architekturverbesserungen

Version 10.0 aktiviert mehrere Schutzmaßnahmen standardmäßig, sodass neue Integrationen von einem sichereren Ausgangspunkt ausgehen.

• JWT standardmäßig aktiviert. JWT ist jetzt in default.json aktiviert.
• Striktere Token-Verarbeitung. Wenn ein Geheimnis leer oder nicht gesetzt ist, einschließlich Mietergeheimnissen, lehnt ONLYOFFICE Docs das Token jetzt ab, anstatt es zu überprüfen oder zu signieren.
• Scoped Tokens für Service-APIs. /converter, /docbuilder und /command akzeptieren nicht mehr ein Token aus der Editor-Konfiguration. Ein neues operation-Feld im Token ist für diese Anfragen optional und für /converter/from-file und /docbuilder/from-file erforderlich.
• Integritätsüberprüfung für heruntergeladene Dateien. Wenn Ihre Integration Integritätsheader sendet, überprüft der Server heruntergeladene Dateien dagegen. Unterstützte Header umfassen Content-Digest, Repr-Digest, x-amz-checksum-* und WOPI SHA256. Dies wird durch services.CoAuthoring.requestDefaults.checksumVerification gesteuert, das standardmäßig true ist.
• Explizite WOPI-Hosts. WOPI-Hosts müssen jetzt durch eine IP-Filterregel erlaubt sein. Die Wildcard-Regel allow: * reicht nicht mehr aus, also geben Sie jeden Host explizit an.
• API-Zugriffskontrollen. Verwenden Sie services.CoAuthoring.server.convertServiceEnable und services.CoAuthoring.server.docbuilderEnable, um die öffentlichen Konvertierungs- und Document Builder-APIs zu deaktivieren. Beide sind standardmäßig true.
• Strengere Laufzeitkonfiguration. Nur die Protokollierungsebene von log4js kann jetzt über runtime.json geändert werden.

Ein genauerer Blick auf die neuesten Sicherheitsfixes

PDF-Bearbeitung im Document Builder

Document Builder kann jetzt PDFs bearbeiten, was viele neue Automatisierungsszenarien eröffnet:

• OpenFile verarbeitet PDFs intelligent. PDF-Formulare, die in ONLYOFFICE erstellt wurden, öffnen sich im Dokumenteneditor. Andere PDFs öffnen sich im PDF-Editor mit vollem Zugriff auf die PDF-API.
• Passwortgeschützte PDFs. Der neue m_sPassword-Parameter in OpenFile ermöglicht es Ihnen, geschützte Dateien zu öffnen.
• PDF-Formularerstellung. Rufen Sie CreateFile mit dem pdf-Typ auf, um PDF-Formulare zu erstellen.

Auf der Serverseite werden Formulare, die als reguläre PDF gespeichert sind, jetzt signiert, wenn Benutzer sie einreichen. Dies gibt Ihnen eine zusätzliche Vertrauensebene in Ihre Formular-Workflows.

Alexander Trofimov, Leiter des Editor-Entwicklungsteams bei ONLYOFFICE:

Mit ONLYOFFICE Docs 10.0 haben wir die Editoren noch sicherer für Ihre Integrationen gemacht. Darüber hinaus bringt dieses Release umfassende PDF-Unterstützung in den Document Builder, sodass Entwickler und Endbenutzer PDFs direkt aus dem Builder erstellen, bearbeiten und verwalten können, ohne auf Workarounds oder Drittanbietertools zurückgreifen zu müssen.

Bereitstellungs- und Admin-Updates

Die Ausführung von ONLYOFFICE Docs in der Produktion wurde ebenfalls einfacher:

• Admin-Panel startet mit dem Server. In den kommerziellen Ausgaben wird das Admin-Panel nun standardmäßig automatisch gestartet. Es enthält auch Blöcke zum Ansichts-JWT-Geheimnis und Schaltflächen zum Öffnen und Starten oder Stoppen des Testbeispiels.
• CLI-Admin-Erstellung. Sie erstellen jetzt den ersten Administrator über die documentserver-admin Host-CLI, indem Sie create-admin und reset-admin-password verwenden. Dies ersetzt die alte Webseite, die auf Bootstrap-Protokollen beruhte.
• Automatische Wiederherstellung nicht gespeicherter Änderungen. Wenn der Server herunterfährt, werden nicht gespeicherte Änderungen automatisch in „vergessenen Dateien“ wiederhergestellt. Das separate changes2forgotten-Skript wurde entfernt.
• Neuer Standardport. DEB- und RPM-Installationen verwenden jetzt standardmäßig den Port 8083. Aktualisieren Sie bei Bedarf Ihre Proxy- und Firewall-Regeln.
• Bessere Überwachung. Metrik coauth.connections umfasst jetzt mode (edit, liveview, view) und replica-Tags.
• Desktop-Update-Flag. Unter Windows ermöglicht das Kommandozeilenflag --prefer-alternate-url den Desktop-Editoren, Updates aus einer alternativen Quelle herunterzuladen.
• Frische Willkommensseite. Die Willkommensseite des Servers hat ein neues Design.

Neue Dateiformatunterstützung

Version 10.0 fügt zwei Format-Updates hinzu, die Ihnen helfen, mehr Dokumente mit weniger individuellem Aufwand zu bearbeiten:

• OFD-Anzeige und -Konvertierung. Sie können öffnen und konvertieren ofd-Dateien. Wie xps öffnen sie sich im Nur-Anzeigen-Modus.
• Konvertierung nach XLS. Sie können konvertieren jedes Tabellenformat in das klassische xls-Format. Dies ist nützlich, wenn Ihre Benutzer oder Partner weiterhin auf Altsysteme angewiesen sind.

Multipart-Endpunkte für den direkten Datei-Upload

Bis jetzt haben die Konvertierungs- und Document Builder-Dienste Quell-Dateien von einer URL heruntergeladen. Das bedeutete, dass Sie die Datei irgendwo hosten mussten, wo der Server sie erreichen konnte. Version 10.0 fügt zwei neue Endpunkte hinzu, die diesen Schritt entfernen:

• POST /converter/from-file
• POST /docbuilder/from-file

Beide akzeptieren Daten im multipart/form-data-Format. Sie können eine Datei oder ein Skript direkt in der Anfrage senden, sodass Sie es nicht über eine temporäre URL exponieren müssen.

Dies ist eine sauberere Option für viele Workflows. Beispielsweise kann ein Backend-Dienst Benutzer-Uploads in Echtzeit konvertieren oder ein Document Builder-Skript ausführen, ohne die Dateien zuerst zu bearbeiten.

Beispielanfrage: Konvertierung von TXT zu DOCX

curl -f -X POST "https://documentserver/converter/from-file" 
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Beispieltitel Dokument.txt"}' 
  -F 'file=@example.txt' 
  -o "Beispieltitel Dokument.docx"

Modernisierung der Plugin-API

Die Plugins- und Makros-API hat ihr größtes Update seit langem erhalten.

Ein neues globales Editor-Objekt

Methoden werden jetzt als reguläre Funktionen aufgerufen, die ein Versprechen zurückgeben. Anstatt jeden Aufruf über window.Asc.plugin.executeMethod zu leiten, können Sie sauberen, asynchronen Code schreiben:

const text = await Editor.GetSelectedText();

Das Ergebnis ist kürzerer, lesbarer Code, der sich natürlich in moderne JavaScript-Projekte einfügt.

Neue Methoden und Ereignisse

Version 10.0 fügt auch neue Werkzeuge zum Erstellen reichhaltiger Plugins hinzu:

• Methoden: Editor.RunMacro, GetRestrictions, SetButtonDisabled, GetOFormRole
• Ereignisse: onFloatActionButtonClick, onSelectionEnd, onSelectionCancel

Beispielsweise ermöglichen es die Auswahlereignisse Ihrem Plugin, in dem Moment zu reagieren, in dem ein Benutzer eine Auswahl abschließt oder abbricht.

Überprüfen Sie die vollständige Liste der Änderungen für die Plugins-API

Beginnen Sie mit dem Erstellen mit ONLYOFFICE 10.0

Version 10.0 bietet Ihnen sauberere APIs, mehr Automatisierungskraft und sicherere Standardeinstellungen. Hier ist ein schneller Plan, um das Beste daraus zu machen:

• Überprüfen Sie die Verhaltensänderungen. Überprüfen Sie die Token-Nutzung, die WOPI-IP-Filterregeln und den neuen Standardport.
• Aktualisieren Sie Ihre Plugins. Wechseln Sie zum globalen Editor-Objekt und ersetzen Sie alle umbenannten oder entfernten Methoden.
• Testen Sie die neuen Endpunkte. Testen Sie /converter/from-file und /docbuilder/from-file in Ihren Konvertierungs-Workflows.
• Entscheiden Sie sich für KI. Konfigurieren Sie editorConfig.customization.ai oder aiSettings.enable, um Ihren Produktbedürfnissen zu entsprechen.

HERUNTERLADEN

Arbeiten Sie mit der Cloud-Version von ONLYOFFICE Docs?  Probieren Sie Docs Connect für eine einfachere Möglichkeit, die Editoren mit externen Plattformen und Diensten zu verbinden. Im Gegensatz zur selbst gehosteten Version von ONLYOFFICE Docs, die erfordert, dass Sie die Editoren auf Ihren eigenen Servern bereitstellen und warten, kümmert sich Docs Connect um Hosting, Wartung und regelmäßige Updates für Sie.

Überprüfen Sie das vollständige Änderungsprotokoll für jedes Detail und teilen Sie Ihr Feedback im ONLYOFFICE Community-Forum. Wir können es kaum erwarten zu sehen, was Sie entwickeln!