ONLYOFFICE Docs 9.0 für Entwickler: API-Updates

1 Juli 2025Von Ksenija

Die neueste Version von ONLYOFFICE Docs ist da – vollgepackt mit Updates, die mehr Funktionalität, bessere Anpassungsmöglichkeiten und verbesserte Leistung bieten. Wenn Sie Entwickler oder Integrator sind und die erweiterten APIs nutzen möchten, gibt es in dieser Version viel zu entdecken. Alle Details finden Sie unten.

ONLYOFFICE Docs 9.0 for developers: API updates

Diagramm-Viewer

Der neu eingeführte Diagramm-Viewer ist für das Web, den Desktop und das mobile Web verfügbar. Er ermöglicht das Öffnen von Diagrammdateien ohne die Verwendung von Apps von Drittanbietern.

Wo in der API zu finden: Der diagram-Typ wird dem Parameter documentType hinzugefügt.

ONLYOFFICE Docs 9.0 for developers: API updates

Unterstützung neuer Dateiformate

ONLYOFFICE erweitert seine Benutzerfreundlichkeit kontinuierlich durch die Unterstützung weiterer Dateiformate. In Version 9.0 können Markdown- und OpenDocument-Grafikdateien zur Anzeige geöffnet werden.

Wo in der API zu finden: Öffnung für die Formate odg und md hinzugefügt.

Mit der Einführung des Diagramm-Viewers wurde außerdem die Konvertierung der Formate vsdm, vsdx, vssm, vssx, vstm und vstx hinzugefügt. API prüfen

ONLYOFFICE Docs 9.0 for developers: API updates

Erweiterte Anpassungsmöglichkeiten

Die Anpassungsmöglichkeiten wurden in Version 9.0 auf ein neues Niveau gehoben. Ihre Endnutzer können ihr ONLYOFFICE-Erlebnis ganz nach ihren Bedürfnissen gestalten.

Neue UI-Themen

Zwei neue Designs, Modern Hell und Modern Dunkel, optimieren das Erscheinungsbild jedes Editors.

Wo in der API zu finden: Die Design-IDs theme-white und theme-night werden dem Parameter ditorConfig.customization.uiTheme hinzugefügt.

const config = {
  editorConfig: {
    customization: {
...
      uiTheme: "theme-white",
...

ONLYOFFICE Docs 9.0 for developers: API updates

Schriftgrößenauswahl für die Benutzeroberfläche für vereinfachtes Chinesisch

Der neue Parameter gewährleistet eine präzise Schriftgröße in vereinfachten chinesischen Layouts und bietet die Flexibilität, sowohl westliche als auch traditionelle chinesische Stile zu verwenden.

Wo in der API zu finden: editorConfig.customization.forceWesternFontSize

const config = {
  editorConfig: {
    customization: {
....
 forceWesternFontSize: false,
...

Benutzeravatare ausblenden

Mit dem neuen Parameter können Sie Benutzeravatare in der Editor-Kopfzeile ein- und ausblenden und so eine übersichtliche, ablenkungsfreie Benutzeroberfläche schaffen.

Wo in der API zu finden: editorConfig.customization.layout.header.user

const config = {
  editorConfig: {
    customization: {
...
layout: {
        header: {
          editMode: true,
          save: true,
          user: true,
          users: true,
        },

Leistungssteigerung durch Vorladen

Ab Version 9.0 können Sie statische Assets (HTML, CSS, JS, Schriftarten) vor dem Öffnen einer Datei in den Browser-Cache laden, um den ersten Ladevorgang des Dokumenteditors zu beschleunigen. API prüfen

Zwei Optionen stehen zur Verfügung:

1) Verwenden des Parameters ?preload=placeholder

<div id="placeholder"></div>

<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js?preload=placeholder"></script>

2) Manuelles Einfügen eines Preload-Iframes

<iframe src="https://documentserver/web-apps/apps/api/documents/preload.html" style="display:none;"></iframe>

Erhalten Sie die neueste Version von ONLYOFFICE Docs Developer:

JETZT HERUNTERLADEN

API-Erweiterungen für Plugins und Makros

Benutzerdefinierte Schaltflächen für Inhaltssteuerelemente. Verwenden Sie die Klasse Asc.ButtonContentControl, um einzigartige Schaltflächen für Ihre Plug-Ins zu erstellen. Definieren Sie Aktionen mit der Methode attachOnClick und fügen Sie Ihre eigenen Symbole hinzu, um die Funktionalität zu verbessern. API prüfen

(function(window){
  window.Asc.plugin.init = function()
  {
    let button = new Asc.ButtonContentControl();
    button.icons = '/resources/check%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControl", [contentControlId]);
    });
 
    button = new Asc.ButtonContentControl();
    button.icons = '/resources/close%scale%(default).png';
    button.attachOnClick(function(contentControlId){
      Asc.plugin.executeMethod("RemoveContentControls", [[{"InternalId": contentControlId}]]);
    });
  }
})(window);

Festlegen der aktiven Folie anhand ihres Index. Mit der neuen GoToSlide method können Sie innerhalb von Präsentationen ganz einfach zu jeder Folie springen.

expression.GoToSlide(slideNumber);

Inhaltssteuerelement-Listenelement. Die Einführung der ContentControlListElement-Enumeration vereinfacht die Verwaltung von Inhaltssteuerelementen in Dokumenten noch weiter.

Asynchrone Berechnungen. Verwalten Sie alle Anfragen im Hauptteil einer benutzerdefinierten Funktion, die mit Makros erstellt wurde.

(function () {
  /**
   * World Bank indicator value for a specific year.
   * @customfunction

   * @param   {string} country   ISO-3 code, e.g. "TUR"
   * @param   {string} indicator Indicator code, e.g. "SP.POP.TOTL"
   * @param   {number} year      Four-digit year, e.g. 2024
   * @returns {any}             Numeric value or #N/A
   *
   * @example =WB("TUR","SP.POP.TOTL",2024)
   */
  async function WB(country, indicator, year) {
    // Build URL (World Bank allows CORS)
    const url =
      `https://api.worldbank.org/v2/country/${country}/indicator/${indicator}` +
      `?format=json&per_page=20000`;

    try {
      const r = await fetch(url);
      const [meta, data] = await r.json();

      // Find the row for the requested year
      const row = data.find((v) => v.date === year.toString());
      if (!row || row.value == null) return "#N/A";

      return row.value;               // resolves the Promise
    } catch (e) {
      return "#ERROR";
    }
  }

  // Register the function so it becomes a sheet formula
  Api.AddCustomFunction(WB);
})();

Neue Beispiele

Mit dem neuesten Update der API-Dokumentation haben wir noch mehr einsatzbereite Beispiele für den Document Builder und Makros hinzugefügt, um Ihren Entwicklungsprozess reibungsloser und effizienter zu gestalten.