API-Übersicht: Neueste Updates für ONLYOFFICE Docs

Wir haben eine Reihe von API-Updates für ONLYOFFICE Docs veröffentlicht, um Kompatibilität, Anpassung und Sicherheit zu verbessern. Ob Sie benutzerdefinierte Workflows erstellen, sichere Zusammenarbeit an Dokumenten ermöglichen oder erweiterte APIs integrieren – diese Verbesserungen bieten unbegrenzte Möglichkeiten. Hier finden Sie eine Übersicht der neuesten Ergänzungen und Verbesserungen.

Erweiterte Dateiformatunterstützung

Die Docs API unterstützt nun zusätzliche Dateiformate und bietet so eine breitere Kompatibilität, um Benutzern, die mit unterschiedlichen Dateitypen arbeiten, ein nahtloses Erlebnis zu gewährleisten. Dazu gehören die Formate Apple iWork und Hancom Office:

• pages
• key
• numbers
• hwp
• hwpx

Diese Formate können beispielsweise mit der Eigenschaft documentType angegeben werden:

const config = {
  documentType: "pages",

Erweiterte Anpassungsoptionen

Entwickler haben jetzt mehr Kontrolle über das Verhalten und Erscheinungsbild des Editors. Wichtige Neuerungen:

• Featuretipps ausblenden

Mit dem Parameter editorConfig.customization.features.featuresTips können Sie Tooltips zu den neuen Funktionen beim ersten Laden des Editors nach der Aktualisierung aktivieren oder deaktivieren. Der Standardwert ist true.

• Anzeige der Tabellen-Scrollbalken

Ab Version 8.3 können Sie festlegen, ob der horizontale/vertikale Scrollbalken beim Laden des Tabellenkalkulationseditors automatisch angezeigt oder ausgeblendet wird. Überprüfen Sie die Parameter editorConfig.customization.showHorizontalScroll und editorConfig.customization.showVerticalScroll, um diese Parameter zu steuern.

• Präsentations-Diashow-Hintergrund

Mit dem Parameter editorConfig.customization.slidePlayerBackground können Sie die Hintergrundfarbe der Diashow im HEX-, RGB- oder RGBA-Format definieren. Beispiel: #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).

showHorizontalScroll: true,
      showVerticalScroll: true,
      slidePlayerBackground: "#000000",

• Farben für Dokumentüberschriften

Passen Sie die Überschriftenstile im Dokumenteditor mit dem Parameter editorConfig.customization.wordHeadingsColor an und ermöglichen die Angabe von HEX-Farben.

• Mobile Info-Schaltfläche

Schalten Sie die Anzeige der Dokumentinfo-Schaltfläche für mobile Editoren über editorConfig.customization.mobile.info ein. Der Standardwert ist false.

• Zeigermodus

Passen Sie den Zeigermodus (Auswahl oder Hand) im Präsentations-Viewer mit dem Parameter editorConfig.customization.pointerMode an. Der Standardwert ist select.

• Kompakte Symbolleiste für den Viewer

Der Parameter editorConfig.customization.compactToolbar unterstützt jetzt den Viewer-Modus und ermöglicht den Wechsel zwischen der vollständigen und der kompakten Symbolleiste. Der Standardwert für den Viewer-Modus ist true.

Verbesserte Sicherheitsfunktionen

Die Docs API ermöglicht die Verarbeitung passwortgeschützter Dateien mit dem neuen Ereignis events.onUserActionRequired. Die Funktion wird aufgerufen, wenn zum Öffnen eines Dokuments eine Benutzeraktion erforderlich ist:

• wenn der Benutzer zum Öffnen des geschützten Dokuments ein Passwort eingeben muss;
• wenn der Benutzer eine Kodierung für die TXT-Datei auswählen muss;
• wenn der Benutzer eine Kodierung und ein Trennzeichen für die CSV-Datei auswählen muss.

Hier ist ein Beispiel für die Funktionsweise des Ereignisses:

function onUserActionRequired() {
  console.log("Enter a password")
};
const config = {
  events: {
    onUserActionRequired,
  },
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

Darüber hinaus können Sie jetzt den drop-Befehl verwenden, um die Dokumentbearbeitung für bestimmte Benutzer zu verbieten:

{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}

Das vollständige Änderungsprotokoll der Docs-API ist hier verfügbar.

Holen Sie sich die neueste Version von ONLYOFFICE Docs Developer:

JETZT HERUNTERLADEN

Neue Office-API-Methoden

Die Office API erhält wichtige Updates für ein besseres Dokumentenmanagement, darunter:

• Lesezeichen
• Inhaltssteuerelemente
• Abschnitte
• Autofilter
• Auswahl
• Und mehr

Diese Verbesserungen ermöglichen umfassendere Interaktionen und Bearbeitungsfunktionen. Eine detaillierte Aufschlüsselung der Befehle finden Sie im Änderungsprotokoll der Office-API.

Aktualisierungen der Plugin-API

Mehrere neue Methoden und Eigenschaften erweitern die Funktionen von Plugins:

• Inhaltsabruf

Die Methode GetSelectedContent ruft ausgewählte Inhalte in einem bestimmten Format ab.

expression.GetSelectedContent(prop);

• Fehlermeldungen

Mit der Methode ShowError können Plugins Fehler- oder Warnmeldungen anzeigen.

expression.ShowError(error, level);

• Verbesserte Eigenschaften der Inhaltssteuerung

Die neuen Eigenschaften Shd (Hintergrundschattierung) und Border verbessern das ContentControlProperties-Objekt und ermöglichen eine bessere visuelle Anpassung.

• Panel-Aktivierung

Mit dem Parameter isActivated können Sie festlegen, ob ein erstelltes Plugin-Panel beim Laden erweitert (true) oder reduziert (false) wird.

Hier finden Sie die vollständige Liste der Plugin-API-Updates.