Übersetzungsverlauf

Der Übersetzungsverlauf ist die Rückgängig-Spur der Erweiterung. Zu jedem Feld, das sie schreibt, speichert sie den vorherigen Wert und den Wert, den sie geschrieben hat. Einen Massenlauf nehmen Sie deshalb Feld für Feld, als Auswahl von Zeilen oder als ganzen Auftrag zurück.

Was die Erweiterung aufzeichnet

Die Aufzeichnung ist standardmäßig aktiv. Solange sie an ist, erzeugt jedes Feld, das die Erweiterung schreibt, einen Verlaufseintrag mit diesem Inhalt:

Aufgezeichnet	Details
Das Element	Der Inhaltstyp und der Datensatz, mit der Bezeichnung, die der Datensatz zu diesem Zeitpunkt trug
Das Feld	Der technische Feldname, zum Beispiel name oder metaTitle. Ein strukturiertes Feld zeichnet die Erweiterung als Ganzes auf: Alle übersetzten Zusatzfelder eines Datensatzes teilen sich einen customFields-Eintrag
Die Sprache	Die Zielsprache, für die die Erweiterung den Wert geschrieben hat
Vorheriger Wert	Die vorherige Übersetzung. Dieser Wert ist leer, wenn es keine Übersetzung gab, und der Eintrag zeigt dann Vor diesem Eintrag existierte keine Übersetzung.
Neuer Wert	Der Wert, den die Erweiterung geschrieben hat
Status	Angewendet oder Rückgängig gemacht
Zeitpunkt	Der Zeitpunkt der Übersetzung

Verlaufseinträge entstehen bei Läufen des Assistenten, bei Schnellübersetzungen an einem Produkt oder einer Kategorie, bei CLI-Aufträgen und bei der Automatisierung beim Speichern. Läufe beim Speichern legen keinen Auftragsdatensatz an, deshalb haben ihre Einträge keinen Auftrag zum Öffnen. Die Erweiterung zeichnet sie trotzdem auf, und Sie nehmen sie wie jeden anderen Eintrag zurück. Siehe Automatisierung.

Die Erweiterung zeichnet nur die Felder auf, die sich geändert haben. Ein übersprungenes Feld erzeugt keinen Eintrag. Das gilt für jeden Übersprunggrund: eine vorhandene Übersetzung, eine unveränderte Quelle oder eine Handbearbeitung.

Die globale Verlaufsansicht

Kataloge → KI-Übersetzung → Verlauf zeigt jeden Eintrag des Shops, den neuesten zuerst.

Bedienelement	Wirkung
Verlauf durchsuchen	Sucht in der Bezeichnung des Elements und im Feldnamen
Inhaltstyp	Grenzt die Liste auf einen Inhaltstyp ein
Status	Angewendet oder Rückgängig gemacht
Filter zurücksetzen	Setzt die Suche und beide Filter zurück

Die Spalten sind Element, Inhaltstyp, Feld, Sprache, Status und Übersetzt am. Wenn ein Datensatz seine Bezeichnung nach der Übersetzung verloren hat, zeigt seine Zeile den Inhaltstyp und eine gekürzte ID.

Werte prüfen

Werte anzeigen im Kontextmenü einer Zeile öffnet den Dialog Übersetzungswerte. Der Dialog zeigt den vorherigen und den neuen Wert nebeneinander, beide mit einer Schaltfläche Kopieren.

Nutzen Sie den Dialog, um eine Übersetzung zu beurteilen, bevor Sie über das Behalten entscheiden. Der Dialog enthält außerdem die Schaltfläche Rückgängig machen oder Erneut anwenden für diesen Eintrag.

Rückgängig machen und erneut anwenden

Der Status des Eintrags entscheidet, welche der beiden Aktionen verfügbar ist:

• Rückgängig machen schreibt den vorherigen Wert zurück. Die Aktion steht für Einträge im Status Angewendet bereit.
• Erneut anwenden schreibt den übersetzten Wert erneut. Die Aktion steht für Einträge im Status Rückgängig gemacht bereit.

Nutzen Sie das Kontextmenü einer einzelnen Zeile oder den Wertedialog. Alternativ markieren Sie mehrere Zeilen und nutzen Auswahl rückgängig machen oder Auswahl erneut anwenden. In einer gemischten Auswahl wirkt jede Schaltfläche nur auf die Zeilen im passenden Status. Eine Aktion verarbeitet höchstens 200 Einträge. Teilen Sie die Auswahl für eine größere Rücknahme auf, oder nehmen Sie den Auftrag als Ganzes zurück.

Danach meldet die Erweiterung das Ergebnis, zum Beispiel 12 rückgängig gemacht, 3 übersprungen (geändert oder falscher Status). Der Schutz weiter unten erzeugt die Zahl der übersprungenen Einträge.

Wenn Sie einen Eintrag mit leerem vorherigem Wert zurücksetzen, entfernt die Erweiterung die Übersetzung für diese Sprache wieder und schreibt keine leere Zeichenkette. Bei Storefront-Textbausteinen löscht sie den Textbaustein, den die Übersetzung angelegt hat, und ein erneutes Anwenden legt ihn wieder an.

Nach einem erfolgreichen Rückgängigmachen oder erneuten Anwenden gleicht die Erweiterung ihre eigenen Fingerabdrücke wieder ab. Der Schutz manueller Änderungen hält die Änderung beim nächsten Lauf deshalb nicht für eine Handbearbeitung.

Verlauf innerhalb eines Auftrags

Die Detailseite eines Auftrags zeigt dieselbe Liste unter Übersetzungsverlauf, gefiltert auf diesen Auftrag. Sie sehen die Felder, die dieser Auftrag geschrieben hat, mit demselben Wertedialog und denselben Aktionen je Zeile.

Für eine Rücknahme des gesamten Auftrags stellt Alle Übersetzungen rückgängig machen jeden angewendeten Eintrag dieses Auftrags in die Warteschlange. Vor dem Start nennt eine Bestätigung, was passieren wird: Alle von diesem Auftrag geschriebenen Übersetzungen werden im Hintergrund auf ihre vorherigen Werte zurückgesetzt. Felder, die nach der Übersetzung manuell bearbeitet wurden, sind geschützt und werden übersprungen.

Für die Rücknahme eines ganzen Auftrags gelten drei Einschränkungen:

• Die Erweiterung lehnt einen wartenden und einen laufenden Auftrag ab. Brechen Sie den Auftrag zuerst ab, und nehmen Sie danach zurück, was er bereits geschrieben hat.
• Die Erweiterung lehnt auch einen Auftrag ohne angewendete Einträge ab, etwa weil Sie bereits alles zurückgesetzt haben oder weil die Aufzeichnung während des Laufs aus war.
• Die Queue-Worker verarbeiten die Rücknahme im Hintergrund, über dieselbe Warteschlange wie die Übersetzung, deshalb müssen die Worker aktiv sein. Die Verlaufsliste darunter aktualisiert sich, während die Erweiterung die Einträge verarbeitet.

Aufträge & Überwachung beschreibt die Auftragsstatus, den Abbruch und den erneuten Anlauf.

Der Schutz beim Zurücksetzen

Das Rückgängigmachen und das erneute Anwenden prüfen das Feld, bevor sie es verändern. Die Erweiterung liest den aktuellen Wert des Feldes in dieser Sprache und vergleicht ihn mit dem Wert, den die Aktion erwartet. Ein aktueller Wert, der sich seit der Übersetzung oder seit dem Zurücksetzen geändert hat, stoppt den Schreibvorgang. Die Erweiterung lässt das Feld unverändert stehen und zählt es als übersprungen.

Aktion	Erwartet als aktuellen Wert	Wenn er abweicht
Rückgängig machen	den neuen Wert, den die Übersetzung geschrieben hat	Die Erweiterung überspringt das Feld
Erneut anwenden	den vorherigen Wert, den das Zurücksetzen wiederhergestellt hat	Die Erweiterung überspringt das Feld

Die Erweiterung überspringt außerdem drei weitere Arten von Eintrag: einen Eintrag im falschen Status für die Aktion, einen Eintrag, dessen Datensatz oder Inhaltstyp nicht mehr existiert, und einen Eintrag, dessen Schreibvorgang scheitert. Die Meldung zählt jeden übersprungenen Eintrag mit. Ein Ergebnis von 0 rückgängig gemacht, 40 übersprungen zeigt Ihnen deshalb, dass sich die Inhalte seit dem Übersetzungslauf geändert haben.

Der Vergleich ist tolerant. Eine leere Zeichenkette und ein fehlender Wert gelten als dasselbe. Strukturierte Felder wie Zusatzfelder vergleicht die Erweiterung über ihren dekodierten Inhalt, deshalb hat die Reihenfolge der Schlüssel keine Wirkung.

Aufbewahrung und Abschalten der Aufzeichnung

Beide Einstellungen liegen unter Einstellungen → Erweitert → Übersetzungsverlauf.

Einstellung	Standard	Wirkung
Übersetzungsverlauf aufzeichnen	An	Speichert den vorherigen und den neuen Wert jedes übersetzten Feldes
Aufbewahrungsdauer (Tage)	30	Die Erweiterung löscht die Einträge, die älter als dieser Zeitraum sind

Zwei Details sind in der Praxis wichtig:

• Die Bereinigung braucht den Scheduled-Task-Runner. Die stündliche geplante Aufgabe nice_translate.auto_translate löscht die alten Einträge bei jedem Durchlauf, auch dann, wenn die Aufzeichnung aus ist. Wenn bin/console scheduled-task:run nicht läuft, löscht die Erweiterung nichts. Siehe Automatisierung.
• Das Abschalten der Aufzeichnung wirkt ab diesem Moment. Neue Übersetzungen erzeugen keine Einträge. Die vorhandenen Einträge bleiben bis zum Ende ihrer Aufbewahrungsdauer erhalten. Eine Übersetzung, die ohne Verlauf gelaufen ist, können Sie nicht zurücknehmen, denn die Erweiterung hält keine zweite Kopie des vorherigen Wertes.

Wägen Sie die Aufbewahrungsdauer gegen das Rücknahmefenster ab, das Sie haben wollen. Ein längerer Zeitraum hält dieses Fenster länger offen und behält mehr Shop-Inhalte in der Datenbank.

Achtung

Datenschutz. Verlaufszeilen enthalten Ihre tatsächlichen Shop-Inhalte: Produkttexte, CMS-Texte, E-Mail-Vorlagen, Textbausteine und Zusatzfelder, mit allen personenbezogenen oder vertraulichen Angaben in diesen Texten. Berücksichtigen Sie das bei der Wahl der Aufbewahrungsdauer, und lesen Sie den Datenschutz, bevor Sie den Zeitraum verlängern.

Berechtigungen

Zum Lesen des Verlaufs brauchen Sie nice_translate.viewer. Zum Rückgängigmachen und erneuten Anwenden brauchen Sie nice_translate.editor, und ohne diese Berechtigung zeigt die Administration die Aktionsschaltflächen nicht an. Siehe Berechtigungen (ACL).