Skip to content

ShopwareSetArticleTranslations - Shopware

Version: 5.2+

← Shopware Add-On Übersicht

Mit dem Step ShopwareSetArticleTranslations können Übersetzungstexte für Artikel und Varianten zu Shopware importiert und aktualisiert werden.

Benötigt wird hierzu ein Spreadsheet mit mindestens den Pflichtspalten: 

  • Type: Typ der Übersetzung (article oder variant)

  • ShopId: Id des Shops für den die Übersetzung hinzugefügt oder aktualisiert werden soll

  • ArticleNumber oder ArticleId: Artikelnummer oder ID für den die Übersetzung hinzugefügt oder aktualisiert werden soll

Spezielle Zielspalten für Artikel (“article”) und Varianten (“variant”)

Section titled “Spezielle Zielspalten für Artikel (“article”) und Varianten (“variant”)”

Folgende Zielspalten können nur bei Type = “article” verwendet werden: 

Name, MetaTitle, Keywords, DescriptionLong, Description

Folgende Zielspalten können nur bei Type = “variant” verwendet werden: 

AdditionalText

Übersetzung eigener Freitextfelder/Attribute (ab Shopware 5.2)

Section titled “Übersetzung eigener Freitextfelder/Attribute (ab Shopware 5.2)”

Ab Shopware 5.2 ist es möglich neben den 20 Standard-Feldern, weitere Attribute anzulegen. 

Diese Attribute können gesetzt werden, indem Sie in der Konfiguration des Steps eine neue Spalte hinzufügen, die den Titel *Attribute_{Spaltenname} *hat.

Übersetzung von Freitextfelder/Attribute leeren (ab Shopware 5.2)

Section titled “Übersetzung von Freitextfelder/Attribute leeren (ab Shopware 5.2)”

Um die Übersetzungen Freitextfelder zu leeren ist es notwendig, dass das Wert Feld der Attribut Spalte gefüllt ist. Um einen leeren Wert in Shopware zu setzen, können sie die spezielle Freemarker Variable ${_emptyValue!} ([Leerwert]) im Wert Feld in der Zielspalte des Freitextfeldes einfügen. Bitte beachten sie, dass bei einem gefüllten Wert Feld, die Werte immer zu Shopware übertragen werden. Wenn sie den Wert nur unter einer bestimmten Bedingung leeren wollen, müssen sie ggf. explizit den aktuell vorhanden Wert bei einer nicht zutreffenden Bedingung übermitteln. 

Beispiel

Attribute_meinTextFeld

<#if BedingungZumLeeren == true>${_emptyValue!}<#else>${Attribute_meinTextFeld!}</#if>

Übersetzung von ConfiguratorGroups und ConfiguratorOptions

Für die Übersetzung von ConfiguratorGroups und ConfiguratorOptions stehen die Zielspalten:

Zielspalte Erklärung  Screenshot / Beispiel
ConfiguratorGroupName_1 Nicht übersetzte Gruppenname 

z.B: Farbe


TranslatedConfiguratorGroupName_1 Übersetzung Gruppenname 

z.B. Color


TranslatedConfiguratorGroupDescription_1 Übersetzung Gruppen-Beschreibung

z.B. Description of color

TranslatedConfiguratorOptionName_1 Übersetzung Optionsname

z.B. yellow

Wenn mehr als eine Gruppe (z.B. Größe) am Artikel vorhanden ist und diese auch übersetzt werden soll, können sie die Zielspalten einfach duplizieren und die Nummer am Ende hochzählen, z.B. 

ConfiguratorGroupName_2, TranslatedConfiguratorGroupName_2, TranslatedConfiguratorGroupDescription_2 und  TranslatedConfiguratorOptionName_2

für die Übersetzungen der zweiten Gruppe.


Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name Datentyp Beschreibung Pflichtfeld Werte
account ACCOUNT Ihre Shopware Verbindung Ja
inputSpreadsheet SPREADSHEET Ein SPREADSHEET mit der Artikel ID oder Artikelnummer und den Übersetzungsdaten Ja
mappingdefinition STRING Das Mapping der Zielspalten Nein
Folgende Felder sind zu konfigurieren :

Feld Datentyp Beschreibung Pflichtfeld Standardwert
Type SINGLE Ja article
ShopId SINGLE Ja
ArticleNumber SINGLE Nein
ArticleId SINGLE Nein
MetaTitle SINGLE Nein
Name SINGLE Nein
Description SINGLE Nein
DescriptionLong SINGLE Nein
Keywords SINGLE Nein
PackUnit SINGLE Nein
AdditionalText SINGLE Nein
ShippingTime SINGLE Nein
Attribute1 SINGLE Nein
Attribute2 SINGLE Nein
Attribute3 SINGLE Nein
Attribute4 SINGLE Nein
Attribute5 SINGLE Nein
Attribute6 SINGLE Nein
Attribute7 SINGLE Nein
Attribute8 SINGLE Nein
Attribute9 SINGLE Nein
Attribute10 SINGLE Nein
Attribute11 SINGLE Nein
Attribute12 SINGLE Nein
Attribute13 SINGLE Nein
Attribute14 SINGLE Nein
Attribute15 SINGLE Nein
Attribute16 SINGLE Nein
Attribute17 SINGLE Nein
Attribute18 SINGLE Nein
Attribute19 SINGLE Nein
Attribute20 SINGLE Nein
ConfiguratorGroupName_1 SINGLE Nein
TranslatedConfiguratorGroupName_1 SINGLE Nein
TranslatedConfiguratorGroupDescription_1 SINGLE Nein
TranslatedConfiguratorOptionName_1 SINGLE Nein
limitProducts STRING Mit dem Limit können sie die Anzahl der Zeilen(Artikel). So kein Limit verwenden werden, können sie das Feld leer lassen. Nein

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name Datentyp Beschreibung Pflichtfeld Werte
result SPREADSHEET Das Ergebnis SPREADSHEET Ja