Ein eingebetteter Editor macht Dokumente innerhalb einer Anwendung bearbeitbar. Wie gut daraus ein durchgängiger Workflow wird, entscheidet sich auch an den Schnittstellen dahinter. ONLYOFFICE Docs 10.0 setzt an diesen Übergängen an.
Ein Kunde lädt ein Dokument in ein Fachportal hoch, bearbeitet es gemeinsam mit seinem Ansprechpartner und gibt es zur weiteren Verarbeitung frei. Beide arbeiten durchgehend innerhalb derselben Anwendung.
Das Entwicklungsteam muss dafür die Übergänge organisieren. Der Editor benötigt Zugriff auf die Datei, Änderungen müssen zurück ins führende System gelangen. Für nachgelagerte Prozesse kann eine Konvertierung erforderlich sein. Wie viel Infrastruktur und eigenen Code diese Abläufe brauchen, bestimmt den Integrationsaufwand mit.
ONLYOFFICE Docs 10.0 bringt dafür Neuerungen, die sich an konkreten Aufgaben im Entwicklungsalltag zeigen.
Dateien ohne Umweg verarbeiten
Bisher luden der Konvertierungsdienst und der Document Builder ihre Eingaben über eine URL herunter. Die integrierende Anwendung musste die Datei zunächst für den Dokumentenserver erreichbar bereitstellen. Dazu gehörten die Zugriffskontrolle und gegebenenfalls das anschließende Entfernen temporärer Dateien.
Version 10.0 ergänzt die Endpunkte POST /converter/from-file und POST /docbuilder/from-file. Beide akzeptieren multipart/form-data: Dateien beziehungsweise Skripte lassen sich direkt im Request übergeben. Die Bereitstellung über eine temporäre URL entfällt für diese Aufrufe.
Ein Backend kann einen Nutzer-Upload damit unmittelbar zur Konvertierung übergeben. Das spart einen eigenen Bereitstellungsschritt und verkürzt den Weg zur Verarbeitung.
Auch bei PDFs erweitert sich der Spielraum: Der Document Builder kann sie jetzt bearbeiten. Reguläre PDFs werden über OpenFile im PDF-Editor mit Zugriff auf die PDF API geöffnet. In ONLYOFFICE erstellte PDF-Formulare öffnen sich im Dokumenteneditor. Über CreateFile mit dem Typ pdf lassen sich PDF-Formulare erzeugen. Damit können Entwickler weitere PDF-Prozesse innerhalb derselben Werkzeugumgebung automatisieren.
Eigene Funktionen im Editor verankern
Ein Fachportal benötigt möglicherweise Aktionen, die sich auf markierten Text beziehen. Über Plugins lassen sich solche Funktionen direkt im Editor bereitstellen und mit dem Workflow der Anwendung verbinden.
ONLYOFFICE 10.0 modernisiert dafür die Plugin API. Das neue globale Objekt Editor stellt Methoden als Funktionen bereit, die ein Promise zurückgeben. Statt Aufrufe über window.Asc.plugin.executeMethod zu führen, können Entwickler beispielsweise const text = await Editor.GetSelectedText(); verwenden. Das erleichtert die Einbindung in asynchrone JavaScript-Abläufe.
Die neuen Events onSelectionEnd und onSelectionCancel melden, wenn Nutzer eine Auswahl abschließen oder abbrechen. Eigene Aktionen können dadurch gezielt an diese Interaktionen anknüpfen.
Eine umfassende Übersicht aller Funktionen finden Entwickler in der offiziellen API-Dokumentation von ONLYOFFICE.
KI entsprechend den Produktvorgaben steuern
Zur Integration gehört auch die Entscheidung, welche Funktionen verfügbar sein sollen. Ein Anbieter kann KI-Werkzeuge für bestimmte Installationen vorsehen und sie in anderen deaktivieren wollen.
Version 10.0 ermöglicht beides: Über disabled in editorConfig.customization.ai lassen sich KI-Funktionen für einzelne Editorinstanzen ausblenden. Serverweit können sie über aiSettings.enable abgeschaltet werden.
In den kommerziellen Editionen können Administratoren zudem KI-Anbieter zentral konfigurieren und Modelle bestimmten Aufgaben zuweisen. Nach dem Speichern dieser Konfiguration sind Nutzer an die freigegebenen Anbieter und Modelle gebunden. Eigene API-Schlüssel oder Änderungen an der Modellauswahl sind dann ausgeschlossen. So lässt sich die Bereitstellung an die Vorgaben der jeweiligen Umgebung anpassen.
Das Upgrade gezielt vorbereiten
Bestehende Integrationen müssen einige Verhaltensänderungen berücksichtigen. Die Service-Endpunkte /converter, /docbuilder und /command akzeptieren keine Tokens aus der Editorkonfiguration mehr. Für die neuen Upload-Endpunkte ist das Feld operation im Token verpflichtend.
WOPI-Hosts müssen ausdrücklich durch IP-Filterregeln zugelassen sein; eine Wildcard-Freigabe reicht nicht mehr aus. Bei DEB- und RPM-Installationen wechselt der Standardport auf 8083. Vor dem Umstieg sollten deshalb auch Proxy- und Firewallregeln geprüft werden.
Wer Dokumentbearbeitung direkt in die eigene Anwendung integrieren möchte, findet in ONLYOFFICE Docs 10.0 eine erweiterbare Grundlage für individuelle Workflows. Die neuen Schnittstellen erleichtern den Einstieg und eröffnen zusätzliche Möglichkeiten für die Automatisierung. Laden Sie die Developer Builds herunter und testen Sie, wie ONLYOFFICE Ihr nächstes Projekt unterstützen kann.
kommentar field