Automatisierung

Statt jede Änderung manuell zu übersetzen, können Sie CogiTranslator über den Shopware Flow Builder so einrichten, dass eine Übersetzung automatisch angestoßen wird, sobald ein Produkt, eine Kategorie oder ein anderer unterstützter Datensatz angelegt oder geändert wird.

Auslöser (Trigger)

Unter der Gruppe „Übersetzer" stehen im Flow Builder für sieben Bereiche jeweils zwei Auslöser zur Verfügung — „Erstellt" und „Änderungen":

• Produkt

• Kategorie

• CMS-Element

• Hersteller

• Eigenschaft

• E-Mail-Vorlage

• Landingpage

Aktionen

Passend dazu gibt es sieben Übersetzer-Aktionen, eine je Bereich (z. B. „Produkt übersetzen"). In der jeweiligen Aktion konfigurieren Sie:

Option	Bedeutung
Übersetzer	DeepL oder ChatGPT
Nur auslösen bei Änderung von …	Beschränkt den Auslöser auf bestimmte Felder (z. B. nur bei Änderung des Namens). Leer = bei jeder Änderung auslösen
Verzögerung (Sekunden, leer = global)	Überschreibt für diesen Flow die globale Verzögerung (siehe unten)
Bestehende Übersetzungen überschreiben	Wie im manuellen Übersetzungsfenster
Übersetzer Cache Ignorieren, Quellsprache, Zielsprache, Glossar, ChatGPT-Modell	Wie im manuellen Übersetzungsfenster

Bei Eigenschaften gibt es zusätzlich den Schalter „Optionen mit übersetzen".

Warum die Übersetzung nicht sofort passiert

Damit mehrere schnelle Änderungen am selben Datensatz nicht mehrfach hintereinander übersetzt werden, wartet CogiTranslator standardmäßig kurz, bevor es den Auftrag tatsächlich anlegt:

• Verzögerung — mehrere Änderungen innerhalb dieser Zeitspanne werden zu einem einzigen Übersetzungsauftrag zusammengefasst. Diese Zeit stellen Sie global in der Flow-Automatisierung-Konfiguration ein oder pro Flow überschreiben.

• Abkühlzeit — eine zusätzliche Notbremse: Wurde derselbe Datensatz in derselben Zielsprache bereits kürzlich per Flow übersetzt, wird ein erneuter automatischer Auftrag innerhalb dieser Zeitspanne verworfen. Das schützt vor versehentlichen Endlosschleifen, etwa wenn ein anderes System die übersetzten Werte zurückschreibt und dadurch selbst wieder einen Flow auslöst.

Beide Werte finden Sie in der Plugin-Konfiguration unter der Karte „Flow-Automatisierung": „Verzögerung vor Flow-Übersetzung" und „Abkühlzeit pro Datensatz & Sprache".

Voraussetzungen & Einschränkungen

Die automatische Übersetzung ist für Produkte kostenlos. Für alle anderen sechs Bereiche (Kategorie, CMS-Element, Hersteller, Eigenschaft, E-Mail-Vorlage, Landingpage) wird ein zusätzlicher In-App-Kauf benötigt. Sie können den Flow trotzdem ohne diesen Kauf speichern — er wird dann aber nicht ausgeführt.

• Interne Schreibvorgänge des Plugins selbst (z. B. beim Zurückschreiben einer Übersetzung) lösen keine neuen Flows aus.

• Änderungen, die kein tatsächlich übersetzbares Feld betreffen (z. B. reine Zuordnungen), lösen standardmäßig ebenfalls keinen Flow aus.

Diagnose bei unerwartetem Verhalten

Reagiert ein Flow nicht wie erwartet, aktivieren Sie testweise die „Flow-Diagnose-Protokollierung" in der Plugin-Konfiguration. Danach finden Sie in den Logs zu jedem geprüften Schreibvorgang einen Eintrag mit dem Grund, warum ein Flow ausgelöst — oder eben nicht ausgelöst — wurde. Denken Sie daran, diese Protokollierung nach der Fehlersuche wieder zu deaktivieren, da sie viele Log-Einträge erzeugt.

Nächster Schritt

Weiter mit dem Kapitel Werkzeuge, das Jobliste, Logs, Cache und weitere Hilfsmittel beschreibt.