Flytt profilene dine over til delte verdier

Hvis du har mange produktprofiler, har du sikkert også den samme størrelsen eller fargen i dem alle. «Medium» i T-skjorte-profilen, «Medium» i bukse-profilen og kanskje «M» i en tredje. Med delte verdier blir de til den samme verdien, slik at du og kundene dine kan finne alt i Medium på tvers av profilene. Denne artikkelen viser hvordan du flytter over eksisterende profiler, uansett om du har fem eller 600 profiler.

Det er tre måter å gjøre dette på. Velg den som passer best for deg:

• Metode A, i admin: for deg med få profiler. Du klikker deg gjennom profilene én om gangen.
• Metode B, via REST API: for utviklere eller integratorer når det er mange profiler.
• Metode C, med Claude: for deg som har mange profiler og heller vil skrive på vanlig dansk enn å programmere.

Er du i tvil om hva en delt verdi er, så start med hovedartikkelen «Delte verdier » eller den korte forklaringen i ordboken.

Før du setter i gang

Hva endres, og hva endres ikke?

Når du kobler en profilverdi til en delt verdi, legger du bare til en kobling. Profilens verdi forblir som den er. Det betyr:

• Produktene, variantene, lagertallene, prisene og ordrene endres ikke.
• Kunder som har varer i handlekurven, merker ingenting.
• Alt kan angres. Hvis du fjerner koblingen igjen, blir profilverdien stående som en vanlig verdi.

Navn endres kun når du selv ber om det: når du omdøper en verdi før du kobler den, når en utvikler bruker innstillingen for å rette stavemåten (se spor B), eller når du senere omdøper en delt verdi. Da får alle koblede verdier det nye navnet, også de som tidligere var stavet annerledes. Bestillinger beholder alltid det navnet varen hadde da den ble kjøpt.

Planlegg navnene først

Bruk fem minutter på å skrive ned hvilke delte verdier du vil ha. Det er navnene kunden ser når de filtrerer. Noen gode råd:

• Velg én skrivemåte. Skal det hete «M» eller «Medium»? Bestem deg, og bruk den samme overalt.
• Hold forskjellige ting adskilt. Hvis to verdier betyr noe forskjellig, så opprett to separate verdier. En M for voksne og en M for barn er ikke samme størrelse, så opprett for eksempel «M» og «M (barn)».
• Koble kun attributter som betyr det samme. «Nei» i attributtet «Vanntett» er ikke det samme som «Nei» i attributtet «Økologisk». Hvis du kobler dem sammen, vil kunden se begge typer produkter når de filtrerer på «Nei».
• Store og små bokstaver spiller ingen rolle. «medium» og «Medium» regnes som samme navn.

Delte verdier fungerer kun på attributter av typen «Liste over verdier», som du selv fyller ut. Felter som kunden skriver i, kan ikke deles.

Spor A: i admin (få profiler)

Denne metoden passer når du har en håndfull profiler. Bilder av alle skjermbildene finner du i hovedartikkelen Delte verdier.

1. Opprett de delte verdiene

1. Gå til Nettbutikk → Produktprofiler.
2. Klikk på knappen Delte verdier øverst til høyre.
3. Skriv inn navnet i feltet «Legg til verdi her» og trykk Enter. Du kan opprette flere samtidig ved å skille dem med semikolon, f.eks. Small;Medium;Large.
4. Dra verdiene i den rekkefølgen du vil at de skal vises.

2. Gjør profilens verdier delte

1. Åpne en profil under Nettbutikk → Produktprofiler.
2. Finn attributtet, f.eks. Størrelse, og klikk i feltet Verdier.
3. Skriv inn navnet på en verdi som profilen allerede har, f.eks. «Medium».
4. Det vises en liste med forslag. Ved siden av den delte verdien står det «Gjør verdien din delt». Velg den med musen eller med piltastene og Enter.
5. Profilens eksisterende verdi får nå et lenkeikon. Det opprettes ikke en ny verdi, og varianter, lagerbeholdning og priser forblir som før.
6. Gjenta dette for hver verdi. Koblingen lagres umiddelbart.

Hvis det står «finnes allerede » ved siden av forslaget, er verdien allerede delt i denne profilen, og du kan hoppe over den.

Hvis profilen staver verdien annerledes

Hvis verdien heter «M» i profilen, men «Medium» blant dine delte verdier, må du først gi den et nytt navn:

1. Klikk på blyanten ved siden av «M» i profilen, og end navnet til «Medium».
2. Skriv «Medium» i feltet Verdier, og velg forslaget for å dele verdien din.

Hvis attributtet allerede har andre delte verdier, blir verdien koblet til så snart du omdøper den. Du kan se dette på lenkeikonet, og i forslagslisten står det «finnes allerede». Da er du ferdig med denne verdien og kan hoppe over trinn 2. Hvis attributtet ennå ikke har noen delte verdier, skjer koblingen først når du velger forslaget i trinn 2.

Å gi en variantverdi nytt navn endrer bare navnet. Lagernummer og lagerhistorikk beholdes.

Spor B: via REST API (mange profiler)

REST-API-et har tre endepunkter for flyttingen: finn kandidatene, koble dem sammen, og fjern koblingen igjen hvis du ombestemmer deg. Alle forespørsler bruker API-nøkkelen din som rå nøkkel i «Authorization»-overskriften, uten «Bearer» foran. POST-forespørsler må ha «Content-Type: application/json». Se «Finn eller opprett en API-nøkkel». I eksemplene står DIN_TOKEN i stedet for nøkkelen.

1. Opprett de delte verdiene

Opprett navnene som skal vises i nettbutikken. Hvis en verdi allerede finnes, returneres den eksisterende i stedet for en kopi.

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 kan også hoppe over dette trinnet og la link-kallet opprette de manglende verdiene (se create_missing nedenfor). Da blir imidlertid navnene de som profilene tilfeldigvis bruker.

2. Finn kandidatene

Kallet finner listeattributter med samme navn i flere profiler, f.eks. Størrelse i 40 profiler. Du får attributtenes ID-er, alle verdier med antall, stavemåter som kun skiller seg på store og små bokstaver (f.eks. «s» og «S»), og hvilken delt verdi hver verdi allerede samsvarer med. Ulike navn på samme størrelse, f.eks. «S» og «Small», vises som to verdier. Disse samler du ved hjelp av mapping i neste trinn.

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

Utdrag av svaret:

{
    "candidates": [
        {
            "name": "Størrelse",
            "attribute_count": 3,
            "profile_count": 3,
            "attributes": [
                {
                    "attribute_id": 3667,
                    "name": "Størrelse",
                    "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
}

Bruk min_attributes (standard 2) for å kun vise navn som går igjen i minst like mange attributter. Gå gjennom listen og velg kun de attributtene som betyr det samme.

3. Test koblingen

Koblingsanropet kobler hver verdi i attributtene til den delte verdien med samme navn. Det kjører som en testkjøring, med mindre du sender «dry_run»: false, slik at ingenting lagres i første omgang.

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
  }'

Feltene i anropet:

• attribute_ids: attributtene fra trinn 2. Maksimalt 50 per anrop. Hvis du har flere, må du dele opp listen og foreta flere anrop.
• mapping: oversetter stavemåten til profilene til den delte verdien, f.eks. {"S": "Small"}. Store og små bokstaver spiller ingen rolle. Verdier uten mapping matches på sitt eget navn.
• create_missing: standardverdien «true» oppretter delte verdier for navn som ikke finnes ennå. Med «false» brukes bare de delte verdiene du allerede har, og resten står som «unmatched».
• rename: standardinnstillingen er false, slik at profilene beholder sin egen skrivemåte («S» forblir, men er koblet til «Small»). Med true blir profilverdiene også omdøpt, slik at de får samme navn som den delte verdien. Dette påvirker variantnavnene i lagerlistene, men ikke gamle ordrer.
• dry_run: standard true.

4. Les svaret

Svaret viser for hvert attributt og hver verdi hva som vil skje. Her forkortet til ett attributt:

{
    "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": "Størrelse",
            "profile_id": 2939,
            "profile_name": "Gensere",
            "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: ingenting ble endret. Kall igjen med dry_run=false for å bruke endringene."
    ]
}

Sjekk spesielt disse feltene:

• action per verdi: link (kobles), already_linked (allerede koblet), unmatched (ingen delt verdi, og create_missing er slått av), eller skipped_empty (tom verdi, hoppes over).
• created_shared_values: de delte verdiene som blir opprettet. Hvis det står navn der du ikke hadde regnet med, så legg dem til i mapping.
• warnings: attributter der to verdier ender på den samme delte verdien, f.eks. både «S» og «Small». Begge kobles sammen, men ingen av dem omdøpes, slik at attributten ikke får to identiske verdier.
• errors: f.eks. et attributt som ikke finnes, ikke er en liste, tilhører en slettet profil eller omfatter mer enn 50 attributter. Da svarer API-et med 400, og ingenting lagres.

5. Kjør koblingen

Hvis testkjøringen ser riktig ut, sender du nøyaktig det samme anropet med «dry_run»: false. Svaret har samme oppbygning. Anropet kan trygt kjøres igjen: verdier som allerede er koblet sammen, vises som «already_linked».

6. Sjekk resultatet

Hent de delte verdiene med GET /attribute-shared-value. Feltet linked_count viser hvor mange profilverdier som bruker hver verdi. Hent deretter produktene med en delt verdi på tvers av profilene:

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

| betyr «eller», og komma betyr «og»: attribute_shared_value_id=2|3,5 er (Medium eller Large) og den delte verdien med id 5. Legg til in_stock=1 for å bare få varianter som er på lager. Du kan også legge til is_online=1. De øvrige listefiltrene på produktlisten, f.eks. search, category_id og profile_id, kan ikke kombineres med dette.

7. Opphev koblingen med unlink

Unlink fjerner koblingen for alle verdier i de angitte attributtene. Profilverdiene og de delte verdiene forblir. I likhet med link er unlink en testkjøring, med mindre du sender «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": []
}

Også her er grensen 50 attributter per kall. Hvis du har brukt rename, vil det nye navnet forbli etter unlink. Hele API-et er beskrevet i REST API-dokumentasjonen under «Shared Values».

Spor C: med Claude

Hvis du har koblet Claude til nettbutikken din (se «Styr butikken med AI»), kan Claude ta seg av hele flyttingen for deg. Du skriver hva du vil, og Claude finner attributtene, viser deg resultatet og kobler dem sammen når du godkjenner det.

Eksempler på hva du kan skrive

• «Finn alle attributter som heter Størrelse på tvers av profilene mine, og vis meg hva som skjer hvis du kobler dem til de delte verdiene Small, Medium og Large.»
• «Opprett de delte verdiene XS, Small, Medium, Large og XL, og koble alle størrelsene mine til dem. Der profilen angir S, M eller L, skal de kobles til Small, Medium og Large.»
• «Hvilke stavemåter for fargene har jeg i profilene mine? Foreslå hvilke delte verdier jeg bør opprette.»
• «Fjern koblingen til de delte verdiene i profilen Barneklær.»

Slik fungerer Claude

Claude bruker de samme funksjonene som REST-API-et. For utviklere som ønsker å følge med i revisjonsloggen, heter verktøyene:

• attribute_shared_value_candidates (Finn identiske attributtverdier): finner attributter med samme navn i flere profiler.
• attribute_shared_value_link (Koble verdier til delte verdier): kobler verdiene sammen, maksimalt 50 attributter om gangen.
• attribute_shared_value_unlink (Fjern kobling til delte verdier): opphever koblingen.
• I tillegg finnes attribute_shared_value_list og attribute_shared_value_create for å vise og opprette de delte verdiene.

Claude har fått beskjed om alltid å foreta en testkjøring først og vise deg hva som vil bli koblet sammen, hvilke delte verdier som opprettes og eventuelle advarsler. Først når du har sagt ja, kobler Claude sammen for alvor. Hvis du har mange profiler, deler Claude selv arbeidet opp i grupper på 50.

Hvis du har aktivert «Ekstra sikkerhet», må du godkjenne tilkoblingen og fjerning av tilkoblinger i admin før de utføres. Det samme gjelder hvis Claude skal slette en delt verdi. Testkjøringen endrer ingenting og utføres derfor uten godkjenning.

Etter flyttingen

• Nye verdier kobles automatisk. Når et attributt har delte verdier, kobles en ny verdi med samme navn som en delt verdi automatisk. Dette gjelder også når du importerer produkter via CSV, eller når en integrasjon oppretter verdier. Attributter uten delte verdier påvirkes ikke, og det opprettes aldri nye delte verdier av seg selv.
• Navnet er låst i profilen. En delt verdi har samme navn i alle profiler, så hvis du endrer navnet under «Delte verdier», gjelder endringen for alle profiler. Hvis en profil skal ha sitt eget navn, klikker du på blyanten og velger «Gjør til vanlig verdi».
• Filtrering i nettbutikken. I temaene Montana og MontanaB2B slår produktfilteret sammen de koblede verdiene under navnet på den delte verdien. Hvis kunden filtrerer på «Medium», vises produkter fra alle profiler. Dette forutsetter at filteret er konfigurert under «Design» → «Filter». Se artikkelen om produktfiltrering. Andre temaer viser ingen forskjell for kunden.

Slik angir du

• Én verdi i én profil: Klikk på blyanten ved siden av verdien i profilen, og velg «Gjør til vanlig verdi».
• En hel delt verdi: Slett den på siden «Delte verdier » ved å klikke på krysset. Profilene beholder verdien, den er bare ikke delt lenger.
• Mange attributter på en gang: bruk «unlink» i REST-API-et, eller be Claude om å fjerne koblingen.

I alle tilfeller forblir profilverdiene som vanlige verdier. Hvis du har omdøpt verdier underveis, beholder de det nye navnet.

Ofte stilte spørsmål

Kan jeg ødelegge produktene mine når jeg gjør dette?

Nei. Koblingen er et ekstra lag på toppen av profilene dine. Produkter, varianter, lagertall, priser og bestillinger blir ikke berørt, og du kan alltid fjerne koblingen igjen. Det eneste du må passe på, er å ikke slette verdier underveis.

Hvordan kan jeg se om en verdi allerede er delt?

I profilen har en delt verdi et lenkeikon. På siden «Delte verdier» står det et tall ved hver verdi som viser hvor mange profilverdier som bruker den. Hvis tallet er 0, er det ikke koblet til noe ennå.

Jeg har over 400 profiler. Må jeg virkelig klikke meg gjennom dem alle?

Nei. Be Claude om det, eller få utvikleren din til å bruke REST-API-et. Begge deler kobler opptil 50 attributter per gang, så selv mange hundre profiler kan håndteres med en håndfull forespørsler, med en testkjøring først.

Endrer dette noe på plukk-listene mine eller i lageret?

Nei, ikke uten en omdøping. Lagernummer og lagerhistorikk forblir de samme. Hvis du omdøper en vare, enten selv eller ved hjelp av «rename» i API-et, får varianten det nye navnet i lagerlistene. Bestillinger som allerede er lagt inn, og dermed også plukklistene deres, beholder det navnet varen hadde da den ble kjøpt.

Når vil kundene mine merke forskjellen?

Så snart varene er koblet sammen, hvis du bruker Montana eller MontanaB2B med produktfiltrering konfigurert. Da viser et filter på for eksempel «Medium» produkter fra alle profiler. Bruker du et annet tema, ser kunden ingen forskjell før temaet er tilpasset dette.

Blir produktene fra min neste CSV-import automatisk inkludert?

Ja, hvis attributtet allerede har delte verdier, og verdien i filen har samme navn som en delt verdi. Store og små bokstaver spiller ingen rolle. Hvis filen staver verdien annerledes, eller hvis den ikke finnes som en delt verdi, blir den en vanlig verdi.

Hva skjer hvis en profil har både «S» og «Small»?

Hvis begge peker på den samme delte verdien, blir begge koblet sammen, men ingen av dem blir omdøpt, slik at profilen ikke ender opp med to like verdier. API-et og Claude viser en advarsel om dette i testkjøringen, slik at du kan rydde opp i profilen etterpå.

Jeg er ny og har ikke opprettet profilene. Hvordan vet jeg hvilke som hører sammen?

Be Claude om å finne attributter med samme navn på tvers av profilene og vise verdiene, eller spør utvikleren din om en liste over kandidatene. Da kan du se hvor det er forskjellige stavemåter før noe kobles sammen. Er du i tvil, så skriv til support@shoporama.dk.