Werko Office Entwickler Einstieg ManifestAPISicherheit EN
Werko Office Add-ins

Eigene Add-ins für Werko Text und Werko Calc.

Ein Add-in ist eine kleine Webseite im Seitenbereich neben dem Dokument. Mit HTML, JavaScript und einem kurzen Manifest liest und ändert es Dokumente und Tabellen, spricht mit Ihrem Dienst und nutzt die eigene KI des Nutzers – mit Rechten, denen der Nutzer zustimmt.

Beispiel-Add-in herunterladenAnleitung lesen

In drei Schritten zum Add-in

Läuft in Werko Office ab Version 0.6.11 unter Windows, Mac und Linux.

1

Manifest schreiben

werko-addin.json nennt Name, Programme, Panel-Seite und die benötigten Rechte.

2

Panel bauen

Eine normale HTML-Seite. Über window.werko lesen Sie die Markierung, schreiben Text oder füllen Zellen.

3

Verpacken oder hosten

Als Datei .werkoaddin weitergeben (läuft offline) oder das Manifest auf Ihrem https-Server bereitstellen (Sie aktualisieren selbst).

Zum Testen installieren: in Werko Text oder Werko Calc auf Add-ins → Add-in installieren … klicken und Datei oder Adresse wählen.

Das Manifest

Vor der Installation zeigt Werko Office dem Nutzer, wer das Add-in gemacht hat, woher es kommt, was es darf und welche Server es erreicht.

// werko-addin.json
{
  "id": "firma.uebersetzer",
  "name": "Übersetzer",
  "version": "1.2.0",
  "autor": "Firma GmbH",
  "beschreibung": "Übersetzt die Markierung.",
  "symbol": "symbol.svg",
  "programme": ["text", "calc"],
  "panel": "panel.html",
  "rechte": ["dokument.lesen", "dokument.schreiben", "ki"],
  "domains": ["api.firma.example"]
}
FeldBedeutung
ideindeutig, z. B. firma.produkt (a–z, 0–9, Punkt, Bindestrich)
programmetext = Werko Text, calc = Werko Calc
panelDatei im Paket oder https://-Adresse; bei Installation von einer Adresse relativ zum Manifest
rechtedokument.lesen, dokument.schreiben, ki
domainsweitere Server, die das Panel erreichen darf, z. B. *.firma.example
symbolSymbol im Paket oder https://-Adresse (optional)

Die API: window.werko

Jeder Aufruf liefert ein Promise. Fehlt ein Recht oder gehört die Funktion zum anderen Programm, wird es mit einer verständlichen Meldung abgelehnt.

// Allgemein
await werko.info();                 // { programm: 'text'|'calc', version, sprache, addin }
await werko.ui.meldung('Fertig!');
werko.ereignis('auswahl', (a) => console.log(a));   // Markierung geändert

// Werko Text
await werko.text.auswahl();          // { text, html, leer }          dokument.lesen
await werko.text.dokument();         // { text, html }                dokument.lesen
await werko.text.auswahlErsetzen('Neuer Text');   // dokument.schreiben
await werko.text.einfuegen('<b>Hallo</b>');     // an der Cursorposition

// Werko Calc
await werko.calc.auswahl();          // { adresse: 'B2:C4', blatt, werte }
await werko.calc.bereich('A1:C10');  // { adresse, blatt, werte, formeln }
await werko.calc.bereichSetzen('A1', [['Monat', 'Umsatz'], ['Jänner', 1200], ['Summe', '=SUM(B2:B2)']]);
await werko.calc.blaetter();         // { blaetter: [...], aktiv }

// KI des Nutzers (sein Anbieter und Schlüssel – Ihr Add-in sieht den Schlüssel nie)   ki
await werko.ki.fragen('Fasse zusammen: …', { system: 'Antworte auf Deutsch.' });

Sicher gebaut

Abgeschottet

Jedes Add-in läuft in einer eigenen, abgeschotteten Ansicht mit eigenem Speicher – ohne Node.js, ohne Dateizugriff.

Bei jedem Aufruf geprüft

Werko Office prüft jeden window.werko-Aufruf gegen die Rechte im Manifest.

Nur angegebene Server

Netzwerk nur zur Herkunft der Panel-Seite und zu den angegebenen Domains. Alles andere wird blockiert.

Der Nutzer entscheidet

Vor der Installation sieht der Nutzer Hersteller, Herkunft, Rechte und Server – und kann Add-ins jederzeit ausschalten oder entfernen.

Downloads

hallo-werko.werkoaddinBeispiel-Add-in: Großbuchstaben, Datum einfügen, KI-Zusammenfassung, Summe in Calc, Tabelle schreiben
hallo-werko-quelltext.zipQuelltext des Beispiels (Manifest, panel.html, Symbol)
addin-paket.mjsPackt einen Ordner zu .werkoaddin: node addin-paket.mjs mein-addin/

Fragen

Laufen Add-ins für Microsoft Office in Werko Office?

Nicht direkt. Office-Add-ins nutzen Microsofts Office.js-Schnittstelle und meist ein Microsoft-Konto. Das Prinzip ist aber gleich – eine Webseite im Seitenbereich –, daher lässt sich ein einfaches Office-Add-in meist mit wenigen Änderungen umstellen (z. B. Word.run → werko.text, Excel.run → werko.calc).

Wie kommen Nutzer an mein Add-in?

Geben Sie ihnen die Datei .werkoaddin oder die Adresse Ihres Manifests. Ein Add-in-Katalog auf werkooffice.com ist geplant – erzählen Sie uns von Ihrem Add-in unter office@werko.app.

Kostet das etwas?

Nein. Entwickeln und Weitergeben ist kostenlos. Ob Ihr eigener Dienst hinter dem Add-in etwas kostet, entscheiden Sie.

Welche Programme werden unterstützt?

Heute Werko Text und Werko Calc. Werko PDF, Werko Show und Werko Mail folgen.