Slimme velden

Koppel verschillende bronvelden aan één vaste productstructuur die Nifelo gebruikt voor import, AI, validatie en export.

Wat zijn Slimme velden?

Iedere databron gebruikt eigen veldnamen. De ene bron noemt een producttitel bijvoorbeeld title, een andere gebruikt name of product_name. Met Slimme velden koppelt Nifelo deze verschillende bronvelden aan één vaste interne productstructuur.

Voorbeelden van Slimme velden zijn titel, beschrijving, merk, SKU, EAN/barcode, prijs, voorraad, afbeelding en producttype.

Door deze koppeling weet Nifelo wat ieder veld betekent. Dezelfde gestandaardiseerde productdata kan daarna worden gebruikt voor:

productimport en productoverzicht;
categorisatie en AI-verrijking;
normalisatie en datavalidatie;
regels en aanvullende bewerkingen;
exports naar verkoopkanalen.

Deze handleiding beschrijft de algemene werking van Slimme velden. Dezelfde centrale uitleg kan vanuit meerdere plaatsen in het databronnenmenu worden geopend. Zo blijft de basis op één plek onderhouden en krijg je altijd dezelfde uitleg over de vaste productstructuur van Nifelo.

De precieze koppeling kan per type databron verschillen. Open daarom na deze algemene uitleg ook Slimme velden onder het brontype dat je gebruikt. Wanneer daar een eigen handleiding beschikbaar is, vind je er de aanvullende of afwijkende werkwijze voor die bron. Volg bij verschillen de bronspecifieke handleiding.

Automatische of handmatige koppeling

Hoeveel je zelf moet instellen, hangt af van het type databron.

Bestand-, feed- en niet-beheerde webshopbronnen

Bij een bestand, feed of niet-beheerde webshopbron kunnen veldnamen en structuren per leverancier verschillen. Nifelo detecteert de beschikbare bronvelden, waarna je controleert aan welk Slim veld ieder bronveld gekoppeld moet worden.

Gebruik waar beschikbaar Auto-Map om een eerste voorstel te laten maken. Controleer die voorstellen altijd voordat je ze opslaat.

Een technisch geldige koppeling is niet automatisch inhoudelijk juist. Controleer bijvoorbeeld dat een verkoopprijs niet aan een inkoopprijs wordt gekoppeld en dat EAN/barcode geen intern product-ID bevat.

Status en voortgang

Bovenaan zie je hoeveel bronvelden gekoppeld zijn en of verplichte Slimme velden ontbreken.

Ontbrekende verplichte velden: minimaal vereiste productinformatie is nog niet gekoppeld.
Niet-gekoppelde bronvelden: de bron bevat velden die nog niet worden gebruikt.
Voortgang: toont welk deel van de gedetecteerde velden verwerkt is.

Niet ieder bronveld hoeft een eigen Slim veld te krijgen. Sla technische of irrelevante velden over wanneer ze niet nodig zijn voor producten, AI, validatie of export.

Een koppeling lezen

Iedere koppelingsregel heeft minimaal een doel en een bron:

Doel: het gestandaardiseerde Slimme veld binnen Nifelo, bijvoorbeeld title, brand of price.
Bron: het veld uit de aangeleverde webshop, feed of het bestand.

Voorbeeld: bronveld product_name wordt gekoppeld aan Slim veld title.

Gebruik het voorbeeldproduct op het scherm om te controleren welke werkelijke waarde door een bronveld wordt aangeleverd. Je kunt tussen voorbeelden navigeren en waar beschikbaar ook de ruwe brondata bekijken.

Controleer meerdere producten. Eén voorbeeld kan toevallig leeg, uitzonderlijk of onvolledig zijn.

Manieren om een waarde op te bouwen

Per Slim veld kun je kiezen hoe Nifelo de uiteindelijke waarde bepaalt.

Koppelen

Gebruik één bronveld rechtstreeks als waarde voor het Slimme veld.

Voorbeeld: vendor → brand.

Combineren

Combineer twee bronvelden tot één waarde. Dit is nuttig wanneer informatie over meerdere kolommen of elementen verdeeld is.

Gebruik combineren alleen wanneer de samengevoegde waarde voor alle producten logisch blijft.

Fallback

Gebruik een tweede bronveld wanneer het eerste veld leeg is. Dit helpt wanneer leveranciers vergelijkbare informatie niet consequent in hetzelfde veld plaatsen.

Voorbeeld: gebruik eerst sale_price en val terug op price wanneer de actieprijs ontbreekt.

Vaste waarde

Geef alle producten dezelfde waarde voor een Slim veld.

Voorbeeld: stel een vaste conditie new in wanneer alle producten nieuw zijn en de bron geen conditieveld bevat.

Gebruik een vaste waarde alleen wanneer deze werkelijk voor ieder product in de databron geldt.

Een koppeling toevoegen of wijzigen

Kies Koppeling toevoegen wanneer het gewenste Slimme veld nog niet in de lijst staat.
Selecteer bij Doel het Slimme veld dat je wilt vullen.
Kies de gewenste actie: koppelen, combineren, fallback of vaste waarde.
Selecteer het bronveld of vul de benodigde vaste waarde in.
Open de gegevensstroom of live preview om het resultaat te controleren.
Controleer meerdere voorbeeldproducten.
Sla de mappings pas op wanneer de waarden kloppen.

Een Slim veld kan normaal maar één actieve hoofdkoppeling binnen dezelfde databron hebben. Controleer daarom eerst of het doelveld al bestaat voordat je een nieuwe regel toevoegt.

Bronvelden die nog niet gekoppeld zijn

Via het overzicht van bronvelden zie je welke velden Nifelo heeft gevonden en welke nog niet worden gebruikt.

Koppel een veld wanneer het:

belangrijke productinformatie bevat;
nodig is voor categorisatie, AI of validatie;
vereist is voor een verkoopkanaal;
later gebruikt moet worden in een regel of export.

Laat velden ongekoppeld wanneer ze alleen technische metadata, logging of informatie zonder productdoel bevatten.

Wanneer een relevant veld niet in de standaardbibliotheek past, kan afhankelijk van de beschikbare functionaliteit een aanvullend veld worden aangemaakt. Gebruik duidelijke, stabiele namen en voorkom dubbele velden met dezelfde betekenis.

Regels gebruiken

Met regels kun je een waarde onder voorwaarden aanpassen. Een regel bestaat uit een als-gedeelte en een dan-actie.

Voorbeeld:

Als de titel het woord NIKE bevat;
dan stel het merk in op Nike.

Regels zijn geschikt voor voorspelbare uitzonderingen, zoals vaste leverancierscodes, ontbrekende merken of waarden die op basis van een ander veld moeten worden gezet.

Maak een regel zo specifiek mogelijk en controleer de uitkomst met meerdere producten. Te brede regels kunnen onbedoeld veel producten wijzigen.

Houd het aantal regels beperkt

Probeer productdata niet met een groeiende verzameling regels te repareren. Veel regels maken een databron moeilijker te begrijpen, kunnen elkaar tegenspreken en vragen extra onderhoud wanneer het assortiment of de bronstructuur verandert.

Gebruik bij voorkeur deze volgorde:

Corrigeer de brondata wanneer informatie structureel verkeerd of onvolledig wordt aangeleverd.
Gebruik AI voor inhoudelijke beoordeling en verbetering waarbij betekenis, context of verschillende formuleringen een rol spelen.
Gebruik een regel voor een gerichte, voorspelbare uitzondering die met een duidelijke voorwaarde altijd hetzelfde resultaat moet geven.

AI is bijvoorbeeld geschikt voor het verbeteren van titels en beschrijvingen of het interpreteren van productinformatie. Een regel is geschikter voor exacte afspraken, zoals: als een vaste leverancierscode voorkomt, stel dan altijd hetzelfde merk in.

Regels blijven daarmee een krachtige mogelijkheid om bewust in te grijpen wanneer broncorrectie niet mogelijk is, wanneer AI onvoldoende zekerheid heeft of wanneer een uitkomst strikt en herhaalbaar moet zijn. Houd iedere regel klein, verklaarbaar en controleerbaar.

Mappings opslaan en opnieuw importeren

Klik op Mappings opslaan nadat je de koppelingen hebt gecontroleerd. Daarmee bewaar je de veldstructuur voor deze databron.

Het opslaan van mappings verandert de oorspronkelijke webshop, feed of het bronbestand niet. De mappings bepalen hoe Nifelo de brondata intern verwerkt.

Wanneer producten al eerder zijn geïmporteerd, kan een nieuwe of gewijzigde mapping pas volledig zichtbaar worden nadat de databron opnieuw is verwerkt of geïmporteerd.

Mappings herstellen of wissen

Gebruik Mappings resetten alleen wanneer je bewust opnieuw wilt beginnen. Bestaande handmatige koppelingen kunnen daardoor verloren gaan.

Maak vóór grote wijzigingen duidelijk welke velden verplicht zijn en welke aangepaste regels of velden behouden moeten blijven.

Aanbevolen eerste controle

Bekijk of de databron automatisch beheerde of handmatige mappings gebruikt.
Controleer eerst titel, product-ID, variant-ID, SKU, EAN/barcode, merk, prijs en afbeelding.
Los ontbrekende verplichte velden op.
Controleer Auto-Mapvoorstellen inhoudelijk.
Bekijk meerdere voorbeeldproducten en de ruwe brondata.
Gebruik fallback of vaste waarden alleen wanneer de bronstructuur dit vereist.
Test regels met verschillende producten.
Sla de mappings op.
Voer een eerste of nieuwe import uit.
Controleer de geïmporteerde producten voordat je AI, normalisatie of exports gebruikt.