Modifikatorer

Oversigt #

Modifiers giver dig mulighed for at ændre data efter synkronisering, uden at du behøver at røre ved dit datafeed eller involvere en udvikler. Modifiers understøtter i øjeblikket Products, Categories, Customers og Pages.

Modifiers evalueres fra top til bund, så rækkefølgen de vises i på listen har betydning. Eksemplerne nedenfor bruger produktdata, men den samme modifier-funktion kan bruges med de andre understøttede datatyper.

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

AI Modifiers #

AI Modifiers er standard- og anbefalet måde at oprette modifiers på. I stedet for at konfigurere individuelle felter og regler, beskriver du blot, hvad du vil have modifieren til at gøre i almindeligt sprog, og AI genererer en Python-funktion, der transformerer dine produktdata derefter.

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

1. Klik på Add Modifier og vælg AI Modifier som typen (denne er valgt som standard).
2. På modifiersiden, klik på knappen for at åbne Ask-sidebaren.
3. I Ask-sidebaren beskriver du, hvad modifieren skal gøre. Vær så specifik som muligt omkring logikken, de involverede attributter, og det forventede output.
4. AI genererer en Python-funktion baseret på din beskrivelse.
5. Test modifieren ved hjælp af Before & After-forhåndsvisningen, før du gemmer.

Eksempelprompter:

• “Opret en attribut kaldet variant_stock_percentage som viser, hvor mange af et produkts varianter der i øjeblikket 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, afrundet til nærmeste heltal.”

Python-funktionen genereret af AI er skrivebeskyttet — du kan ikke redigere den direkte. For at ændre logikken skal du fortsætte samtalen i Ask-sidebaren og lade den opdatere funktionen. Ask Clerk.io kan undersøge din butik og opsætning før oprettelsen af modifieren, hvilket hjælper den med at forstå konteksten bag din anmodning.

Standard modifier typer #

Til enklere transformationer er standard modifier typer tilgængelige. Disse dækker et sæt foruddefinerede operationer og er nemme at konfigurere, men er mere begrænsede i forhold til hvad de kan gøre sammenlignet med AI Modifiers.

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

Her er en beskrivelse af hver type standard modifier.

Create new attribute #

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

Delete attribute #

Sletter den angivne attribut fra alle produkter, eller kun specifikke ud fra et if-udtryk.

Delete product #

Sletter det angivne produkt/de angivne produkter baseret på et if-udtryk.

Update attribute #

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

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

Et eksempel på regex kunne være []+ med replace_by af ’/’, dette vil tage alle steder i attributten, hvor der er flere / i træk, og erstatte dem med en enkelt /. Så https://test//tests ville blive 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 vil fjerne denne del af URL’en uden at erstatte den med noget andet, lades Replace by-feltet tomt.

Change attribute type #

Muliggør ændring af datatyper i en attribut. Så hvis dataen er et tal og du skal bruge en streng, kan du bruge dette til at typecaste det. Attribut typerne er: string,int,float og boolean.

Split attribute #

Mulighed for at opdele en streng via en separator til en liste af strenge. Standard separatoren er komma, hvis ingen separator er angivet.

Eksempel #

Her deler vi en attribut med kategorier, så den bliver til en liste: "lineman, chute" til ["lineman","chute"].

Append value #

Giver mulighed for at tilføje nye værdier til en eksisterende listeattribut.

Dette kan være tilføjelse af yderligere strenge til en tags-attribut, eller tilføjelse af en ny kategori til en categories-attribut.

Evaluate an expression #

Expression-handlingen evaluerer et matematisk udtryk, som kan inkludere attributter, konstanter og operatorer. Så hvis du definerer dette udtryk: price * 0.8 vil systemet beregne resultatet ved at gange værdien af price-attributten med 0,8 og dermed give 20% rabat.

Eksempel #

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

New formatted attribute #

Denne handling opretter en ny attribut baseret på eksisterende data, mens den anvender formatéringer eller transformationer på dens værdi.

For at referere til en eksisterende attribut, omkrans dens navn med krøllede parenteser uden mellemrum: {attributeName}.

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

Hvis du inkluderer mellemrum indeni parenteserne, som { attribute }, gemmer systemet den bogstavelige streng (inklusiv parenteser), ikke attributværdien.

Eksempel #

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

If-udsagn #

Hvis du tilføjer et udtryk i if-feltet, vil kommandoen kun køre på attributter, hvor det pågældende udtryk evalueres til sandt.

Tilgængelige operatorer er:

Eksempel #

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

Oprettelse af attributter fra lister #

En typisk brugssituation er at oprette en separat attribut baseret på værdier i en eksisterende liste-attribut. For eksempel, hvis du har en tags-attribut, som indeholder 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 eksisterer i en liste. Syntaksen er:

"value" in attribute_name

For at oprette en gender-attribut fra tags skal du opsætte flere modifiers i rækkefølge:

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

Bemærk: Værdien du tjekker efter skal skrives i anførselstegn (f.eks. "Female"), mens attributnavnet skrives uden anførselstegn (f.eks. tags).

Kombinering af betingelser #

Du kan kombinere flere betingelser ved at bruge and og or operatorerne.

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

brand == "Nike" and stock > 0

Matcher produkter hvor category indeholder shoes ELLER boots:

"shoes" in categories or "boots" in categories

Matcher 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 at teste din nye modifier først. 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 ved hjælp af Before & After-visualiseringen.

Du kan inkludere eller ekskludere individuelle modifiers fra forhåndsvisningen. Brug Include in preview-afkrydsningsfeltet på hver modifier for midlertidigt at fjerne den fra forhåndsvisningen, når du tester et produkt. Dette valg påvirker kun forhåndsvisningen og ikke den aktive modifier — alle modifiers bliver anvendt, når du klikker på Save & Run.