Manipulaties

Waarvoor gebruik je Manipulaties?

Met Manipulaties pas je productwaarden aan tijdens het opbouwen van één verkoopkanaal. De oorspronkelijke databron en het opgeslagen Smart Product blijven ongewijzigd. Alleen de tijdelijke uitvoer die daarna naar Mapping gaat, wordt aangepast.

Gebruik manipulaties voor aantoonbare kanaaleisen, bijvoorbeeld:

• HTML uit een beschrijving verwijderen;
• een relatief afbeeldingspad aanvullen met een domein;
• prijzen voor één kanaal verhogen en afronden;
• een voor- of achtervoegsel toevoegen;
• tekst voor een kanaal anders kapitaliseren;
• een extra virtueel uitvoerveld maken.

Corrigeer feitelijk onjuiste productdata bij voorkeur in de bron. Gebruik Slimme velden, normalisatie of centrale verrijking wanneer de verbetering voor meerdere kanalen moet gelden.

Plaats in de uitvoerketen

Nifelo verwerkt een verkoopkanaal in deze volgorde:

1. Selectie kiest databronnen;
2. Regels bepalen welke actieve producten overblijven;
3. Manipulaties maken per product een aangepaste uitvoerkopie;
4. Mapping zet die waarden om naar kanaalvelden;
5. standaardisatie en kanaalvalidatie controleren het resultaat;
6. het bestand of de integratiemutatie wordt opgebouwd.

Een selectieregel kan dus niet filteren op een waarde die pas door een manipulatie ontstaat. Een mapping en preview kunnen de gemanipuleerde waarde wel gebruiken.

Een manipulatieregel opbouwen

Klik op Nieuwe manipulatie en stel drie onderdelen in:

1. een herkenbare naam;
2. nul, één of meerdere voorwaarden;
3. één of meerdere acties.

Gebruik een naam die doel en bereik beschrijft, bijvoorbeeld Google prijs +10% naar .99 of HTML uit beschrijving verwijderen.

Voorwaarden

Voorwaarden bepalen voor welke producten de acties gelden. Binnen één manipulatieregel moeten alle voorwaarden waar zijn: zij werken als EN.

Een regel zonder voorwaarden wordt voor ieder geselecteerd product uitgevoerd. Dit is geschikt voor een algemene kanaaleis, maar heeft een groot bereik. Controleer zo'n regel extra zorgvuldig.

Beschikbare vergelijkingen zijn:

• is gelijk aan (eq) en is niet gelijk aan (neq): exacte tekstvergelijking;
• bevat en bevat niet: zoeken zonder onderscheid tussen hoofdletters en kleine letters;
• is leeg en is niet leeg: beoordelen met de PHP-betekenis van leeg; ook null, een lege tekst, 0 en false kunnen als leeg gelden;
• groter dan en kleiner dan: numerieke vergelijking na omzetting naar een getal.

Gelijk aan is technisch hoofdlettergevoelig. Gebruik Bevat wanneer hoofdletterongevoelig zoeken werkelijk de bedoeling is. Test lege waarden bewust: de waarde 0 kan bij is leeg als leeg worden gezien.

Meerdere regels en volgorde

Manipulatieregels worden van boven naar beneden uitgevoerd. Sleep regels met de handgreep naar de gewenste volgorde. Acties binnen een regel worden eveneens in de getoonde volgorde uitgevoerd.

Latere regels en acties ontvangen het resultaat van eerdere bewerkingen. Daardoor kan een tweede actie voortbouwen op een eerste, maar haar resultaat ook overschrijven.

Voorbeeld:

1. verwijder HTML uit beschrijving;
2. voeg een vaste afsluitende tekst toe.

Omgekeerd zou HTML in de toegevoegde tekst bij stap 2 niet meer worden verwijderd.

Waarde overschrijven

Waarde overschrijven vervangt het gekozen veld volledig door een vaste waarde. Een bestaande productwaarde gaat in deze kanaaluitvoer verloren.

Gebruik dit alleen wanneer dezelfde waarde voor alle producten die aan de voorwaarden voldoen correct is, bijvoorbeeld een vaste conditiecode. Overschrijf geen prijs, voorraad of identificatie met een algemene waarde zonder sluitende voorwaarden.

Tekst vervangen

Tekst vervangen zoekt een exacte tekenreeks in het veld en vervangt alle gevonden voorkomens. De vervanging is hoofdlettergevoelig.

Controleer spaties, leestekens en hoofdletters. Een zoekwaarde Red vervangt niet automatisch red. Een lege zoekwaarde kan onverwachte resultaten geven en moet worden vermeden.

Voorvoegsel en achtervoegsel

Voorvoegsel toevoegen plaatst tekst vóór de bestaande waarde. Achtervoegsel toevoegen plaatst tekst erachter.

Spaties worden niet automatisch toegevoegd. Gebruik dus bewust Merk - in plaats van Merk- wanneer de uitvoer een spatie nodig heeft. Bij een leeg veld bestaat het resultaat alleen uit het voor- of achtervoegsel.

Tekst transformeren

De beschikbare transformaties zijn:

• hoofdletters;
• kleine letters;
• ieder woord met een hoofdletter;
• alleen de eerste letter als hoofdletter en de rest als kleine letters.

Transformaties werken Unicode-bewust, maar kunnen merknamen zoals iPhone, eBay of McLaren ongewenst wijzigen. Sluit uitzonderingen uit met voorwaarden of gebruik een gerichtere vervanging.

Prijs berekenen

Met Prijs berekenen kun je een percentage of vast bedrag optellen of aftrekken:

• +%: percentage verhogen;
• -%: percentage verlagen;
• +: vast bedrag toevoegen;
• -: vast bedrag aftrekken.

Nifelo haalt valuta- en opmaakteken uit de invoer, interpreteert komma's en punten en rekent daarna numeriek. Het resultaat wordt met twee decimalen opgeslagen.

Afronding kan op twee decimalen, een heel getal, .95 of .99. Bij .95 en .99 gebruikt Nifelo het gehele deel en zet de gekozen eindwaarde erachter.

Een prijsmanipulatie voert geen valutaomrekening uit. Default currency bepaalt de valuta-aanduiding, niet de wisselkoers.

Controleer na een prijsactie normale prijs, aanbiedingsprijs, belastingbetekenis, minimumprijs en de eis dat een aanbiedingsprijs lager moet zijn dan de normale prijs. Een aftrekking kan een negatieve of zakelijk ongeldige prijs veroorzaken; Coverage & kwaliteit en Resultaten moeten dit opvangen.

HTML verwijderen

HTML verwijderen verwijdert tags en decodeert HTML-entiteiten. <p>Rood &amp; blauw</p> wordt bijvoorbeeld Rood & blauw.

De actie maakt geen nieuwe alineaopmaak en kan tekst uit verschillende HTML-blokken direct naast elkaar zetten. Controleer lange beschrijvingen daarom in de preview.

Domein toevoegen

Domein toevoegen maakt van een relatief pad een volledige URL. Je kiest protocol en domein; Nifelo verwijdert overtollige schuine strepen tussen domein en pad.

Waarden die al met http://, https:// of // beginnen, blijven ongewijzigd. Lege waarden blijven leeg. Gebruik uitsluitend een vertrouwd domein en controleer of het pad daadwerkelijk naar een publiek bereikbaar bestand leidt.

Virtueel veld maken

Met Virtueel veld maken voeg je tijdens deze uitvoer een extra veld toe. Het veld bestaat niet blijvend in het Smart Product.

De waarde kan:

• een vaste tekst zijn;
• uit een bestaand Smart Field worden gekopieerd;
• bij een gekopieerde numerieke waarde aanvullend worden berekend en afgerond.

Gebruik een stabiele technische veldnaam zonder toevallige campagnetekst. De mapping kan dit virtuele veld daarna aan een doelveld koppelen. Let op volgorde: een actie die het virtuele veld gebruikt moet ná de actie staan die het maakt.

Kanaalwaardemapping

Bestaande systeem- of automatisch voorgestelde manipulaties kunnen een kanaalwaardemapping bevatten. Deze zet specifieke bronwaarden om naar kanaalwaarden, bijvoorbeeld een interne beschikbaarheidswaarde naar de toegestane waarde van het doelplatform.

De matrix vergelijkt getrimde waarden exact. Een lege of null-achtige waarde wordt als [leeg] behandeld. Alleen waarden die als sleutel in de matrix staan worden aangepast; andere waarden blijven bestaan.

Deze actie kan in het overzicht zichtbaar zijn, ook wanneer zij niet als vrije keuze in de gewone actielijst wordt aangeboden.

Bewerken, verwijderen en sorteren

Open een regel met het potlood om naam, voorwaarden en acties te wijzigen. Verwijderen haalt de regel uit toekomstige runs maar draait eerder gepubliceerde data niet terug.

Versleep regels om hun uitvoervolgorde te wijzigen. Controleer na sorteren of de nieuwe volgorde is opgeslagen en test opnieuw. Vooral meerdere prijs-, vervangings- of overschrijfacties kunnen sterk van volgorde afhankelijk zijn.

Preview en testen

Manipulaties wijzigen de producttelling niet: zij veranderen waarden van producten die door Regels al zijn geselecteerd. Gebruik de productpreview bij Mapping en de read-only Shopify-preview om het samengestelde resultaat te bekijken.

Test minimaal:

• een product dat aan alle voorwaarden voldoet;
• een product dat net niet voldoet;
• een product met een leeg veld;
• een variantproduct;
• grenswaarden bij prijzen en getallen;
• een waarde met HTML, accenten of afwijkende hoofdletters.

Shopify

Manipulaties werken vóór de centraal beheerde Shopify-mapping. Ze kunnen daardoor ondersteunde Smart Fields aanpassen voordat Nifelo verschillen en mutaties berekent.

Een manipulatie geeft geen toestemming om een niet-ondersteund of read-only Shopify-doel te schrijven. Het integratiecontract, ownership, preview en validatie blijven leidend. Controleer altijd welke mutaties de Shopify-preview werkelijk wil uitvoeren.

Veelvoorkomende fouten

De manipulatie lijkt niets te doen

Controleer voorwaarden, technische veldnaam, regelvolgorde en preview. Mogelijk is het product al door Selectieregels uitgesloten of overschrijft een latere actie het resultaat.

De manipulatie raakt te veel producten

Een regel zonder voorwaarden geldt voor alles. Voeg sluitende voorwaarden toe en test opnieuw.

Een tekstvervanging mist waarden

Vervangen is hoofdlettergevoelig. Controleer exacte schrijfwijze en verborgen spaties.

De prijs is onverwacht

Controleer bronnotatie, bewerkingsvolgorde, percentage versus vast bedrag en afronding. De manipulatie rekent geen valuta om.

Het virtuele veld is leeg

Controleer of het gekozen Smart Field gevuld is en of het virtuele veld vóór gebruik wordt gemaakt.

Aanbevolen werkwijze

1. Gebruik manipulaties alleen voor kanaalspecifieke uitvoer.
2. Geef iedere regel een duidelijke zakelijke naam.
3. Houd voorwaarden en acties zo klein mogelijk.
4. Maak algemene regels zonder voorwaarden alleen bewust.
5. Plaats regels en acties in een verklaarbare volgorde.
6. Test met representatieve en afwijkende producten.
7. Controleer de preview en daarna Coverage & kwaliteit.
8. Bekijk na uitvoering Resultaten en Logs.
9. Verwijder verouderde regels in plaats van nieuwe uitzonderingen erop te stapelen.