Modifikatorer

Oversigt #

Modifiers lader dig ændre produktdata efter synkronisering, uden at du behøver at ændre dit datafeed eller involvere en udvikler. Modifiers bliver evalueret fra top til bund, så rækkefølgen i listen har betydning.

Der er to måder at oprette en modifier på: ved at bruge AI Modifiers, som er den anbefalede tilgang, eller ved at vælge en af de standard modifier typer til enklere, foruddefinerede transformationer.

AI Modifiers #

AI Modifiers er den standard og anbefalede måde at oprette modifiers på. I stedet for at konfigurere individuelle felter og regler, beskriver du blot på almindeligt sprog, hvad din modifier skal gøre, og AI’en genererer en Python-funktion, som transformer dine produktdata tilsvarende.

Denne tilgang er langt mere fleksibel end de standard modifier typer. Du kan beskrive komplekse logikker, kombinere flere betingelser, beregne nye værdier ud fra eksisterende attributter og håndtere edge cases — alt sammen uden at skulle skrive kode selv.

1. Klik på Add Modifier og vælg AI Modifier som type (denne er valgt som standard).
2. I tekstfeltet beskriver du, hvad modifieren skal gøre. Vær så specifik som muligt angående logikken, de involverede attributter og det forventede output.
3. AI’en genererer en Python-funktion baseret på din beskrivelse.
4. Test modifieren ved brug af Before & After forhåndsvisning før du gemmer.

Eksempelprompter:

• “Opret en attribut kaldet variant_stock_percentage der viser, hvor mange af et produkts varianter der aktuelt er på lager, som en procentdel mellem 0 og 100.”
• “Sæt availability til In stock hvis stock er større end 0, ellers sæt den til Out of stock.”
• “Opret en discount_percentage attribut ved at beregne procentforskellen mellem list_price og price, rundet op til nærmeste hele tal.”

Python-funktionen genereret af AI’en er skrivebeskyttet — du kan ikke redigere den direkte. For at ændre logikken skal du blot chatte med AI’en i tekstfeltet og lade den opdatere funktionen. Dette sikrer, at funktionen altid matcher din beskrevne hensigt.

Standard modifier typer #

Hvis du kun har brug for enklere transformationer, er standard modifier typer tilgængelige. Disse dækker et sæt af foruddefinerede handlinger og er nemme at sætte op, men er mere begrænsede i, hvad de kan, sammenlignet med AI Modifiers.

Alle standard modifiers har et if-inputfelt. Hvis der tilføjes et statement, kører modifieren kun på produkter hvor statementet evalueres til sandt.

Her er en beskrivelse af hver standard modifier type.

Create new attribute #

Tager en new_value, der angiver hvilken værdi attributten skal sættes til; kan bruges både som en ny attribut eller ovenpå en eksisterende for at erstatte den.

Delete attribute #

Sletter den angivne attribut fra alle produkter, eller specifikke, baseret på et if-statement.

Delete product #

Sletter de angivne produkter baseret på et if-statement.

Update attribute #

Denne modifier bruger regex med Python biblioteket. Hvis regex er nyt for dig, så overvej at bruge AI Modifiers i stedet — de kan håndtere samme transformationer uden viden om regex.

Update tager attributten regexp, som er et regex-udtryk, der matcher på dele af attributten og erstatter hver fundet gruppe med indholdet af replace_by. Her er et nyttigt værktøj til at oprette dit regex.

Et eksempel på regex kunne være []+ med en replace_by på ’/’, dette vil tage alle steder i attributten hvor der er flere / i træk og erstatte dem med enkelt /. Så https://test//tests bliver til https:/test/tests.

Eksempel #

I dette eksempel vil vi fjerne den sidste del af en URL ved hjælp af et regex-mønster. Den oprindelige URL er: https://example.domain/product/153//__example. For at fjerne //__example-delen kan vi bruge følgende regex: \/\/__example.

Da vi blot ønsker at fjerne denne del af URL’en uden at erstatte med noget andet, efterlades Replace by-feltet tomt.

Change attribute type #

Muliggør ændring af typen på en attribut. Hvis dataen for eksempel er et tal, og du har brug for det som en streng, kan dette bruges til at typecaste. Typerne af attributter er: string, int, float og boolean.

Split attribute #

Muliggør opdeling af en streng efter et separator-tegn, til en liste af strenge. Hvis der ikke angives en separator, deles der som udgangspunkt på komma.

Eksempel #

Her opdeles en attribut med kategorier, som bliver til en liste: "lineman, chute" til ["lineman","chute"].

Append value #

Muliggør tilføjelse af nye værdier til en eksisterende liste-attribut.

Dette kunne være at tilføje flere strenge til en tags attribut, eller tilføje en ny kategori til en categories attribut.

Evaluate an expression #

Udtryks-handlingen evaluerer et matematisk udtryk, som kan indeholde attributter, konstanter og operatorer. Så, hvis du definerer dette udtryk: price * 0.8 vil systemet beregne resultatet ved at gange værdien i pris-attributten med 0,8, hvilket svarer til 20% rabat.

Eksempel #

Hvis du skriver i New Value-feltet: price * 0.8 og prisen er 100, så vil resultatet blive 80.

New formatted attribute #

Denne handling opretter en ny attribut baseret på eksisterende data, mens den anvender formatering eller transformation på værdien.

For at referere til en eksisterende attribut, skal du indramme dens navn i krøllede parenteser uden mellemrum: {attributeName}.

• Kopier en attribut: sæt New Value til {MPN}.
• Sammenkæd tekst og attributter: € + {price}.

Hvis du tilføjer mellemrum inde i parenteserne, som { attribute }, vil systemet gemme bogstaveligt det skrevne (inkl. parenteser) og ikke attributværdien.

Eksempel #

Du kan kombinere attributter, tilføje præfikser eller suffikser eller ændre, hvordan dataen fremstår. For eksempel, for at lave en formateret pris som €100,00, sæt New Value til: € + {price}.

If Statements #

Hvis du tilføjer et statement i if-feltet, vil kommandoen kun blive kørt på attributter, hvor statementet evalueres til sandt.

Tilgængelige operatorer er:

Eksempel #

Opret en ny attribut Availability sat til Available, If stock > 0.

Opret attributter ud fra lister #

Et almindeligt tilfælde er at oprette en separat attribut ud fra værdier i en eksisterende liste-attribut. Hvis du for eksempel har en tags attribut med værdier som Female, Male og Unisex, kan du oprette en dedikeret gender attribut til brug i Search-facetter.

in-operatoren tjekker om en værdi findes indenfor en liste. Syntaksen er:

"value" in attribute_name

For at oprette en gender attribut ud fra tags, opsæt flere modifiers i træk:

Hver modifier kører kun når dens betingelse er opfyldt. Rækkefølgen har betydning - hvis et produkt har flere matchende tags, er det den sidste matchende modifier, der bestemmer den endelige værdi.

Bemærk: Den værdi du tjekker for skal være i anførselstegn (f.eks. "Female"), mens attributnavnet skrives uden anførselstegn (f.eks. tags).

Kombinering af betingelser #

Du kan kombinere flere betingelser ved brug af and og or operatorer.

Match produkter hvor brand er Nike OG stock er større end 0:

brand == "Nike" and stock > 0

Match produkter hvor category indeholder shoes ELLER boots:

"shoes" in categories or "boots" in categories

Match produkter med et specifikt tag OG pris over 100:

"premium" in tags and price > 100

Test & Gem #

Før du klikker på Save & Run, som anvender modifiers på hele dit katalog, er det god praksis først at teste din nye modifier. Dette kan du gøre i sektionen See how your modifiers impact your product data.

Her kan du vælge et produkt og se, hvordan det påvirkes af modifieren gennem Before & After visualisering.

Du kan inkludere eller ekskludere individuelle modifiers fra forhåndsvisningen. Brug Include in preview afkrydsningsfeltet på den enkelte modifier for midlertidigt at fjerne den fra preview-beregningen under testning. Dette valg påvirker kun preview og ikke den endelige modifier — alle modifiers anvendes, når du klikker Save & Run.