Voorbeeld van een artikelen CSV-import met relaties in ReflexBlue
In dit voorbeeld configureer je in ReflexBlue een importdefinitie van het type CSV Artikel import. Met deze importdefinitie importeer je artikelen uit een CSV-bestand en koppel je elk artikel aan een bestaande zoekgroep (artikelgroep).
Je voert de configuratie uit op twee plekken:
- In de ReflexBlue Desktop Client, waar je de importdefinitie instelt.
- In de ReflexBlue Import/Export Service, waar je instelt uit welke map de CSV-bestanden worden opgehaald.
Let op: Dit voorbeeld gaat ervan uit dat in je ReflexBlue administratie al een artikelgroep bestaat met code 1.
Tijdens de import koppelt ReflexBlue de artikelen aan deze artikelgroep via een zoekfunctie.
CSV-bestand voor artikelimport
In dit voorbeeld importeer je artikelen uit één CSV-bestand. Elke regel bevat één artikel en een zoekgroep voor het artikel. De waarden zijn omgeven door dubbele aanhalingstekens (") en gescheiden met een komma (,).
"1001","Granny Smith Appel","Appel Granny Smith","A2","Fresh Farms","1"
"1002","Conference Peer","Peer Conference","A4","Fresh Farms","1"
"1003","Banaan","Bananen","B1","TropiFruit","1"
"1004","Sinaasappel","Sinaasappels","B3","Citrus Select","1"
"1005","Mandarijn","Mandarijnen","B5","Citrus Select","1"
"1006","Kiwi Groen","Kiwi","C2","Zespri","1"
"1007","Mango Kent","Mango","C4","TropiFruit","1"
"1008","Blauwe Druiven","Druiven Blauw","D1","Vine Valley","1"
"1009","Aardbeien 500g","Aardbeien","D3","Berry Best","1"
"1010","Ananas","Ananas Vers","D5","TropiFruit","1" Het CSV-bestand bevat de volgende kolommen.
| Kolompositie | Gegeven |
|---|---|
0 of A | Artikelcode |
1 of B | Naam |
2 of C | Zoeknaam |
3 of D | Picklocatie |
4 of E | Merk |
5 of F | Artikelgroepcode van de zoekgroep |
Bij CSV-importdefinities kan je kolomposities opgeven als getal of als letter. De eerste kolom is 0 of A.
Stap 1: Importdefinitie toevoegen in ReflexBlue
Open het Import/Export definities overzichtsscherm in de ReflexBlue Desktop Client.
Voeg een nieuwe importdefinitie toe van het type CSV Artikel import.
Houd de toegevoegde importdefinitie open. Je configureert de importdefinitie verder in het Import/Export definities detailscherm.
CSV-bestand opgeven
Ga in het Import/Export definities detailscherm naar het CSV Ontvangen subtabblad.
Verwijder alle bestaande regels en voeg één regel toe met Nieuw.
Vul de volgende gegevens in.
| Naam | Waarde |
|---|---|
| Type naam | entity://articles.article;entity://articles.articlegroupassignment |
| Heeft kopregel | Uitgevinkt |
| Scheidingsteken | AUTO |
| Aanhalingsteken | " |
| Aanhalingsteken gebruik | Waar nodig |
| Bestandscodering | UTF-8 |
In dit voorbeeld voeg je één regel toe, omdat je één CSV-bestand importeert.
Bij Type naam geef je twee entiteiten op:
entity://articles.articleentity://articles.articlegroupassignment
Beide entiteiten staan op elke regel in het CSV-bestand.
Regels koppelen
Ga naar het Regels koppelen subtabblad.
Verwijder alle bestaande relaties. Voeg daarna één relatie toe met Nieuw.
Vul de volgende gegevens in.
| Naam | Waarde |
|---|---|
| Oudertype | entity://articles.article |
| Ouder positie | A |
| Kindtype | entity://articles.articlegroupassignment |
| Kind positie | A |
Met deze relatie geef je aan hoe ReflexBlue een artikelzoekgroep aan een artikel koppelt.
Bij Ouder positie geef je de kolom(men) op die een entiteit van het type Oudertype uniek identificeren. In dit voorbeeld is dat kolom A, waarin de artikelcode staat.
Bij Kind positie geef je de kolom(men) op die worden gebruikt om een entiteit van het type Kindtype aan zijn ouder te koppelen. Omdat een artikelgroep hier gekoppeld wordt aan een artikel, bevat in dit voorbeeld de Kind positie de waarde A omdat die kolom het artikel uniek identificeert.
Hiermee kan ReflexBlue de juiste ouder-kindrelatie opbouwen en de entiteiten in dezelfde dataset onderbrengen.
Artikelvelden koppelen
Ga naar het Velden koppelen subtabblad.
Verwijder eerst alle bestaande subtabbladen voor entiteiten. Voeg daarna één entiteit toe onder Velden koppelen genaamd Artikel.
Ga naar het Artikel subtabblad. Verwijder alle bestaande veldposities en voeg de volgende veldposities toe.
| Sleutel | Positie | Standaard waarde | Overschrijven |
|---|---|---|---|
ARTICLE_CODE | 0-A | ✓ | |
ARTICLE_NAME | 1-B | ✓ | |
ARTICLE_SEARCHNAME | 2-C | ✓ | |
ARTICLE_PICKLOCATION | 3-D | ✓ | |
ARTICLE_BRAND | 4-E | ✓ | |
ARTICLE_PACKAGING | Kist | ✓ |
De verpakking van het artikel staat niet in het CSV-bestand. Daarom heeft ARTICLE_PACKAGING geen positie.
ReflexBlue gebruikt in dit voorbeeld de standaardwaarde Kist voor alle artikelen die worden geïmporteerd.
Artikelgroep koppelen
Voeg onder Velden koppelen nog een entiteit toe: Zoekgroepen.
Ga naar het Zoekgroepen subtabblad. Verwijder alle bestaande veldposities en voeg de volgende veldpositie toe.
| Sleutel | Positie | Standaard waarde | Overschrijven |
|---|---|---|---|
ARTICLEGROUPASSIGNMENT_ARTICLEGROUP | 5-F | ✓ |
Controleer daarna of alle posities overeenkomen met de kolommen in het CSV-bestand.
Zoekfunctie toevoegen
Ga naar het Artikelen importeren subtabblad.
Controleer of de onderstaande zoekfunctie aanwezig is.
| Sleutel | Type |
|---|---|
ARTICLEGROUPASSIGNMENT_ARTICLEGROUP | ArticleGroupIdByCodeLookup |
Ontbreekt deze zoekfunctie? Voeg deze dan toe met Artikelgroep toevoegen.
Deze zoekfunctie zorgt ervoor dat ReflexBlue de waarde uit kolom F die gekoppeld is aan het veld met sleutel ARTICLEGROUPASSIGNMENT_ARTICLEGROUP gebruikt om de bestaande artikelgroep op te zoeken. In dit voorbeeld is dat artikelgroepcode 1 zoals opgegeven in het CSV-bestand.
Daarna koppelt ReflexBlue de gevonden artikelgroep aan het artikel op dezelfde regel.
Stap 2: Synchronisatie toevoegen in de ReflexBlue Import/Export Service
Nadat je de importdefinitie in ReflexBlue hebt geconfigureerd, voeg je deze toe aan de ReflexBlue Import/Export Service.
De service haalt CSV-bestanden op uit de ingestelde Import Directory en stuurt ze naar ReflexBlue voor import.
Open in de ReflexBlue Import/Export Service het Synchronisations-scherm en voeg een ReflexBlue Import synchronisatie toe.
Selecteer bij het toevoegen van de synchronisatie de importdefinitie die je eerder hebt aangemaakt.
Omdat je op het CSV Ontvangen subtabblad één bestand hebt opgegeven met twee entiteiten, zie je in de ReflexBlue Import/Export Service één veld voor een file mask bij entity://articles.article;entity://articles.articlegroupassignment.
Voer een regex-bestandsmasker in voor de naam van het CSV-bestand: artikelen\.csv.
Stap 3: Artikelen importeren
Nadat je de synchronisatie hebt toegevoegd en opgeslagen in de ReflexBlue Import/Export Service, plaats je het CSV-bestand in de ingestelde Import Directory.
Gebruik voor dit voorbeeld de volgende bestandsnaam: artikelen.csv. Deze bestandsnaam voldoet aan het eerder opgegeven regex-bestandsmasker.
Wanneer de configuratie klopt, haalt de ReflexBlue Import/Export Service het bestand op uit de importmap. Bestanden die zijn geüpload, worden verplaatst naar een archiefmap.
Je kan de voortgang van de import volgen in de ReflexBlue Desktop Client via het Imports/Exports overzichtsscherm.