Wat is een additionele databron en hoe kan ik deze toevoegen?

Ga naar:

  1. Waar vind ik de module voor additionele databronnen?
  2. Wat moet je weten over het toevoegen van een additionele databron
  3. Hoe voeg ik een additionele databron toe aan EffectConnect?
  4. CSV-bestanden
    1. CSV-bestand uploaden
    2. Controleer upload en definieer scheidingsteken
    3. Selecteer identifier, kolommen en catalogustaal
    4. Samenvatting
  5. Geldige CSV (in hoofdlijnen)
  6. CSV via URL creëren vanuit een Google Spreadsheet
  7. XML-bestanden
    1. XML-bestand uploaden
    2. Selecteer elementen t.b.v. import en productelement
    3. Samenvatting

EffectConnect legt standaard een verbinding met jouw webshop of ERP-systeem en haalt de benodigde productinformatie op die je in EffectConnect gebruikt.

Je kunt echter extra productinformatie aan EffectConnect toevoegen door een CSV-bestand (Comma-Separated Values) of een XML-bestand te uploaden, waarmee je een aanvullende databron creëert.

Deze extra gegevens worden als attribuut ingelezen en gekoppeld aan de bijbehorende producten. Vervolgens kun je de attributen, net als alle andere attributen overal toepassen in EffectConnect, bijvoorbeeld in productselecties, kanaalinstellingen, repricer, mappingregels of in een custom attribuut.

Waar vind ik de module voor additionele bronnen?

Ga in EffectConnect naar Catalogus > Additionele bronnen

Wat je moet weten over het toevoegen van een additionele bron

Binnen de module kun je een CSV- of XML-bestand als additionele databron uploaden. Weet je niet zeker wat een CSV-bestand is? Lees dan dit artikel of dit artikel voor uitleg over XML-bestanden.

In het CSV- of XML-bestand moet minimaal één identifier aanwezig zijn die ook in EffectConnect wordt gebruikt, zodat de nieuwe gegevens correct aan de producten kunnen worden gekoppeld. Dit kan bijvoorbeeld het product-ID, de EAN of de SKU zijn.

Wat je moet weten over het toevoegen van een additionele bron

Binnen de module kun je een CSV- of XML-bestand als additionele databron uploaden. Weet je niet zeker wat een CSV-bestand is? Lees dan dit artikel of dit artikel voor uitleg over XML-bestanden.

In het CSV- of XML-bestand moet minimaal één identifier aanwezig zijn die ook in EffectConnect wordt gebruikt, zodat de nieuwe gegevens correct aan de producten kunnen worden gekoppeld. Dit kan bijvoorbeeld het product-ID, de EAN of de SKU zijn.

Hoe voeg ik een additionele databron toe aan EffectConnect?


Als je de additionele databron module opent klik je op de knop om een databron toe te voegen. 

Selecteer type databron

  1. CSV upload
    Eenmalige upload waarbij geen automatische updates opgehaald worden.
  2. CSV import via URL 
    Wijzigingen in het CSV-bestand worden automatisch opgehaald via de URL.
  3. XML upload
    Eenmalige upload waarbij geen automatische updates opgehaald worden.
  4. XML import via URL
    Wijzigingen in het XML-bestand worden automatisch opgehaald via de URL.

Wij raden aan om te kiezen voor een import via URL, omdat wijzigingen in de databron automatisch worden opgehaald via de URL. In tegenstelling tot een eenmalige upload, die geen automatische updates of aanvullingen mogelijk maakt, zorgt de URL-import ervoor dat je altijd beschikt over de meest actuele gegevens.

CSV-bestanden

Stap 1 - CSV-bestand uploaden

  • CSV upload
    Geef een naam aan deze additionele databron (voor eigen referentie) en upload het CSV-bestand dat je wilt gebruiken.

  • CSV import via URL
    Geef een naam aan deze additionele databron (voor eigen referentie) en voer de URL naar het CSV-bestand in > klik op bestand downloaden.

Vanaf stap 2 zijn de vervolgstappen gelijk voor de CSV import.

Stap 2 - Controleer upload en definieer scheidingsteken

Geef aan of het CSV-bestand gebruikmaakt van headers en welke scheidingstekens zijn toegepast. Deze instellingen zijn essentieel voor EffectConnect om het bestand correct te interpreteren. EffectConnect probeert automatisch het juiste scheidingsteken te herkennen, controleer dit altijd zelf.



Daarnaast is er de optie om de geavanceerde instellingen zichtbaar te maken waarbij je  voor encapsulatie- en escape-tekens kunt invoeren of aanpassen. 

Stap 3 - Selecteer identifier, kolommen en catalogustaal


Selecteer identifier

Selecteer een bestaand attribuut in EffectConnect en een kolom uit de CSV, welke exact dezelfde waarden bevatten, om deze met elkaar te matchen.

Wij raden aan om hier EAN of SKU te kiezen.



Selecteer kolommen
Kies de kolommen die je wilt importeren; deze worden aangemaakt als nieuwe attributen in EffectConnect.

De titel van de kolom in het CSV-bestand wordt automatisch gebruikt als naam voor het nieuwe attribuut. Je hebt echter de mogelijkheid om deze naam naar wens aan te passen bij 'Naam attribuut'. 

Selecteer taal ten behoeve van import template
Selecteer in welke taal je de attributen uit de additionele databron wilt opslaan in je catalogus.

Stap 4 - Samenvatting

Controleer nog een keer al jouw instellingen voordat je de import start. Klik op 'Importeer data' als de instellingen kloppen.

Geldige CSV (in hoofdlijnen)

  • CSV = Comma-Separated-Values
  • Iedere rij moet evenveel kolommen bevatten
  • Het scheidingsteken moet voor alle kolommen op iedere rij gelijk zijn
  • Er mogen geen lege rijen tussenzitten
  • Teksten die over meerdere rijen gaan dienen voorzien te zijn van encapsulation
  • Vreemde tekens (zoals emoji's) kunnen in potentie issues opleveren
  • Nieuwe kolommen voeg je altijd achteraan toe, nooit vooraan of tussen twee bestaande kolommen in
  • Het CSV altijd opslaan als UTF-8

CSV via URL creëren vanuit een Google Spreadsheet

Om een CSV-bestand vanuit Google Drive te importeren, moet het bestand eerst als CSV worden gepubliceerd op Google Drive.


Lees hier hoe je dit doet: Hoe maak je een CSV link van een Google Spreadsheet? of volg het stappenplan.

Stappenplan

  1. Open de spreadsheet en ga naar het menu > 'Bestand'.
  2. Kies vervolgens voor 'Delen' en selecteer 'Publiceren op internet'.
  3. Klik op het bestand dat je wilt omzetten naar CSV en klik op 'Publiceer'.  Hiermee kun je de gegenereerde URL delen. 
  4. Zorg ervoor dat er geen toegangsbeperkingen zijn ingesteld; het bestand moet volledig openbaar toegankelijk zijn.
  5. Ga daarna naar EffectConnect en voeg het bestand toe als een additionele bron via de optie 'CSV import via URL'.

XML-bestanden

Stap 1 - XML-bestand uploaden

  • XML upload
    Geef een naam aan deze additionele databron (voor eigen referentie) en upload het XML-bestand dat je wilt gebruiken.

  • XML import via URL
    Geef een naam aan deze additionele databron (voor eigen referentie) en voer de URL naar het XML-bestand in > klik op bestand inlezen.

Stap 2 - Selecteer elementen t.b.v. import en productelement

Vink de elementen aan die je uit het XML-bestand wilt importeren en geef deze in de kolom 'naam nieuw attribuut' eventueel een aangepaste naam, met deze naam zijn de gegevens later terug te vinden binnen EffectConnect. 

Selecteer identifier

Selecteer een product identifier uit het XML-bestand en link deze aan een reeds bekend attribuut binnen EffectConnect waaraan dezelfde waarden gekoppeld zijn. Deze identifier wordt gebruikt om de juiste gegevens aan de juiste artikelen te kunnen koppelen.

Wij raden aan om hier bijvoorbeeld de EAN of SKU te kiezen.

Selecteer taal ten behoeve van import template
Selecteer in welke taal je de attributen uit de additionele databron wilt opslaan in je catalogus en klik op 'volgende stap'.

Stap 3 - Samenvatting

Controleer nog een keer al jouw instellingen voordat je de import start. Klik op 'Importeer data' als de instellingen kloppen.