Met exportstreams kan u derden toegang geven tot uw data. Zo kan u bijvoorbeeld een productenlijst als stream
beschikbaar maken voor een Marketing Automatie Platform (e.g. Klaviyo). De stream bevat altijd de laatste data.
Nieuwe stream maken
Voor elke entiteit kan een stream gemaakt worden door bij Instellingen de juiste entiteit aan te duiden en vervolgens
te navigeren naar Exportstreams. Klik op + Feed om een nieuwe stream aan te maken.
Als eerste dient u de nieuwe stream een naam te geven en kan u optioneel een beschrijving toevoegen.
Geheime sleutel
Om ervoor te zorgen dat u uw data kan afschermen, wordt er aan de URL van de stream een geheime sleutel toegevoegd.
U kan de sleutel zelf kiezen, maar een willekeurige tekst is veiliger. U kan een nieuwe geheime sleutel laten genereren,
door rechts in het invulveld op het pijltje te klikken.
Wanneer u toegang tot de stream wil blokkeren, kan u steeds een nieuwe sleutel genereren en deze bewaren.
URL
Dit veld verschijnt pas nadat de stream voor de eerste keer is opgeslagen.
Dit veld is enkel lezen en bevat de URL waarop de stream beschikbaar is. Door op het pijltje rechts in het veld te klikken, opent de stream in een nieuw tabblad.
U kan deze URL kopiëren en doorgeven aan de software die de stream moet inlezen.
Deze URL wordt pas aangepast nadat de wijzigingen zijn opgeslagen. Als u de geheime sleutel wijzigt, dient u eerst op te slaan alvorens de nieuwe URL te kopiëren.
Bestandstype
De stream kan aangeleverd worden in 3 bestandsformaten. Welke u nodig heeft, hangt af van de formaten die de ondersteund
worden door de software die de stream moet inlezen.
De drie ondersteunde formaten zijn
JSON
XML
CSV
Webshop URL
Als u bijvoorbeeld een stream maakt van al uw producten, is het mogelijk om, naast de productinformatie, ook een link
naar uw webshop toe te voegen. Indien u dit niet wenst, kan dit worden uitgeschakeld door de webshop URL te verbergen.
De Webshop URL veldnaam is hoe dit veld zal heten in het exportbestand. Als u dit veld leeg laat, zal de naam Link gebruikt worden.
Vervolgens kan de link naar de webshop opgegeven worden. De volledige URL naar het product moet opgegeven worden.
Tussen vierkante haken [ ] kan u de naam van een van de geëxporteerde velden zetten om de URL per product te variëren.
Enkel de originele naam van een veld (en dus niet de aangepaste naam) kan gebruikt worden in de URL.
Bijvoorbeeld: https://webshop.be/nl/producten/[productcode]/[naam]
Enkel velden die geëxporteerd worden, kunnen in de URL gebruikt worden
Entiteit ID
De achterliggende unieke ID van de entiteit kan ook geëxporteerd worden.
Kolommen en filters
U kan een Segment en extra filters toevoegen om te beperken welke data u via de stream beschikbaar stelt.
U kan volledig definiëren welke velden u wil exporteren. U kan velden toevoegen, verwijderen en ordenen.
Bij vertaalbare velden, kan u selecteren in welke talen dit veld wil exporteren. De standaardwaarde van het veld wordt steeds geëxporteerd.
Afhankelijk van het gekozen bestandsformaat, wijzigt de structuur van het bestand.
Bestandsstructuur
CSV - Kommagescheiden bestand
Voor elk geëxporteerd veld, wordt er een kolom aangemaakt. De eerste rij bevat de kolomnamen.
Wanneer een veld een aanhalingsteken " of komma , bevat, zal dit veld geëscaped worden door het veld te omsluiten met aanhalingstekens.
Vb: foo "bar" baz wordt "foo \"bar\" baz"
Als een vertaalbaar veld in een taal geëxporteerd wordt, wordt er per taal een kolom toegevoegd. De kolomnaam is [veldnaam] [Taal]
Voorbeeld
Id,Link,Productcode,Naam,Naam Nederlands,Naam Frans,Korte omschrijving,Barcode, 1cd0a51e-fe8a-d3b9-72c0-3a0eb59e0312,https://webshop.be/nl/prodcuten/[productcode]/[naam],IAMD-TEST,IAMD Test, IAMD Test Nederlands, IAMD Test Frans,Dit is een testproduct,230000010802,
JSON
De structuur van het JSON bestand is een lijst van JSON objecten.
Elk geëxporteerd veld wordt een sleutel-waardepaar in het JSON object. Het type van het veld blijft zo goed als mogelijk behouden.
Wanneer een veld in meerdere talen wordt geëxporteerd, wordt de waarde van dat veld een object met als sleutels de naam van de taal. De standaard waarde heeft als sleutel default.
[ { "Id": "1cd0a51e-fe8a-d3b9-72c0-3a0eb59e0312", "Link": "https://webshop.be/nl/prodcuten/[productcode]/[naam]", "Productcode": "IAMD-TEST", "Naam": { "default": "IAMD Test" "Nederlands": "IAMD Test Nederlands" "Frans": "IAMD Test Frans" }, "Korte omschrijving": "Dit is een testproduct", "Barcode": "230000010802" } ]
XML
De structuur van het XML bestand Heeft als root <EntityItems>
. Elk item in de export is een <EntityItem> element met voor elke geëxporteerde waarde een nieuw element met als naam de veldnaam.
Wanneer een veld in meerdere talen wordt geëxporteerd, wordt de waarde van dat veld een element met als elementnaam de naam van de taal. De standaard waarde heeft als elementnaam <default>.
<EntityItems> <EntityItem> <Id>1cd0a51e-fe8a-d3b9-72c0-3a0eb59e0312</Id> <Link>https://webshop.be/nl/prodcuten/[productcode]/[naam]</Link> <Productcode>IAMD-TEST</Productcode> <Naam> <default>IAMD Test</default> <Nederlands>IAMD Test Nederlands</Nederlands> <Frans>IAMD Test Frans</Frans> </Naam> <Korteomschrijving>Dit is een testproduct</Korteomschrijving> <Barcode>230000010802</Barcode> </EntityItem> </EntityItems>