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.

Pflichtspalten

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”)

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)

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)

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:

ZielspalteErklärungScreenshot / Beispiel
ConfiguratorGroupName_1Nicht übersetzter Gruppennamez.B. Farbe

Beispiel Farbe
TranslatedConfiguratorGroupName_1Übersetzung Gruppennamez.B. Color

Beispiel Color
TranslatedConfiguratorGroupDescription_1Übersetzung Gruppen-Beschreibungz.B. Description of color

Beispiel Gruppen-Beschreibung
TranslatedConfiguratorOptionName_1Übersetzung Optionsnamez.B. yellow

Beispiel Optionsname

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.

NameDatentypBeschreibungPflichtfeldWerte
accountACCOUNTIhre Shopware Verbindung Ja
inputSpreadsheetSPREADSHEETEin SPREADSHEET mit der Artikel ID oder Artikelnummer und den ÜbersetzungsdatenJa
mappingdefinitionSTRINGDas Mapping der ZielspaltenNein
Folgende Felder sind zu konfigurieren:

FeldDatentypBeschreibungPflichtfeldStandardwert
TypeSINGLEJaarticle
ShopIdSINGLEJa
ArticleNumberSINGLENein
ArticleIdSINGLENein
MetaTitleSINGLENein
NameSINGLENein
DescriptionSINGLENein
DescriptionLongSINGLENein
KeywordsSINGLENein
PackUnitSINGLENein
AdditionalTextSINGLENein
ShippingTimeSINGLENein
Attribute1SINGLENein
Attribute2SINGLENein
Attribute3SINGLENein
Attribute4SINGLENein
Attribute5SINGLENein
Attribute6SINGLENein
Attribute7SINGLENein
Attribute8SINGLENein
Attribute9SINGLENein
Attribute10SINGLENein
Attribute11SINGLENein
Attribute12SINGLENein
Attribute13SINGLENein
Attribute14SINGLENein
Attribute15SINGLENein
Attribute16SINGLENein
Attribute17SINGLENein
Attribute18SINGLENein
Attribute19SINGLENein
Attribute20SINGLENein
ConfiguratorGroupName_1SINGLENein
TranslatedConfiguratorGroupName_1SINGLENein
TranslatedConfiguratorGroupDescription_1SINGLENein
TranslatedConfiguratorOptionName_1SINGLENein
limitProductsSTRINGMit 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.

NameDatentypBeschreibungWerte
resultSPREADSHEETDas Ergebnis SPREADSHEET