Attribute & Eigenschaften (Property Groups) abgleichen
In Shopware werden Produkteigenschaften wie Farbe, Material, Größe oder technische Merkmale als Property Groups (Eigenschaften) mit zugehörigen Optionen (Werten) abgebildet. In Business Central entsprechen diese den Artikelattributen (Item Attribute) und Attributwerten (Item Attribute Value). Damit Filter, Eigenschaftsanzeige und Varianten im Shop weiter funktionieren, müssen beide Welten verknüpft werden – ohne dass Attribute doppelt entstehen.
Der Connector bietet dafür die Aktion Attribute abgleichen. Sie ist das Gegenstück zum Upload und stellt sicher, dass bereits im Shop vorhandene Eigenschaften wiederverwendet werden.
Was der Abgleich genau tut
Die Aktion Attribute abgleichen vergleicht die vorhandenen Shopware-Attribute anhand ihres Namens mit den BC-Artikelattributen. Bei einer Übereinstimmung setzt der Connector am Attribut:
die Web-ID (die Shopware-Property-Group-ID),
das Kennzeichen Web-Attribut (das Attribut ist für Shopware relevant) und
das Kennzeichen Synchronisiert.
Wichtig: Der Abgleich legt keine neuen Attribute an. Er verknüpft ausschließlich, was auf beiden Seiten bereits existiert. Zu jedem Attribut werden anschließend die Optionswerte anhand ihres Werts abgeglichen und ebenfalls verknüpft.
Voraussetzungen für ein erfolgreiches Matching
Da der Abgleich rein über Namen (Attribut) und Werte (Option) läuft, entscheidet die exakte Schreibweise über Erfolg oder Misserfolg:
Attributname identisch: „Farbe" in BC muss „Farbe" in Shopware entsprechen – nicht „Farben" oder „color".
Groß-/Kleinschreibung & Leerzeichen sollten übereinstimmen.
Optionswerte identisch: „Rot" ↔ „Rot", nicht „rot" vs. „Rot (RAL 3020)".
Planen Sie einen einheitlichen Namensstandard für Attribute und Werte, bevor Sie mit dem Abgleich beginnen. Das erspart spätere Nacharbeit.
Die Mapping-Tabelle verstehen
Für die feinere Steuerung stellt der Connector eine Attribut-Zuordnung bereit. Dort werden je Eintrag u. a. folgende Informationen geführt:
Attribut-ID / Attributname
Verknüpfung des BC-Attributs mit der Shopware-Property-Group.
Attributwert-ID / Attributwert
Verknüpfung des einzelnen Optionswerts.
Attribut-Scope
Geltungsbereich des Attributs.
Datentyp & Backend-Typ
Technische Ausprägung des Attributs (z. B. Text, Auswahl).
Pflichtfeld
Kennzeichnet, ob das Attribut zwingend zu füllen ist.
Schritt-für-Schritt
Attribute in BC vorbereiten
Legen Sie die benötigten Artikelattribute und Werte in Business Central an bzw. pflegen Sie sie. Achten Sie auf die exakte Bezeichnung wie in Shopware.
Abgleich ausführen
Starten Sie Attribute abgleichen. Der Connector verknüpft alle Attribute und Optionswerte, deren Namen/Werte übereinstimmen.
Ergebnis prüfen
Kontrollieren Sie, ob Web-ID, Web-Attribut und Synchronisiert gesetzt sind. Nicht verknüpfte Einträge deuten auf abweichende Bezeichnungen hin.
Namen angleichen & wiederholen
Korrigieren Sie abweichende Namen/Werte und führen Sie den Abgleich erneut aus.
Zusammenspiel mit Varianten
Für variantenbehaftete Produkte ist der Attribut-Abgleich die Grundlage: Erst wenn die Property Groups für Farbe und Größe korrekt verknüpft sind, können die Variantenachsen (Option 1/2/3) sauber zugeordnet werden. Wie Sie die Farb- und Größen-Eigenschaft konfigurieren, lesen Sie unter Varianten abgleichen (Farbe & Größe).
Fehlerbehebung
Attribut bleibt unverknüpft
Name weicht ab. Bezeichnung exakt an Shopware angleichen und erneut abgleichen.
Optionswert fehlt
Wert stimmt nicht überein (Schreibweise/Zusatz). Wert angleichen.
Neues Attribut in Shopware entstanden
Es wurde hochgeladen statt abgeglichen. Zuerst abgleichen, dann hochladen.
Nach dem erfolgreichen Abgleich werden Attribut-Änderungen künftig als Aktualisierung übertragen – die Verknüpfung bleibt bestehen.
Häufige Fragen
Über welche API-Endpunkte werden Attribute in Shopware angelegt?
Attribute werden als Property Groups abgebildet: Die Eigenschaft (Gruppe) wird über property-group angelegt, die einzelnen Optionswerte über property-group-option. Im Connector übernehmen das die Prozeduren Upload_ItemAttribute (Gruppe) und Upload_ItemAttributeValue (Optionen).
Wie werden Attribut-Übersetzungen gepflegt?
Übersetzungen von Attributnamen und Optionswerten laufen über die Sprachzuordnung im „SOUSHW Mapping“ (Modul Language). Je hinterlegter Sprache wird der Wert per Sprach-Header gezielt aktualisiert, sodass die Attribute in allen aktiven Shopsprachen korrekt erscheinen.