Übertragen Sie Ihre Profile in „Gemeinsame Werte“

Wenn Sie viele Produktprofile haben, finden sich darin wahrscheinlich auch immer wieder dieselbe Größe oder Farbe. „Medium“ im T-Shirt-Profil, „Medium“ im Hosenprofil und vielleicht „M“ in einem dritten. Durch die Zusammenführung der Werte werden diese zu einem einheitlichen Wert, sodass du und deine Kunden alle Artikel in Größe „Medium“ profilübergreifend finden können. Dieser Artikel zeigt dir, wie du deine bestehenden Profile übertragen kannst – ganz gleich, ob du fünf oder 600 Profile hast.

Es gibt drei Möglichkeiten, dies zu tun. Wähle die für dich passende aus:

• Methode A, im Admin-Bereich: für dich mit wenigen Profilen. Du klickst dich nacheinander durch die Profile.
• Methode B, über die REST-API: für Ihren Entwickler oder Integrator, wenn es viele Profile gibt.
• Methode C, mit Claude: für Sie mit vielen Profilen, die lieber in normalem Dänisch schreiben als zu programmieren.

Wenn du dir nicht sicher bist, was ein gemeinsamer Wert ist, beginne mit dem Hauptartikel „Gemeinsame Werte“ oder der kurzen Erklärung im Wörterbuch.

Bevor Sie loslegen

Was ändert sich und was bleibt unverändert?

Wenn du einen Profilwert mit einem geteilten Wert verknüpfst, richtest du lediglich eine Verknüpfung ein. Der Wert des Profils bleibt unverändert. Das bedeutet:

• Deine Produkte, Varianten, Lagerbestände, Preise und Bestellungen ändern sich nicht.
• Kunden, die Artikel im Warenkorb haben, bemerken nichts davon.
• Alles lässt sich rückgängig machen. Wenn du die Verknüpfung wieder aufhebst, bleibt der Profilwert als normaler Wert erhalten.

Namen ändern sich nur, wenn du dies selbst veranlasst: wenn du einen Wert umbenennst, bevor du ihn verknüpfst, wenn ein Entwickler die Einstellung nutzt, um die Schreibweise zu korrigieren (siehe Spur B), oder wenn du später einen verknüpften Wert umbenennst. Dann erhalten alle verknüpften Werte den neuen Namen, auch diejenigen, die zuvor anders geschrieben waren. Bestellungen behalten immer den Namen, den der Artikel zum Zeitpunkt des Kaufs hatte.

Planen Sie die Namen zuerst

Nimm dir fünf Minuten Zeit, um aufzuschreiben, welche freigegebenen Werte du haben möchtest. Das sind die Namen, die der Kunde beim Filtern sieht. Ein paar gute Tipps:

• Wähle eine Schreibweise. Soll es „M“ oder „Medium“ heißen? Entscheide dich und verwende diese Schreibweise überall einheitlich.
• Halte verschiedene Dinge voneinander getrennt. Wenn zwei Werte unterschiedliche Bedeutungen haben, erstelle zwei getrennte Werte. Ein „M“ für Erwachsene und ein „M“ für Kinder sind nicht dieselbe Größe, erstelle also z. B. „M“ und „M (Kinder)“.
• Verbinde nur Attribute, die dasselbe bedeuten. „Nein“ im Attribut „Wasserdicht“ ist nicht dasselbe wie „Nein“ im Attribut „Ökologisch“. Wenn du sie verknüpfst, sieht der Kunde beide Arten von Produkten, wenn er nach „Nein“ filtert.
• Groß- und Kleinschreibung spielt keine Rolle. „medium“ und „Medium“ gelten als derselbe Name.

Geteilte Werte funktionieren nur bei Attributen vom Typ „Liste von Werten“, die du selbst ausfüllst. Felder, in die der Kunde selbst etwas eingibt, können nicht geteilt werden.

Methode A: im Admin-Bereich (wenige Profile)

Diese Methode eignet sich, wenn Sie nur eine Handvoll Profile haben. Bilder aller Bildschirmansichten finden Sie im Hauptartikel „Geteilte Werte“.

1. Erstellen Sie die geteilten Werte

1. Gehen Sie zu Webshop → Produktprofile.
2. Klicke oben rechts auf die Schaltfläche „Geteilte Werte “.
3. Gib den Namen in das Feld „Wert hier hinzufügen“ ein und drücke die Eingabetaste. Du kannst mehrere Werte gleichzeitig erstellen, indem du sie durch Semikolons trennst, z. B. „Small;Medium;Large“.
4. Ziehe die Werte in die Reihenfolge, in der sie angezeigt werden sollen.

2. Die Werte des Profils als gemeinsame Werte festlegen

1. Öffnen Sie ein Profil unter „Webshop“ → „Produktprofile“.
2. Suchen Sie das Attribut, z. B. „Größe“, und klicken Sie in das Feld „Werte“.
3. Geben Sie den Namen eines Werts ein, den das Profil bereits enthält, z. B. „Medium“.
4. Es wird eine Liste mit Vorschlägen angezeigt. Neben dem geteilten Wert steht „Deinen Wert teilen“. Wähle ihn mit der Maus oder mit den Pfeiltasten und der Eingabetaste aus.
5. Der vorhandene Wert des Profils erhält nun ein Link-Symbol. Es wird kein neuer Wert angelegt, und Varianten, Lagerbestand und Preise bleiben unverändert.
6. Wiederhole diesen Vorgang für jeden Wert. Die Verknüpfung wird sofort gespeichert.

Steht neben dem Vorschlag „bereits vorhanden“, ist der Wert in diesem Profil bereits verknüpft, und du kannst ihn überspringen.

Wenn der Wert im Profil anders geschrieben ist

Wenn der Wert im Profil „M“ heißt, in deinen geteilten Werten jedoch „Medium“, musst du ihn zunächst umbenennen:

1. Klicke auf den Bleistift neben „M“ im Profil und korrigiere den Namen zu „Medium“.
2. Gib „Medium“ in das Feld „Werte“ ein und wähle den Vorschlag aus, um deinen Wert freizugeben.

Wenn das Attribut bereits andere freigegebene Werte hat, wird der Wert sofort verknüpft, sobald du ihn umbenennst. Das erkennst du am Link-Symbol, und in der Vorschlagsliste steht dann „bereits vorhanden“. Damit bist du mit diesem Wert fertig und kannst Schritt 2 überspringen. Hat das Attribut noch keine freigegebenen Werte, erfolgt die Verknüpfung erst, wenn du den Vorschlag in Schritt 2 auswählst.

Das Umbenennen eines Variantenwerts ändert nur den Namen. Bestandszahlen und Bestandsverlauf bleiben erhalten.

Anleitung B: über die REST-API (viele Profile)

Die REST-API verfügt über drei Endpunkte für die Verschiebung: Kandidaten finden, diese verknüpfen und die Verknüpfung wieder aufheben, falls Sie es sich anders überlegen. Alle Aufrufe verwenden deinen API-Schlüssel als Rohschlüssel im „Authorization“-Header, ohne das vorangestellte „Bearer“. POST-Aufrufe müssen den Content-Type: application/json haben. Siehe „API-Schlüssel suchen oder erstellen“. In den Beispielen steht „DIN_TOKEN“ anstelle des Schlüssels.

1. Erstellen Sie die gemeinsamen Werte

Erstellen Sie die Namen, die im Webshop angezeigt werden sollen. Wenn ein Wert bereits vorhanden ist, wird der bestehende Wert anstelle einer Kopie zurückgegeben.

curl -X POST https://www.shoporama.dk/REST/attribute-shared-value \
  -H "Authorization: DIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"values": ["Small", "Medium", "Large"]}'

Du kannst diesen Schritt auch überspringen und die fehlenden Werte vom Link-Aufruf erstellen lassen (siehe „create_missing“ weiter unten). In diesem Fall werden jedoch die Namen verwendet, die die Profile zufällig verwenden.

2. Finde die Kandidaten

Der Aufruf findet Listenattribute mit demselben Namen in mehreren Profilen, z. B. „Größe“ in 40 Profilen. Du erhältst die IDs der Attribute, alle Werte mit Anzahl, Schreibweisen, die sich nur in Groß- und Kleinschreibung unterscheiden (z. B. „s“ und „S“), und welchen gemeinsamen Wert jeder Wert bereits hat. Unterschiedliche Bezeichnungen für dieselbe Größe, z. B. „S“ und „Small“, werden als zwei Werte aufgeführt. Diese fügst du im nächsten Schritt mithilfe von Mapping zusammen.

curl "https://www.shoporama.dk/REST/attribute-shared-value/candidates?search=Størrelse" \
  -H "Authorization: DIN_TOKEN"

Auszug aus der Antwort:

{
    "candidates": [
        {
            "name": "Größe",
            "attribute_count": 3,
            "profile_count": 3,
            "attributes": [
                {
                    "attribute_id": 3667,
                    "name": "Größe",
                    "profile_id": 2939,
                    "profile_name": "Sweatshirts",
                    "is_variant": true,
                    "value_count": 3,
                    "linked_count": 0
                }
            ],
            "values": [
                {
                    "value": "S",
                    "count": 3,
                    "spellings": ["S"],
                    "attribute_shared_value_id": null
                }
            ]
        }
    ],
    "max_attributes_per_link": 50
}

Verwende „min_attributes“ (Standardwert 2), um nur Namen anzuzeigen, die in mindestens so vielen Attributen vorkommen. Gehe die Liste durch und wähle nur die Attribute aus, die dasselbe bedeuten.

3. Testen Sie die Verknüpfung

Der Link-Aufruf verknüpft jeden Wert in den Attributen mit dem gleichnamigen gemeinsamen Wert. Dies läuft als Testdurchlauf, es sei denn, du übergibst „dry_run“: false; in diesem Fall wird zunächst nichts gespeichert.

curl -X POST https://www.shoporama.dk/REST/attribute-shared-value/link \
  -H „Authorization: DIN_TOKEN“ \
  -H „Content-Type: application/json“ \
  -d '{
    "attribute_ids": [3667, 3673, 3689],
    "mapping": {"S": "Small", "M": "Medium", "L": "Large"},
    "create_missing": false,
    "dry_run": true
  }'

Die Felder im Aufruf:

• attribute_ids: Die Attribute aus Schritt 2. Maximal 50 pro Aufruf. Wenn du mehr hast, teile die Liste auf und rufe den Dienst mehrmals auf.
• mapping: Übersetzt die Schreibweise der Profile in den zugeordneten Wert, z. B. {"S": "Small"}. Groß- und Kleinschreibung spielt keine Rolle. Werte ohne Zuordnung werden anhand ihres eigenen Namens abgeglichen.
• create_missing: Standardwert „true“ erstellt gemeinsame Werte für Namen, die noch nicht vorhanden sind. Bei „false“ werden nur die gemeinsamen Werte verwendet, die du bereits hast, und der Rest bleibt als „unmatched“ stehen.
• rename: Standardwert „false“, sodass die Profile ihre eigene Schreibweise beibehalten („S“ bleibt bestehen, ist aber mit „Small“ verknüpft). Bei „true“ werden die Profilwerte ebenfalls umbenannt, sodass sie denselben Namen wie der gemeinsame Wert tragen. Dies wirkt sich auf die Variantennamen in den Lagerlisten aus, nicht jedoch auf alte Bestellungen.
• dry_run: Standardwert „true“.

4. Lesen Sie die Antwort

Die Antwort zeigt für jedes Attribut und jeden Wert an, was geschehen wird. Hier auf ein Attribut verkürzt:

{
    "dry_run": true,
    "summary": {
        "attributes": 3,
        "values_linked": 9,
        "values_already_linked": 0,
        "shared_values_created": 0,
        "values_unmatched": 0,
        "values_renamed": 0
    },
    "attributes": [
        {
            "attribute_id": 3667,
            "name": "Größe",
            "profile_id": 2939,
            "profile_name": "Sweatshirts",
            "values": [
                {
                    "attribute_value_id": 22302,
                    "value": "S",
                    "action": "link",
                    "attribute_shared_value_id": 1,
                    "shared_value": "Small"
                },
                {
                    "attribute_value_id": 22558,
                    "value": "M",
                    "action": "link",
                    "attribute_shared_value_id": 2,
                    "shared_value": "Medium"
                },
                {
                    "attribute_value_id": 22304,
                    "value": "L",
                    "action": "link",
                    "attribute_shared_value_id": 3,
                    "shared_value": "Large"
                }
            ]
        }
    ],
    "created_shared_values": [],
    "warnings": [],
    "errors": [],
    "notes": [
        "dry_run: Es wurden keine Änderungen vorgenommen. Rufen Sie den Befehl erneut mit dry_run=false auf, um die Änderungen zu übernehmen."
    ]
}

Überprüfen Sie insbesondere diese Felder:

• Aktion pro Wert: link (verknüpft), already_linked (bereits verknüpft), unmatched (kein gemeinsamer Wert und create_missing ist deaktiviert) oder skipped_empty (leerer Wert, wird übersprungen).
• created_shared_values: die gemeinsamen Werte, die erstellt werden. Wenn dort Namen stehen, mit denen du nicht gerechnet hast, füge sie dem Mapping hinzu.
• warnings: Attribute, bei denen zwei Werte denselben gemeinsamen Wert haben, z. B. sowohl „S“ als auch „Small“. Beide werden verknüpft, aber keines davon wird umbenannt, damit das Attribut nicht zwei identische Werte erhält.
• errors: z. B. ein Attribut, das nicht existiert, keine Liste ist, zu einem gelöschten Profil gehört oder mehr als 50 Attribute umfasst. In diesem Fall antwortet die API mit dem Status 400, und es wird nichts gespeichert.

5. Führen Sie die Verknüpfung durch

Wenn der Testlauf korrekt aussieht, sende genau denselben Aufruf mit „dry_run“: false. Die Antwort hat denselben Aufbau. Der Aufruf kann bedenkenlos erneut ausgeführt werden: Werte, die bereits verknüpft sind, werden als „already_linked“ angezeigt.

6. Überprüfen Sie das Ergebnis

Rufen Sie die gemeinsam genutzten Werte mit GET /attribute-shared-value ab. Das Feld „linked_count“ zeigt an, wie viele Profilwerte jeden Wert verwenden. Rufen Sie anschließend die Produkte mit einem profilübergreifend gemeinsam genutzten Wert ab:

curl "https://www.shoporama.dk/REST/product?attribute_shared_value_id=2" \
  -H "Authorization: DIN_TOKEN"

| bedeutet „oder“, und das Komma bedeutet „und“: attribute_shared_value_id=2|3,5 bedeutet (Medium oder Large) und den gemeinsamen Wert mit der ID 5. Fügen Sie in_stock=1 hinzu, um nur Varianten zu erhalten, die auf Lager sind. Du kannst auch „is_online=1“ hinzufügen. Die übrigen Filter in der Produktliste, z. B. „search“, „category_id“ und „profile_id“, lassen sich nicht damit kombinieren.

7. Rückgängig machen mit „unlink“

„unlink“ entfernt die Verknüpfung für alle Werte in den angegebenen Attributen. Die Profilwerte und die geteilten Werte bleiben erhalten. Genau wie „link“ ist „unlink“ ein Testlauf, es sei denn, du sendest „dry_run“: false:

curl -X POST https://www.shoporama.dk/REST/attribute-shared-value/unlink \
  -H "Authorization: DIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"attribute_ids": [3667], "dry_run": true}'

{
    "dry_run": true,
    "attribute_ids": [3667],
    "values_unlinked": 3,
    "errors": []
}

Auch hier gilt die Begrenzung auf 50 Attribute pro Aufruf. Wenn du „rename“ verwendet hast, bleibt der neue Name nach dem „unlink“ erhalten. Die gesamte API ist in der REST-API-Dokumentation unter „Shared Values“ beschrieben.

Szenario C: mit Claude

Wenn du Claude mit deinem Webshop verbunden hast (siehe „Den Shop mit KI steuern“), kann Claude den gesamten Umzug für dich erledigen. Du gibst ein, was du möchtest, und Claude findet die Attribute, zeigt dir das Ergebnis an und verknüpft sie, sobald du deine Zustimmung gibst.

Beispiele dafür, was du schreiben kannst

• „Finde alle Attribute namens ‚Größe‘ in meinen Profilen und zeige mir, was passiert, wenn du sie mit den gemeinsamen Werten ‚Small‘, ‚Medium‘ und ‚Large‘ verknüpfst.“
• „Erstelle die gemeinsamen Werte ‚XS‘, ‚Small‘, ‚Medium‘, ‚Large‘ und ‚XL‘ und verknüpfe alle meine Größen damit. Wo im Profil ‚S‘, ‚M‘ oder ‚L‘ steht, sollen sie mit ‚Small‘, ‚Medium‘ und ‚Large‘ verknüpft werden.“
• „Welche Schreibweisen für die Farben habe ich in meinen Profilen? Schlage vor, welche gemeinsamen Werte ich erstellen sollte.“
• „Entferne die Verknüpfung zu den gemeinsamen Werten im Profil ‚Kinderbekleidung‘.“

So funktioniert Claude

Claude nutzt dieselben Funktionen wie die REST-API. Für Entwickler, die das Audit-Protokoll verfolgen möchten, lauten die Befehle:

• attribute_shared_value_candidates (Gleiche Attributwerte finden): Findet Attribute mit demselben Namen in mehreren Profilen.
• attribute_shared_value_link (Werte mit gemeinsamen Werten verknüpfen): Verknüpft die Werte, maximal 50 Attribute auf einmal.
• attribute_shared_value_unlink (Verknüpfung zu gemeinsamen Werten aufheben): Hebt die Verknüpfung auf.
• Außerdem „attribute_shared_value_list“ und „attribute_shared_value_create“, um die gemeinsamen Werte anzuzeigen und anzulegen.

Claude ist angewiesen, immer zuerst einen Testlauf durchzuführen und dir zu zeigen, was verknüpft wird, welche gemeinsamen Werte erstellt werden und ob es eventuelle Warnungen gibt. Erst wenn du zugestimmt hast, nimmt Claude die Verknüpfung endgültig vor. Wenn du viele Profile hast, teilt Claude die Arbeit selbst in Blöcke zu je 50 auf.

Wenn du „Zusätzliche Sicherheit“ aktiviert hast, musst du die Verknüpfung und das Aufheben von Verknüpfungen im Admin-Bereich genehmigen, bevor sie ausgeführt werden. Das Gleiche gilt, wenn Claude einen freigegebenen Wert löschen soll. Der Testlauf ändert nichts und läuft daher ohne Genehmigung ab.

Nach der Migration

• Neue Werte werden automatisch verknüpft. Wenn ein Attribut geteilte Werte hat, wird ein neuer Wert mit demselben Namen wie ein geteilter Wert automatisch verknüpft. Dies gilt auch, wenn du Produkte per CSV importierst oder wenn eine Integration Werte anlegt. Attribute ohne gemeinsam genutzte Werte sind davon nicht betroffen, und es werden niemals von selbst neue gemeinsam genutzte Werte angelegt.
• Der Name ist im Profil gesperrt. Ein gemeinsamer Wert hat in allen Profilen denselben Namen. Wenn Sie den Namen also unter „Gemeinsame Werte“ ändern, gilt dies für alle Profile. Soll ein Profil einen eigenen Namen haben, klicken Sie auf den Bleistift und wählen Sie „Als normalen Wert festlegen“.
• Filterung im Webshop. In den Designs „Montana“ und „MontanaB2B“ fasst der Produktfilter die verknüpften Werte unter dem Namen des gemeinsamen Werts zusammen. Filtert der Kunde nach „Medium“, werden Produkte aus allen Profilen angezeigt. Dazu muss der Filter unter „Design → Filter“ eingerichtet sein. Siehe den Artikel zur Produktfilterung. Bei anderen Themes gibt es für den Kunden keinen Unterschied.

So machen Sie die Änderung rückgängig

• Einen Wert in einem Profil: Klicken Sie auf den Bleistift neben dem Wert im Profil und wählen Sie „Als normalen Wert festlegen“.
• Einen gesamten geteilten Wert: Lösche ihn auf der Seite „Geteilte Werte“ mit dem Häkchen. Die Profile behalten den Wert, er ist nur nicht mehr geteilt.
• Viele Attribute auf einmal: Verwende „unlink“ in der REST-API oder bitte Claude, die Verknüpfung zu entfernen.

In allen Fällen bleiben die Profilwerte als normale Werte erhalten. Wenn du Werte dabei umbenannt hast, behalten sie den neuen Namen.

Häufig gestellte Fragen

Kann ich dabei meine Produkte beschädigen?

Nein. Die Verknüpfung ist eine zusätzliche Ebene über deinen Profilen. Produkte, Varianten, Lagerbestände, Preise und Bestellungen bleiben unberührt, und du kannst die Verknüpfung jederzeit wieder aufheben. Das Einzige, worauf du achten musst, ist, dass du dabei keine Werte löschst.

Wie kann ich erkennen, ob ein Wert bereits geteilt ist?

Im Profil ist ein verknüpfter Wert mit einem Link-Symbol gekennzeichnet. Auf der Seite „Verknüpfte Werte“ steht bei jedem Wert eine Zahl, die angibt, wie viele Profilwerte diesen Wert verwenden. Wenn die Zahl 0 ist, wurde noch nichts verknüpft.

Ich habe über 400 Profile. Muss ich mich wirklich durch alle durchklicken?

Nein. Bitte Claude darum oder lass deinen Entwickler die REST-API nutzen. Beide Optionen verknüpfen jeweils bis zu 50 Attribute auf einmal, sodass selbst viele hundert Profile mit einer Handvoll Aufrufe erledigt werden können – nach einem ersten Testlauf.

Ändert das etwas an meinen Kommissionierlisten oder im Lager?

Nein, nicht ohne eine Umbenennung. Lagerbestände und Lagerhistorie bleiben unverändert. Wenn du einen Wert umbenennst – entweder selbst oder mit dem „rename“-Befehl in der API –, erhält die Variante den neuen Namen in den Lagerlisten. Bereits aufgegebene Bestellungen und damit auch deren Kommissionierlisten behalten den Namen, den der Artikel zum Zeitpunkt des Kaufs hatte.

Wann können meine Kunden den Unterschied erkennen?

Sobald die Artikel verknüpft sind, wenn Sie Montana oder MontanaB2B mit eingerichteter Produktfilterung verwenden. Dann zeigt ein Filter für z. B. „Medium“ Produkte aus allen Profilen an. Wenn Sie ein anderes Theme verwenden, sieht der Kunde keinen Unterschied, bis das Theme entsprechend angepasst wurde.

Werden Produkte aus meinem nächsten CSV-Import automatisch übernommen?

Ja, wenn das Attribut bereits geteilte Werte hat und der Wert in der Datei genauso heißt wie ein geteilter Wert. Groß- und Kleinschreibung spielt keine Rolle. Wenn der Wert in der Datei anders geschrieben ist oder nicht als geteilter Wert vorhanden ist, wird er zu einem normalen Wert.

Was passiert, wenn ein Profil sowohl „S“ als auch „Small“ enthält?

Wenn beide auf denselben geteilten Wert verweisen, werden beide verknüpft, aber keiner von beiden wird umbenannt, damit das Profil nicht zwei identische Werte enthält. Die API und Claude zeigen im Testlauf eine Warnung dazu an, damit du das Profil anschließend bereinigen kannst.

Ich bin neu hier und habe die Profile nicht erstellt. Woher weiß ich, welche zusammengehören?

Bitte Claude, Attribute mit demselben Namen über alle Profile hinweg zu suchen und die Werte anzuzeigen, oder frage deinen Entwickler nach einer Liste der Kandidaten. So kannst du sehen, wo es unterschiedliche Schreibweisen gibt, bevor etwas verknüpft wird. Wenn du dir unsicher bist, schreibe an support@shoporama.dk.