# Leveranciersdata naar Pimcore, visueel gemapt Pimcore 11 heeft geen REST-webservice, dus SDM Portal schrijft via de Datahub GraphQL-API: objecten gevonden op key, aangemaakt onder de map die je kiest, taal voor taal bijgewerkt. De connector is in beta en deze pagina zegt precies wat die wel en niet doet. Webversie: https://sdmportal.com/nl/pimcore/ ## De connectie - **Protocol:** Datahub GraphQL, /pimcore-graphql-webservices/{config} - **Authenticatie:** Datahub-API-sleutel op de security definition van de config - **Versie:** Pimcore 11 - **Structuur:** Class - **Adressering:** Objectkey, onder een doelmap per profiel - **Status:** Beta ## Waar een Pimcore-leveranciersfeed echt vastloopt ### Geen REST-webservice Pimcore 11 heeft die laten vallen. Alles loopt via een Datahub-configuratie die je zelf aanmaakt, die bepaalt welke classes leesbaar en schrijfbaar zijn en die de API-sleutel bevat. ### Objecten zijn keys en paden Een Pimcore-object wordt niet geadresseerd via een identifier-attribuut maar via een key in een mappenboom. Een leveranciersrij moet eerst uitkomen op een key voordat er iets geschreven kan worden. ### Talen zijn losse schrijfacties Gelokaliseerde velden worden per taal bijgewerkt, wat betekent dat een brede meertalige catalogus veel kleine mutaties is in plaats van één document. ## Hoe SDM Portal naar Pimcore schrijft ### Datahub als integratievlak Je maakt in Pimcore een Datahub-configuratie aan, stelt de classes bloot die je wilt vullen, zet een API-sleutel op de security definition en activeert die. SDM Portal verbindt met dat endpoint via die sleutel. Er wordt niets in Pimcore geïnstalleerd. ### Mapping per class Kies de class en de attribuutrail beperkt zich tot de velden daarvan, net zoals een familie of een template dat op de andere twee PIM-systemen doet. ### Bestaan gecontroleerd op key Voor het schrijven zoekt SDM Portal de keys op die het gaat aanraken en bepaalt per rij of dat een create of een update is. De controle vindt ook niet-gepubliceerde objecten, dus een object dat je in een eerdere run hebt aangemaakt wordt bijgewerkt in plaats van gedupliceerd. ### Een doelmap die je kiest Nieuwe objecten worden aangemaakt onder een mappad dat je per profiel instelt. Als de Datahub-configuratie objectmappen blootstelt, kies je die uit een doorzoekbare boom die live uit Pimcore wordt gelezen; zo niet, dan typ je het pad. ### Waarden geschreven per taal Eén create, daarna één update-mutatie per taal, met pacing zodat een grote catalogus het endpoint niet overspoelt. Een update zonder inhoud wordt overgeslagen in plaats van verstuurd. ### Alles voor het schrijven is hetzelfde Upload, sharelink of e-mailintake, de visuele flow-editor, door AI gecompileerde transformaties, de Translate- en Compose-blokken, de dry-run rij voor rij, de goedkeuringsworkflow, de modi create, update en upsert, en delta sync zijn identiek aan de paden voor Ergonode en Akeneo. Alleen het schrijven verschilt. ## Wat we naar Pimcore kunnen schrijven Waarden worden per taal geschreven via Datahub-update-mutaties. Selectwaarden worden gemapt op de codes die je class verwacht; SDM Portal maakt geen nieuwe waarden of velden aan in de classdefinitie. - Tekstvelden - Textarea - Getallen - Datums - Gelokaliseerde velden per taal - Objectkey - Plaatsing in de doelmap ## Wat de Pimcore-connector nog niet doet ### Jonger dan de andere twee connectoren (beta) Hij schrijft vandaag naar een echte Pimcore-instantie: hij vindt objecten op key, maakt ze aan onder een doelmap en werkt waarden per taal bij. Hij heeft minder functies dan de connectoren voor Ergonode en Akeneo, en die staan hier allemaal. ### Objecten komen ongepubliceerd binnen (jouw keuze) Een object dat SDM Portal aanmaakt wordt niet gepubliceerd. Publiceren blijft een keuze in Pimcore. De keycontrole vindt wel niet-gepubliceerde objecten, dus de volgende run werkt dat object bij in plaats van er een tweede aan te maken. ### Varianten, opties aanmaken, workflowstatus (niet ondersteund) Geen variantouders en -assen, geen selectwaarden of opties aanmaken, geen verrijking van opties en geen workflowstatus-overgangen. Dat zijn functies van Ergonode en Akeneo. ### Velden aanmaken (blijft in pimcore) Je kunt geen nieuw classveld vanuit de editor aanmaken. De classdefinitie wordt in Pimcore beheerd. ### Dubbele keys over mappen heen (let op) De keycontrole zoekt in alle mappen. Bestaat dezelfde key twee keer, dan krijg je een waarschuwing over de dubbele key en gaat de schrijfactie naar de eerste match. ### Eén update per taal per object (doorvoer) Een brede meertalige catalogus loopt langzamer dan de gebatchte schrijfpaden van Ergonode en Akeneo, waar veel producten in één request meegaan. ### De mappenkiezer (afhankelijk van de config) Objectmappen lezen staat standaard uit in een Datahub-configuratie. Zet het aan om de mappenboom te krijgen, of typ in plaats daarvan het doelpad. ## FAQ ### Welke Pimcore-versie en API gebruikt SDM Portal? Pimcore 11 via de Datahub GraphQL-API. Pimcore 11 heeft geen REST-webservice, dus Datahub is het integratievlak. Je maakt een Datahub-configuratie aan, stelt de classes bloot die je wilt vullen, zet een API-sleutel op de security definition en activeert die. ### Wat betekent beta voor de Pimcore-connector? Hij schrijft vandaag naar een echte Pimcore-instantie: hij vindt objecten op key, maakt ze aan onder een doelmap en werkt waarden per taal bij. Hij is jonger dan de connectoren voor Ergonode en Akeneo en heeft minder functies, en die staan op deze pagina. We noemen het beta zodat je dat zelf kunt beoordelen. ### Worden de objecten automatisch gepubliceerd? Nee. Objecten die SDM Portal aanmaakt komen ongepubliceerd binnen, en publiceren blijft een keuze in Pimcore. De bestaanscontrole vindt wel niet-gepubliceerde objecten, dus een latere run werkt het object bij dat je hebt aangemaakt in plaats van er nog een te maken. ### Hoe worden Pimcore-objecten aan leveranciersrijen gekoppeld? Op objectkey. Voor het schrijven controleert SDM Portal de keys die het gaat aanraken en bepaalt per rij of dat een create of een update is. De controle zoekt in alle mappen, dus bestaat dezelfde key twee keer, dan krijg je een waarschuwing over de dubbele key en gaat de schrijfactie naar de eerste match. ### Kan ik de visuele editor en de dry-run nog gebruiken? Ja. Alles voor het schrijven is hetzelfde als bij Ergonode en Akeneo: het flow-canvas, transformaties, door AI gecompileerde regels, de Translate- en Compose-blokken, de dry-run rij voor rij, de goedkeuringsworkflow en delta sync. ## Aan de slag Probeer 14 dagen gratis: https://app.sdmportal.com/signup?lang=nl Andere PIM-systemen: https://sdmportal.com/nl/ergonode/ · https://sdmportal.com/nl/akeneo/ · https://sdmportal.com/nl/pimcore/ SDM Portal.