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.
Läuft in Werko Office ab Version 0.6.11 unter Windows, Mac und Linux.
werko-addin.json nennt Name, Programme, Panel-Seite und die benötigten Rechte.
Eine normale HTML-Seite. Über window.werko lesen Sie die Markierung, schreiben Text oder füllen Zellen.
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.
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"] }
| Feld | Bedeutung |
|---|---|
id | eindeutig, z. B. firma.produkt (a–z, 0–9, Punkt, Bindestrich) |
programme | text = Werko Text, calc = Werko Calc |
panel | Datei im Paket oder https://-Adresse; bei Installation von einer Adresse relativ zum Manifest |
rechte | dokument.lesen, dokument.schreiben, ki |
domains | weitere Server, die das Panel erreichen darf, z. B. *.firma.example |
symbol | Symbol im Paket oder https://-Adresse (optional) |
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.' });
Jedes Add-in läuft in einer eigenen, abgeschotteten Ansicht mit eigenem Speicher – ohne Node.js, ohne Dateizugriff.
Werko Office prüft jeden window.werko-Aufruf gegen die Rechte im Manifest.
Netzwerk nur zur Herkunft der Panel-Seite und zu den angegebenen Domains. Alles andere wird blockiert.
Vor der Installation sieht der Nutzer Hersteller, Herkunft, Rechte und Server – und kann Add-ins jederzeit ausschalten oder entfernen.
node addin-paket.mjs mein-addin/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).
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.
Nein. Entwickeln und Weitergeben ist kostenlos. Ob Ihr eigener Dienst hinter dem Add-in etwas kostet, entscheiden Sie.
Heute Werko Text und Werko Calc. Werko PDF, Werko Show und Werko Mail folgen.