Modifikatorer

Oversigt #

Modifikatorer giver dig mulighed for at ændre data efter synkronisering uden at røre ved dit datafeed eller involvere en udvikler. Modifikatorer understøtter i øjeblikket Produkter, Kategorier, Kunder og Sider.

Modifikatorer evalueres fra top til bund, så rækkefølgen i listen er vigtig. Eksemplerne nedenfor bruger produktdata, men den samme modifikatorfunktion kan bruges med de andre understøttede datatyper.

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

Modifikatordre #

Angiv rækkefølgen, når en modifikator er afhængig af en ændring foretaget af en anden. Clerk.io evaluerer listen fra top til bund.

I Data > Modifiers, tag fat i en modifikators prikkede håndtag og træk den til den ønskede position. En stiplet boks viser, hvor den lander. Slip rækken for at flytte den.

Du kan også fokusere på en modifikatorrække og trykke på Alt + ↑ eller Alt + ↓ for at flytte den med tastaturet. Skærmlæsere annoncerer flytningen.

Test rækkefølgen i Før & Efter forhåndsvisningen før du klikker på Save & Run for at anvende den på dit katalog.

AI Modifiers #

AI Modifiers er standard- og anbefalet metode til at oprette modifikatorer. I stedet for at konfigurere individuelle felter og regler beskriver du blot, hvad du vil have, modifikatoren skal gøre, med almindeligt sprog, og AI’en genererer en Python-funktion, der transformerer dine produktdata i overensstemmelse hermed.

Denne tilgang er langt mere fleksibel end standardmodifikatortyper. Du kan beskrive kompleks logik, kombinere flere betingelser, beregne nye værdier ud fra eksisterende attributter og håndtere edge cases — alt sammen uden at skrive kode selv.

1. Klik på Add Modifier og vælg AI Modifier som type (denne er valgt som standard).
2. På modifikatorsiden skal du klikke på knappen for at åbne Ask sidebaren.
3. I Ask sidebaren beskriver du, hvad modifikatoren skal gøre. Vær så specifik som muligt omkring logik, involverede attributter og forventet output.
4. AI’en genererer en Python-funktion baseret på din beskrivelse.
5. Test modifikatoren i Før & Efter forhåndsvisningen, før du gemmer.

Eksempel-prompts:

• “Opret en attribut kaldet variant_stock_percentage, der viser hvor mange af et produkts varianter der aktuelt er på lager, som en procent 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 forskellen i procent mellem list_price og price, afrundet til nærmeste heltal.”

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

Standardmodifikatortyper #

Til enklere transformationer er standardmodifikatortyper tilgængelige. Disse dækker et sæt foruddefinerede handlinger og er nemme at konfigurere, men er mere begrænsede i forhold til AI Modifiers.

Alle standardmodifikatorer har et if-indtastningsfelt. Tilføjes et udtryk her, køres modifikatoren kun på produkter, hvor udtrykket evalueres til sandt.

Her er en beskrivelse af hver standardmodifikatortype.

Create new attribute #

Tager en new_value, som angiver, hvilken værdi attributten skal have. Kan bruges både som en ny attribut eller oven på en eksisterende for at erstatte den.

Delete attribute #

Sletter den angivne attribut fra alle produkter eller bestemte produkter baseret på et if-udtryk.

Delete product #

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

Update attribute #

Denne modifikator 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 nogen regex-viden.

Update bruger attributten regexp, som er et regex-udtryk, der matcher på dele af attributten og erstatter hver matchet gruppe med indholdet af replace_by. Her er et hjælpeværktøj til dine regex-udtryk.

Et eksempel på et regex-mønster kan være []+ med en replace_by af ’/’, hvilket vil tage alle steder i attributten, hvor der er flere / lige efter hinanden og erstatte dem med enkelt /. Så https://test//tests bliver til https:/test/tests.

Eksempel #

I dette eksempel ønsker vi at 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 den med andet, efterlades Replace by feltet tomt.

Change attribute type #

Gør det muligt at ændre typen på en attribut. Hvis dataflet er et tal, og du har brug for det som en streng, kan du typecaste det her. Attributtyperne er: string,int,float og boolean.

Split attribute #

Muliggør opdeling af en streng med en separator til en liste af strenge. Som standard deles ved komma, hvis ingen separator er angivet.

Eksempel #

Her deler vi en attribut med kategorier, der 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 kunne være at tilføje ekstra strenge til en tags attribut, eller føje en ny kategori til en categories attribut.

Evaluate an expression #

Expression-handlingen evaluerer et matematisk udtryk, som kan indeholde attributter, konstanter og operatorer. Hvis du fx definerer dette udtryk: price * 0.8 vil systemet beregne resultatet ved at gange værdien af prisattributten med 0.8, hvilket svarer til 20% rabat.

Eksempel #

Indtaster du i New Value-feltet: price * 0.8 og prisen er 100, bliver resultatet 80.

New formatted attribute #

Denne handling opretter en ny attribut baseret på eksisterende data, mens der formateres eller transformeres på værdien.

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

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

Hvis du inkluderer mellemrum inde i parenteserne, som { attribute }, gemmer systemet strengen bogstaveligt (inklusive parenteserne) og ikke attributværdien.

Eksempel #

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

If-udtryk #

Hvis du tilføjer et udtryk i if-feltet, udføres kommandoen kun på attributter, hvor udtrykket evalueres til sandt.

Tilgængelige operatorer er:

Eksempel #

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

Oprettelse af attributter ud fra lister #

Et almindeligt scenarie er at oprette en separat attribut baseret på værdier fra en eksisterende listeattribut. Hvis du fx har en tags-attribut med værdier som Female, Male og Unisex, kan du oprette en dedikeret gender attribut til brug i Search-facetter.

Operatoren in tester, om en værdi findes i en liste. Syntaksen er:

"value" in attribute_name

For at oprette en gender-attribut ud fra tags, opsæt flere modifikatorer i rækkefølge:

Hver modifikator køres kun, når dens betingelse er sand. Rækkefølgen er vigtig – hvis et produkt har flere matchende tags, bestemmer den sidste matchende modifikator den endelige værdi.

Bemærk: Værdien, du tjekker for, skal være omsluttet af anførselstegn (fx "Female"), mens attributnavnet skrives uden anførselstegn (fx tags).

Kombination af betingelser #

Du kan kombinere flere betingelser ved hjælp af and og or operatorer.

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

brand == "Nike" and stock > 0

Match produkter hvis category inkluderer shoes ELLER boots:

"shoes" in categories or "boots" in categories

Match produkter med et bestemt tag OG pris over 100:

"premium" in tags and price > 100

Test & Gem #

Før du klikker på Save & Run, som anvender modifikatorerne på hele dit katalog, er det god praksis at teste din nye modifikator først. Det kan du gøre i sektionen Se hvordan dine modifikatorer påvirker dine produktdata.

Her kan du vælge et produkt og se, hvordan det påvirkes af modifikatoren ved hjælp af visualisering før og efter.

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