WAWITranslator V2

Installation | WAWITranslator v2

WAWITranslator V2 – Installationsanleitung

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

🔐 Schritt 1 – DeepL-Konto erstellen

  1. Öffnen Sie deepl.com/de/pro#developer.
  2. Klicken Sie 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): Nutzen Sie die Kostenkontrolle in Ihrem DeepL-Konto. Für entstehende DeepL-Kosten übernehmen wir keine Haftung.

🗡️ Schritt 2 – DeepL-API-Key abrufen

  1. Melden Sie sich an und öffnen Sie Ihren Konto-Bereich: deepl.com/de/account/summary.
  2. Im Bereich „Authentifizierung“ finden Sie 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 – WAWITranslator herunterladen

Den Installer erhalten Sie aus unserem öffentlichen Download-Bereich auf GitHub:

Alternativ steht der Installer auch im JTL-Store zum Download bereit, wenn Sie den WAWITranslator dort erworben haben.

💡 Auto-Update: Nach der Erstinstallation müssen Sie 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

VoraussetzungDetails
BerechtigungDie Installation muss mit einem Windows-Administrator-Konto durchgeführt werden, um spätere Berechtigungsprobleme zu vermeiden.
JTL-Worker als DienstSoll der WAWITranslator über zeitversetzte Workflows laufen, installieren Sie ihn unter demselben Benutzer, unter dem auch der JTL-Worker als Dienst läuft.
Erforderliche DatenDeepL-API-Key · SQL-Server-Instanzname · Datenbankname (Standard eazybusiness) · SQL-Zugangsdaten (Windows-Auth oder SQL-Benutzer/Passwort) · WAWITranslator-Lizenzschlüssel · Firmen-E-Mail aus der Wawi
📝 Hinweis: SA-Rechte sind nicht zwingend erforderlich – ein SQL-Konto mit Lese-/Schreibrechten auf die WAWI-DB genügt. Bitte starten Sie die Installation erst, wenn alle Daten vollständig vorliegen.
ℹ️ Installationsservice: Falls Sie Unterstützung benötigen, bieten wir Ihnen gerne einen professionellen Installationsservice an.

💾 Schritt 5 – Setup ausführen

Starten Sie die WAWITranslator-Setup.exe per Doppelklick und folgen Sie 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ählen Sie dann „Weitere Informationen → Trotzdem ausführen“ und prüfen Sie, dass als Herausgeber FALKConS GmbH angezeigt wird.

Dialog 1 – Lizenz und DeepL

  • Lizenzschlüssel des WAWITranslator eingeben.
  • DeepL-API-Key (Free oder Pro) vollständig einfügen.
  • E-Mail-Adresse aus den Firmendaten der Wawi eingeben (dient der Lizenz-Zuordnung).
  • Aktivieren Sie „Neue Lizenz registrieren / Trial beantragen“, wenn Sie den WAWITranslator zum ersten Mal installieren bzw. registrieren.

Dialog 2 – SQL-Server

  • Server/Instanz, Datenbankname und Authentifizierung eingeben und auf „Installieren“ klicken.

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.

Die Installationsprotokolle liegen unter C:\ProgramData\WAWITranslator\setup.log (sensible Daten werden maskiert).

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

Was installiert wird

PfadInhalt
...\WAWITranslator.exeGrafische Oberfläche (GUI)
...\WTS.exeKommandozeilen-Programm
...\config.jsonKonfiguration (SQL, DeepL/OpenAI, Lizenz)
...\setup.logInstallationsprotokoll
...\translations\Übersetzungs-Logs (JSON pro Datensatz)
...\THIRD-PARTY-NOTICES.mdLizenzen der Open-Source-Komponenten

(Basisordner: C:\ProgramData\WAWITranslator\)

Test-Lizenz – Verhalten beim ersten Lauf

Mit einem Trial-Schlüssel gelten: kurze Wartezeit vor dem ersten Aufruf, max. 1 Datensatz pro Lauf, und jedem übersetzten Textfeld (außer URLs) wird der Zusatz „[WAWITranslator Trial]“ angehängt. Beim Wechsel auf eine Pro-Lizenz hilft das mitgelieferte Skript, diese Markierungen zu entfernen.

Support

    • Related Articles

    • Konfiguration | WAWITranslator V2

      WAWITranslator V2 – Benutzer-Anleitung Diese Anleitung richtet sich an Anwender. Die technische Steuerung über Parameter, Workflows und Kommandozeile finden Sie in der separaten Anleitung „WAWITranslator V2 – Anleitung für Fortgeschrittene“. Was kann ...
    • WAWITranslator V2 – Anleitung für Fortgeschrittene

      WAWITranslator V2 – Anleitung für Fortgeschrittene Diese Anleitung beschreibt die Steuerung über Parameter, JTL-Workflows und die Kommandozeile. Für die normale Bedienung siehe die Benutzer-Anleitung. ⚠️ Nur für fortgeschrittene Anwender. Bei Fragen ...
    • ShippingDashboard

      ShippingDashboard – Benutzeranleitung Das ShippingDashboard ist ein Live-Cockpit für deinen JTL-Wawi-Versand. Es läuft als kleiner Windows-Dienst direkt auf deinem Server und zeigt im Browser auf einen Blick: was heute noch raus muss, wie schnell ...