ONLYOFFICE Docs 7.2 für Entwickler: API-Updates
Zusammen mit neuen Funktionen in Version 7.2 haben wir auch die API für die Editoren und Plugins aktualisiert. Alle Details finden Sie unten.
Live-Viewer und neue Lizenzparameter
Mit dem Live-Viewer können Benutzer die von anderen Mitarbeitern vorgenommenen Änderungen in Echtzeit sehen, wenn sie ein Dokument, eine Tabellenkalkulation oder eine Präsentation im schreibgeschützten Modus öffnen. Mehr erfahren
Um diese Funktion zu verwenden, müssen Sie eine neue Lizenz erwerben, die separate Felder für Live-Viewer enthält: connections_view und users_view_count für die Anzahl der Verbindungen und Benutzer sowie users_view für die Benutzerquote. In der Lizenzantwort finden Sie weitere Informationen.
Bitte beachten Sie, dass die Serververbindungen für den Live-Viewer unabhängig von der Gesamtzahl der gleichzeitigen Verbindungen* berechnet werden.
*Anzahl der Browser-Tabs mit Dokumenten, die gleichzeitig zur Bearbeitung geöffnet werden können.
Arbeit mit Dokumenten von außen
Eine neue API-Klasse ermöglicht die Interaktion mit Textdokumenten, Tabellenkalkulationen, Präsentationen und ausfüllbaren Formularen von außen. So können Sie einen speziellen Konnektor erstellen, um Änderungen an den Dokumenten mit Ihren eigenen Schaltflächen/Methoden anstelle der Editor-Schaltflächen vorzunehmen. So können Sie z. B. einen Feed mit Kommentaren aus allen Ihren Dokumenten erzeugen, auf sie antworten und Kommentare an einer Stelle schließen oder Formulare automatisch mit den aus Datenbanken exportierten Daten ausfüllen.
Hinweis: Die Klasse Connector API ist in der erweiterten API enthalten und derzeit nur als Demo verfügbar (sie wird mit der nächsten Version 7.2.1 in die API-Dokumentation aufgenommen). Wenn Sie diese jetzt testen möchten, kontaktieren Sie bitte unser Vertriebsteam unter sales@onlyoffice.com.
API-Erweiterungen für Plugins
Plugin-Marketplace. Mit dem neuen Plugin-Manager können Benutzer alle verfügbaren Plugins erkunden und jedes Plugin mit nur einem Klick direkt in den Editoren installieren oder entfernen. Wir haben die Anweisungen in der API-Dokumentation zum Erstellen und Hinzufügen von Plugins aktualisiert. Sie können auch diesen Beitrag lesen.
Aktualisiertes Lokalisierungsschema. Jetzt können Sie eine langs.json-Datei in den Ordner mit den Übersetzungen einfügen. Mehr erfahren
Die neue Datei enthält die Namen der Dateien mit Übersetzungen für eine bestimmte Sprache und besteht aus einem Array des folgenden Typs:
[
"cs-CZ",
"de-DE",
"es-ES",
"fr-FR",
"ru-RU"
]Neue Methoden: ChangeOleObject, GetAllForms, GetFileToDownload, GetFormsByTag, GetFormValue, GetImageDataFromSelection, GetInstalledPlugins, InstallPlugin, PutImageDataToSelection, RemovePlugin, SetFormValue, ShowButton, UpdatePlugin, usw.
Das vollständige API-Änderungsprotokoll für Plugins
JWT standardmäßig aktiviert
Ab Version 7.2 wird automatisch ein zufälliges JWT-Geheimnis generiert, das auf der Seite der Host-Anwendung nur noch hinzugefügt werden muss. Sie können das standardmäßige JWT-Geheimnis abrufen und es bei Bedarf durch einen benutzerdefinierten Schlüssel ersetzen. Mehr erfahren
Andere API-Updates
Dunkler Kontrast. Aktivieren Sie im Parameter editorConfig.customization.uiTheme eine neue Variante des dunklen Themas. Es hat noch dunklere Schattierungen, die Arbeitsfläche ist fast schwarz.
"customization": { ......
"uiTheme": "theme-contrast-dark",
}, .......Anpassen des Abschnitts Informationen. Sie können jetzt Ihre geschäftliche Telefonnummer zusammen mit Ihrem Logo, Ihrer E-Mail-Adresse usw. in den Abschnitt „Informationen“ in den Editoren einfügen. Konfigurieren Sie dazu den Parameter editorConfig.customization.customer.
"editorConfig": {
"customization": { ........
"customer": {
"address": "My City, 123a-45",
.....
"phone": "37188888888"
},Sprachcodes mit vier Buchstaben. Der Parameter editorConfig.lang, der die Sprache der Editoroberfläche einstellt, unterstützt 4-stellige Codes. Um zum Beispiel Portugiesisch festzulegen, geben Sie pt-pt an. Bei pt-br handelt es sich um brasilianisches Portugiesisch.
"editorConfig": {
.....
"lang": "pt-pt",Das gleiche gilt für die Sprachcodes zh-cn (vereinfachtes Chinesisch) und zh-tw (traditionelles Chinesisch).
Neue Aktion in WOPI Discovery. Die Aktion embedview in WOPI Discovery rendert eine nicht editierbare Ansicht eines Dokuments, die für die Einbettung in eine Webseite optimiert ist:
<action name="embedview" ext="docx"...Sie funktioniert in unserer SharePoint-WOPI Integration durch Ersetzen der URL gemäß dieser Anleitung und ist für alle unabhängigen WOPI-Integratoren relevant.
Aktualisierte Preisgestaltung
Die neue Preisgestaltung ermöglicht die Konfiguration weiterer Parameter wie Mandantenfähigkeit und Multi-Server, Zugriff auf erweiterte API, Live-Viewer usw. Mehr erfahren
