Anleitung · WAWITranslator

WAWITranslator V2 installieren

Schritt für Schritt zur Erstinstallation auf einem Windows-System, auf dem die JTL-Wawi bereits läuft.

Stand:

🔐 Schritt 1 – DeepL-Konto erstellen

  1. Öffne deepl.com/de/pro#developer.
  2. Klicke auf „Jetzt registrieren“ bzw. „DeepL API Free / Pro abonnieren“ (je nach gewünschtem Tarif).
    • Für gelegentliche Nutzung / wenig Artikeldaten reicht meist DeepL API Free.
    • Für gewerbliche Nutzung mit größerem Volumen empfehlen wir DeepL API Pro.
  3. Konto mit E-Mail und Passwort anlegen und die Registrierung abschließen (E-Mail ggf. bestätigen).

⚠️ Wichtig (DeepL API Pro): Nutze die Kostenkontrolle in deinem DeepL-Konto. Für entstehende DeepL-Kosten übernehmen wir keine Haftung.

🗝️ Schritt 2 – DeepL-API-Key abrufen

  1. Melde dich an und öffne deinen Konto-Bereich: deepl.com/de/account/summary.
  2. Im Bereich „Authentifizierung“ findest du unter „Ihr API-Schlüssel“ den persönlichen API-Key.

ℹ️ Info: Nach Buchung einer DeepL API Pro-Subskription kann es ~1 Werktag dauern, bis DeepL die Zahlung validiert und das Konto freischaltet.

📥 Schritt 3 – Lizenz und Installer holen

Den Installer bekommst du zusammen mit deinem Lizenzschlüssel. Für die Installation selbst ist der Schlüssel aber nicht mehr zwingend – du kannst auch ohne Schlüssel installieren und ihn später in den Einstellungen eintragen:

💡 Auto-Update: Nach der Erstinstallation musst du den Installer nicht jedes Mal manuell herunterladen. WAWITranslator prüft selbst, ob eine neuere Version verfügbar ist, und zeigt dann oben einen Hinweis „Update verfügbar – Jetzt aktualisieren“. Ein Klick lädt die neue Version herunter und startet die Aktualisierung.

⚙️ Schritt 4 – Voraussetzungen prüfen

Voraussetzung Details
Berechtigung Die Installation muss mit einem Windows-Administrator-Konto durchgeführt werden, um spätere Berechtigungsprobleme zu vermeiden.
JTL-Worker als Dienst Soll der WAWITranslator über zeitversetzte Workflows laufen, installiere ihn unter demselben Benutzer, unter dem auch der JTL-Worker als Dienst läuft.
Erforderliche Daten DeepL-API-Key · SQL-Server bzw. Instanzname (ggf. mit Port) · Datenbankname (Standard eazybusiness) · SQL-Zugangsdaten (Windows-Auth oder SQL-Benutzer/Passwort). Der Lizenz- bzw. Testschlüssel (siehe Schritt 3) ist optional und lässt sich auch nachträglich in den Einstellungen eintragen.
Datenbank Die Wawi-Datenbank braucht mindestens den Kompatibilitätsgrad 130 (entspricht SQL Server 2016). Liegt er darunter, bricht das Setup mit einem Hinweis ab, ohne etwas an der Datenbank zu ändern. Den Wert findest du im SQL Server Management Studio unter Datenbank → Eigenschaften → Optionen → Kompatibilitätsgrad.

📝 Hinweis: SA-Rechte sind nicht zwingend erforderlich – für die laufenden Übersetzungen genügt ein SQL-Konto mit Lese-/Schreibrechten auf die WAWI-DB. Für das Datenbank-Update während des Setups muss das Konto zusätzlich Datenbank-Objekte anlegen und ändern dürfen (z. B. als db_owner der Wawi-Datenbank). Bitte starte die Installation erst, wenn alle Daten vollständig vorliegen.

ℹ️ Installationsservice: Falls du Unterstützung brauchst, bieten wir dir gerne einen professionellen Installationsservice an.

💾 Schritt 5 – Setup ausführen

Starte die WAWITranslator-Setup.exe per Doppelklick und folge den Anweisungen.

ℹ️ SmartScreen-Hinweis: Der Installer ist digital signiert (Herausgeber: FALKConS GmbH). Bei einer ganz neuen Version kann Windows SmartScreen anfangs dennoch eine Warnung anzeigen, bis sich die Reputation aufgebaut hat. Wähle dann „Weitere Informationen → Trotzdem ausführen“ und prüfe, dass als Herausgeber FALKConS GmbH angezeigt wird.

Dialog 1 – Lizenz und DeepL

💡 Bei einem Update: Lizenzschlüssel, DeepL-Key und die Datenbank-Angaben sind aus der bestehenden Konfiguration vorbelegt – also genau die Werte, die zuletzt in den Einstellungen gespeichert wurden. Lässt du ein Feld unverändert, bleibt der gespeicherte Wert erhalten.

ℹ️ Trial nicht mehr im Setup: Bis Version 2.4.3 gab es hier die Option „Neue Lizenz registrieren / Trial beantragen“. Sie ist entfallen – die Testversion forderst du über die Testlizenz-Seite an und bekommst den Schlüssel sofort angezeigt und per E-Mail.

Dialog 2 – SQL-Server

Setup-Assistent, Seite „Datenbank“: Server/Instanz mit Formathinweis, Datenbank, SQL-Benutzer und -Passwort, Windows-Authentifizierung und der ACHTUNG-Hinweis zu sp_WAWITranslator_selSource
Setup, Seite „Datenbank“

Das Datenbank-Update läuft in einer Transaktion: Schlägt ein Schritt fehl, wird alles zurückgenommen, die bisherige Prozedur bleibt unverändert aktiv und das Setup meldet den Fehler (siehe „Fehler bei der Installation“).

Danach ist die Installation abgeschlossen. Am Ende bietet der Assistent an, WAWITranslator direkt zu starten.

⚠️ Fehler bei der Installation

⚠️ Falsche Verbindungsdaten: Sind SQL-Zugangsdaten, Instanzname oder Datenbankname nicht korrekt, erscheint eine Fehlermeldung. Bitte die Installation mit korrigierten Eingaben wiederholen.

⚠️ Kompatibilitätsgrad zu niedrig: Liegt der Kompatibilitätsgrad der Datenbank unter 130, meldet das Setup das schon beim Klick auf „Installieren“ und ändert nichts. Die Meldung nennt den nötigen Befehl (ALTER DATABASE … SET COMPATIBILITY_LEVEL = 130 oder höher) – stimme die Umstellung am besten mit deinem Systembetreuer ab und starte das Setup danach erneut.

⚠️ Datenbank-Update fehlgeschlagen: Scheitert das Datenbank-Update – z. B. weil dem SQL-Konto Rechte fehlen –, wird es vollständig zurückgenommen; die bisherige Prozedur bleibt aktiv. Statt „Installation abgeschlossen“ erscheint dann „Die Installation konnte nicht abgeschlossen werden“ mit der Ursache, und das Setup öffnet die setup.log. Ursache beheben und das Setup erneut ausführen.

📝 „Die Datei wird bereits verwendet“: Es läuft noch ein WTS.exe- oder WAWITranslator.exe-Prozess, z. B. eine geplante Aufgabe. Den Prozess im Task-Manager beenden und das Setup erneut starten.

Die Installationsprotokolle liegen unter C:\ProgramData\WAWITranslator\setup.log (Lizenzschlüssel, DeepL-Key und Passwörter stehen nicht darin).

📝 Hinweis: Endet der Installer mit einer abweichenden Fehlermeldung, öffne bitte ein Support-Ticket unter support.falkcons.de und hänge die setup.log an.

Was installiert wird

Pfad Inhalt
...\WAWITranslator.exe Grafische Oberfläche (GUI)
...\WTS.exe Kommandozeilen-Programm
...\config.json Konfiguration (SQL, DeepL/OpenAI, Lizenz, Filter, E-Mail) – Zugangsdaten werden verschlüsselt gespeichert
...\schedules.json Geplante Aufgaben
...\scheduled_runs.log Protokoll der geplanten Läufe (eine Zeile pro Lauf)
...\setup.log Installationsprotokoll
...\translations\ Übersetzungs-Logs (JSON pro Datensatz)
...\logs\translator.log Laufzeit-Meldungen
...\THIRD-PARTY-NOTICES.md Lizenzen der Open-Source-Komponenten

(Basisordner: C:\ProgramData\WAWITranslator\)

Normale Benutzer können den Programmordner seit Version 2.6.0 nicht mehr umbenennen oder löschen. Einstellungen und geplante Aufgaben lassen sich trotzdem ohne Administratorrechte speichern.

In der Wawi-Datenbank legt das Setup im Schema _spsfc die benötigten Objekte an bzw. aktualisiert sie – u. a. die Stored Procedure sp_WAWITranslator_selSource (Auswahl der zu übersetzenden Datensätze inkl. Artikel-Filter) und die Tabelle WAWITranslatorHash (für den Modus „Versionierung“).

Update einer bestehenden Installation

Neue Versionen meldet WAWITranslator selbst (siehe Schritt 3). Das Update führt durch dieselben Dialoge wie die Erstinstallation – seit Version 2.6.0 mit diesen Besonderheiten:

⚠️ Wichtig bei selbst angepasster Stored Procedure: Hast du die Prozedur sp_WAWITranslator_selSource manuell angepasst (z. B. für eine eigene Artikelauswahl), wird sie beim Update ersetzt. Das Setup weist ausdrücklich darauf hin und fragt nach. Die bisherige Fassung bleibt als sp_WAWITranslator_selSource_Backup_<Datum> in der Datenbank erhalten – nur zum Nachschlagen, sie ist danach nicht mehr aktiv. Eine solche Sicherung legt das Setup nur an, wenn sich die installierte Prozedur von der neuen unterscheidet. Bilde deine Auswahl anschließend in den Artikel-Filtern ab (Einstellungen → Filter & Sprachen, siehe Konfiguration und Bedienung) – sonst werden beim nächsten Lauf ggf. alle Artikel übersetzt.

Rückfrage im Setup: Das Datenbank-Update ersetzt die Stored Procedure sp_WAWITranslator_selSource; die bisherige Version bleibt als Sicherung in der Datenbank
Rückfrage vor dem Datenbank-Update

Die übersetzten Daten in der Wawi bleiben beim Update unangetastet.

Deinstallation

Über Windows-Einstellungen → Apps → WAWITranslator → Deinstallieren. Ab Version 2.7.0 gibt die Deinstallation dabei den Lizenzplatz dieser Installation frei (dafür muss die Datenbank erreichbar sein), sodass du den Schlüssel direkt auf einem anderen Rechner verwenden kannst. Die config.json und die Übersetzungs-Aufzeichnungen im Ordner C:\ProgramData\WAWITranslator bleiben erhalten; die WAWITranslator-Objekte in der Datenbank ebenfalls.

Test-Lizenz – Verhalten beim ersten Lauf

Mit einem Trial-Schlüssel gelten: es sind nur die Typen 1–5 übersetzbar (Artikel-, Kategorie- und Artikel-URL-Übersetzung), max. 1 Datensatz pro Lauf, eine Wartezeit von 30 Sekunden vor dem Aufruf, und jedem übersetzten Textfeld (außer URLs) wird der Zusatz „[WAWITranslator Trial]“ angehängt. Beim Wechsel auf eine Voll-Lizenz hilft das mitgelieferte Skript, diese Markierungen zu entfernen. Ab Version 2.7.0 erkennt WAWITranslator solche Texte nach dem Eintragen der Vollversion selbst und bietet an, den Zusatz zu entfernen – die Übersetzungen bleiben, es wird nichts neu übersetzt (siehe Konfiguration und Bedienung, „Zusatz aus der Testphase entfernen“).

Hauptfenster mit Testlizenz: oben der Hinweis „Trial-Lizenz aktiv“, bei „Anzahl“ der Hinweis „Mit der Testlizenz bleibt es bei 1 Datensatz pro Lauf“, im Log die 30 Sekunden Wartezeit und ein übersetzter Datensatz
Lauf mit Testlizenz: 1 Datensatz, 30 Sekunden Wartezeit

Wie es weitergeht

Support

← Zurück zu WAWITranslator