Makros oder KI-Funktionen? ONLYOFFICE-Tools verstehen

4 Februar 2026Von Ksenija

ONLYOFFICE bietet Ihnen leistungsstarke Möglichkeiten, Ihre Dokumentenbearbeitung mithilfe von Makros und KI-Funktionen zu automatisieren – so sparen Sie Zeit, reduzieren den manuellen Aufwand und arbeiten effizienter.

Beide Tools helfen Ihnen, schneller und intelligenter zu arbeiten, funktionieren aber unterschiedlich und eignen sich für verschiedene Bedürfnisse. Ob Sie als Entwickler individuelle Lösungen erstellen oder einfach nur effizienter arbeiten möchten: Dieser Leitfaden hilft Ihnen, das passende Tool für Ihre Anforderungen zu finden.

Macros or AI Functions? Understanding ONLYOFFICE Tools

Grundlagen verstehen

Was sind ONLYOFFICE-Makros?

ONLYOFFICE-Makros sind kleine Skripte, die wiederkehrende Aufgaben in Dokumenten, Tabellen und Präsentationen automatisieren. Sie nutzen JavaScript und die Office-API und ermöglichen es Ihnen, Inhalte zu formatieren, Daten zu aktualisieren und benutzerdefinierte Arbeitsabläufe direkt im Editor zu erstellen.

So verwenden Sie Makros:

Öffnen Sie die Registerkarte „Ansicht“ und klicken Sie auf „Makros“.
Schreiben Sie JavaScript-Code mithilfe der Office-API.
Klicken Sie auf „Ausführen“, um das Makro auszuführen.
Das Skript bearbeitet das Dokument direkt.

Hinweis: Seit Version 7.1 werden Makros im strikten Modus ausgeführt. Das bedeutet, dass Sie alle Variablen vor ihrer Verwendung mit „let“ oder „const“ deklarieren müssen. Die Funktionen „window“, „document“ oder „alert“ können nicht verwendet werden.

Beispiel: Tabellenzeilen farbig markieren

(function () {
  let worksheet = Api.GetActiveSheet();
  for (let i = 1; i < 200; i += 2) {
    let rowOdd = i,
      rowEven = i + 1;
    worksheet.GetRange(
      "A" + rowOdd + ":S" + rowOdd).SetFillColor(Api.CreateColorFromRGB(138, 181, 155)
      );
    worksheet.GetRange(
      "A" + rowEven + ":S" + rowEven).SetFillColor(Api.CreateColorFromRGB(216, 227, 220)
      );
  }
})();

Dieses Makro färbt 200 Zeilen abwechselnd in weniger als einer Sekunde ein – eine Aufgabe, die manuell einige Zeit in Anspruch nehmen würde.

Was sind ONLYOFFICE KI-Funktionen?

KI-Funktionen verbinden ONLYOFFICE mit KI-Modellen wie ChatGPT. Sie ermöglichen die Ausführung KI-gesteuerter Dokumentaktionen mithilfe von Eingabeaufforderungen, sodass der Editor basierend auf Ihren Anfragen automatisierte Vorgänge durchführen kann. KI-Funktionen sind Teil des KI-Plugins (derzeit in der Beta-Phase), das in Version 2.4.2 eingeführt wurde.

Einrichtung

Klonen Sie das Repository onlyoffice.github.io auf Ihren lokalen Rechner.
Schreiben Sie Ihre KI-Funktion im Ordner „helpers“ (sdkjs-plugins/content/ai/.dev/helpers).
Je nach Editortyp platzieren Sie sie im Zellen-, Folien- oder Wortordner: cell, slide, word.
Aktualisieren Sie die aktuelle Version des KI-Plugins in der Datei config.js, um Caching-Probleme zu vermeiden
(z. B., 3.0.3 → 3.0.4).
Führen Sie die Datei helpers.py aus.
Markieren Sie alle Plugin-Dateien im Ordner ai (sdkjs-plugins/content/ai), komprimieren Sie sie und benennen Sie das Archiv in ai.plugin um.
Verschieben Sie die Datei zurück in den Ordner sdkjs-plugins/content/ai/deploy.
Übertragen Sie die Änderungen.
Erstellen Sie Ihre GitHub Pages-Website aus diesem Repository.
Erstellen Sie einen Link zu Ihrem benutzerdefinierten Shop, indem Sie /store/index.html an Ihre GitHub Pages-URL anhängen:
https://YOUR-USERNAME.github.io/onlyoffice.github.io/store/index.html
Gehen Sie zu Plugins → Plugin-Manager.
Klicken Sie im Plugin-Manager oben rechts auf das Store-Symbol (</>) und geben Sie die URL Ihres benutzerdefinierten Shops ein.
Aktualisieren Sie das KI-Plugin.

Hinweis: Ausführlichere Anweisungen finden Sie in diesem Artikel.

So verwenden Sie KI-Funktionen

Konfigurieren Sie bei Bedarf Ihren KI-Anbieter und API-Schlüssel.
Drücken Sie Strg + /, um den KI-Chat zu öffnen.
Geben Sie Ihren Text ein (z. B. „Diesen Text erklären“).
Die KI wählt die passende Funktion aus und führt die Verarbeitung durch.
Das Ergebnis wird in Ihrem Dokument angezeigt.

KI-Funktionen speichern Ihre Konversation. Sie können Nachfragen stellen oder die Ergebnisse verfeinern. Drücken Sie Strg + Alt + /, um von vorne zu beginnen.

Beispiel: KI-Kommentare hinzufügen

Die Funktion „commentText “ fügt dem markierten Text intelligente Kommentare hinzu:

Markieren Sie einen Text in Ihrem Dokument.
Drücken Sie Strg + /, um den KI-Chat zu öffnen.
Geben Sie ein: „Erklären Sie diesen Text“.
Drücken Sie die Eingabetaste.

Die KI liest Ihren Text, generiert eine Erklärung und fügt diese als Kommentar in Ihr Dokument ein.

So funktioniert es im Hintergrund:

// Simplified structure of an AI Function
func.call = async function (params) {
  // 1. Get the selected text
  let text = await Asc.Editor.callCommand(function () {
    let doc = Api.GetDocument();
    let range = doc.GetRangeBySelect();
    return range ? range.GetText() : "";
  });
  // 2. Ask the AI model
  let requestEngine = AI.Request.create(AI.ActionType.Chat);
  let argPrompt = params.prompt + ":\n" + text;
  // 3. Add the AI's answer as a comment
  await requestEngine.chatRequest(argPrompt, false, async function (data) {
    await Asc.Editor.callCommand(function () {
      let doc = Api.GetDocument();
      let range = doc.GetRangeBySelect();
      range.AddComment(data, model, "uid" + model);
    });
  });
};

Den vollständigen Code der Funktion commentText finden Sie hier.

Warum KI-Funktionen flexibler sind

KI-Funktionen rufen CallCommand separat auf (siehe Codezeilen oben). Dadurch können Sie benutzerdefinierte Logik vor und nach Dokumentoperationen ausführen. Das macht sie ideal für die KI-Integration: Sie können Anfragen an das KI-Modell senden, die Antwort verarbeiten und anschließend das Dokument aktualisieren. Die Makro-App kapselt alles in CallCommand, was zwar einfacher, aber weniger flexibel ist.

Hauptunterschiede

Makros dienen der direkten, Offline-Dokumentenbearbeitung. KI-Funktionen dienen der Integration von KI-Modellen in ONLYOFFICE.

Hier ein Vergleich:

Aspekt	Makros	KI-Funktionen
Einrichtung	Einfach – bereits integriert	Komplexer – Einrichtung des KI-Anbieters + benutzerdefinierte Funktionen
Kosten	Kostenlos	Kostenpflichtig (Gebühren des KI-Anbieters)
Internet	Funktioniert offline	Erfordert eine Verbindung zu einem KI-Dienst
Voraussetzungen	JavaScript + Office API	JavaScript + Office API + KI-Agentenmodifikationen
Lernkurve	Steil für Nicht-Programmierer	Steil für Nicht-Programmierer
Ergebniskonsistenz	Immer das gleiche Ergebnis	Kann variieren
Flexibilität	Eingeschränkt – eingebettet in `CallCommand`	Mehr Flexibilität – `CallCommand` separat aufrufen
Leistung	Schnell – direkte Ausführung	Variabel – abhängig von der KI-Reaktionszeit
Versionsunterstützung	Verfügbar seit frühen Versionen	Beta (seit Version 2.4.2)
Ideal für	Entwickler, präzise Steuerung, Offline-Automatisierung	KI-gestützte Aufgaben, Dokumentenbearbeitung und Verarbeitung
Datenschutz	Nur lokale Ausführung	Die Daten werden an einen externen KI-Dienst gesendet

Wann welches Werkzeug verwenden?

Makros

Verwenden Sie Makros, wenn Sie Dokumente direkt bearbeiten müssen:

Offline-Arbeit – keine Internetverbindung erforderlich.
Kostenlos – automatisieren Sie beliebig viel kostenlos.
Direkte Dokumentbearbeitung – Formatierung, Datenbearbeitung, Berechnungen.
Exakte Ergebnisse – gleiche Eingabe führt immer zum gleichen Ergebnis.
Schnelles Prototyping – Code schreiben und direkt im Editor testen.
Produktionsarbeit – Finanzberichte, Compliance-Dokumente, automatisierte Workflows.

KI-Funktionen

Wählen Sie KI-Funktionen, wenn Ihre Automatisierung KI-Fähigkeiten benötigt:

KI-Modellintegration – Verbinden Sie sich mit KI-Diensten und nutzen Sie deren Ergebnisse.
Dokumentautomatisierung – Wenden Sie KI-Ergebnisse direkt auf das Dokument an.
Kontextverarbeitung – Verarbeiten Sie Inhalte unter Berücksichtigung der Auswahl oder der Dokumentstruktur.
Erweiterte Logik – Benötigen Sie Flexibilität, um benutzerdefinierten Code vor/nach Dokumentoperationen auszuführen?

Fazit

ONLYOFFICE-Makros und KI-Funktionen dienen unterschiedlichen Zwecken. Der Hauptunterschied ist einfach:

Makros dienen der direkten Dokumentenbearbeitung. Sie sind kostenlos, funktionieren offline und eignen sich perfekt für jede Automatisierung, die keine KI benötigt. Verwenden Sie sie für Formatierung, Berechnungen, Datenmanipulation und benutzerdefinierte Formeln.

KI-Funktionen dienen der Integration von KI-Modellen in ONLYOFFICE. Ihre Entwicklung ist komplexer als die von Makros, sie erfordern Internet und Kosten für KI-Anbieter, sind aber die richtige Wahl, wenn Sie KI-Funktionen benötigen. Nutzen Sie sie für die Inhaltsgenerierung, die Dokumentenverarbeitung und die Automatisierung von Dokumentaufgaben mithilfe von KI.

ONLYOFFICE verbessert beide Tools kontinuierlich. Makros erhalten neue Funktionen wie asynchrone Funktionen. KI-Funktionen verlassen die Beta-Phase und bieten eine höhere Zuverlässigkeit und mehr Funktionen. Wenn Sie beide verstehen, können Sie das volle Potenzial der ONLYOFFICE-Automatisierung ausschöpfen.