# Lieferantendaten nach Pimcore, visuell gemappt Pimcore 11 hat keinen REST-Webservice, deshalb schreibt SDM Portal über die Datahub-GraphQL-API: Objekte werden über den Key gefunden, unter dem Ordner angelegt, den Sie wählen, und pro Sprache aktualisiert. Der Connector ist in Beta, und diese Seite sagt genau, was er tut und was nicht. Webversion: https://sdmportal.com/de/pimcore/ ## Die Verbindung - **Protokoll:** Datahub GraphQL, /pimcore-graphql-webservices/{config} - **Authentifizierung:** Datahub-API-Key an der Security Definition der Konfiguration - **Version:** Pimcore 11 - **Struktur:** Klasse - **Adressierung:** Objekt-Key, unter einem Zielordner pro Profil - **Status:** Beta ## Wo ein Pimcore-Lieferantenfeed wirklich hängen bleibt ### Kein REST-Webservice Pimcore 11 hat ihn entfernt. Alles läuft über eine Datahub-Konfiguration, die Sie selbst anlegen und die entscheidet, welche Klassen lesbar und schreibbar sind, und die den API-Key hält. ### Objekte sind Keys und Pfade Ein Pimcore-Objekt wird nicht über ein Identifier-Attribut adressiert, sondern über einen Key in einem Ordnerbaum. Eine Lieferantenzeile muss auf einen Key auflösen, bevor etwas geschrieben werden kann. ### Sprachen sind eigene Schreibvorgänge Lokalisierte Felder werden pro Sprache aktualisiert, ein breiter mehrsprachiger Katalog besteht damit aus vielen kleinen Mutationen statt aus einem Dokument. ## Wie SDM Portal nach Pimcore schreibt ### Datahub als Integrationsfläche Sie legen in Pimcore eine Datahub-Konfiguration an, geben die Klassen frei, die Sie füllen wollen, setzen einen API-Key an der Security Definition und aktivieren sie. SDM Portal verbindet sich mit diesem Endpunkt und dem Key. In Pimcore wird nichts installiert. ### Mapping pro Klasse Wählen Sie die Klasse, und die Attributleiste beschränkt sich auf ihre Felder, genauso wie es eine Familie oder ein Template bei den anderen beiden PIMs tut. ### Bestandsprüfung über den Key Vor dem Schreiben sucht SDM Portal die Keys, die es anfassen wird, und entscheidet pro Zeile, ob das ein Create oder ein Update ist. Die Prüfung findet auch unveröffentlichte Objekte, ein Objekt aus einem früheren Lauf wird also aktualisiert statt doppelt angelegt. ### Ein Zielordner Ihrer Wahl Neue Objekte werden unter einem Ordnerpfad angelegt, der pro Profil gesetzt wird. Gibt die Datahub-Konfiguration Objektordner frei, wählen Sie ihn aus einem durchsuchbaren Baum, der live aus Pimcore gelesen wird; wenn nicht, tippen Sie den Pfad. ### Werte pro Sprache geschrieben Ein Create, dann eine Update-Mutation pro Sprache, mit Pausen, damit ein großer Katalog den Endpunkt nicht überflutet. Ein Update ohne Inhalt wird übersprungen statt gesendet. ### Alles vor dem Schreiben ist gleich Upload, Share-Link oder E-Mail-Erfassung, der visuelle Flow-Editor, KI-kompilierte Transformationen, die Blöcke Translate und Compose, der Dry-Run Zeile für Zeile, der Freigabe-Workflow, die Modi create, update und upsert und Delta Sync sind identisch mit den Wegen für Ergonode und Akeneo. Nur das Schreiben unterscheidet sich. ## Was wir nach Pimcore schreiben können Werte werden über Datahub-Update-Mutationen pro Sprache geschrieben. Select-Werte werden auf die Codes gemappt, die Ihre Klasse erwartet; SDM Portal legt keine neuen Werte oder Felder in der Klassendefinition an. - Textfelder - Textarea - Zahlen - Datumsfelder - Lokalisierte Felder pro Sprache - Objekt-Key - Platzierung im Zielordner ## Was der Pimcore-Connector noch nicht tut ### Jünger als die anderen beiden Connectoren (beta) Er schreibt heute in eine echte Pimcore-Instanz: er findet Objekte über den Key, legt sie unter einem Zielordner an und aktualisiert Werte pro Sprache. Er hat weniger Funktionen als die Connectoren für Ergonode und Akeneo, und sie sind hier alle aufgeführt. ### Objekte landen unveröffentlicht (Ihre Entscheidung) Ein von SDM Portal angelegtes Objekt wird nicht veröffentlicht. Das Veröffentlichen bleibt eine Entscheidung in Pimcore. Die Key-Prüfung findet unveröffentlichte Objekte, der nächste Lauf aktualisiert dieses Objekt also, statt ein zweites anzulegen. ### Varianten, Optionen anlegen, Workflow-Status (nicht unterstützt) Keine Varianteneltern und Achsen, kein Anlegen von Select-Werten oder Optionen, keine Optionsanreicherung und keine Workflow-Statusübergänge. Das sind Funktionen von Ergonode und Akeneo. ### Felder anlegen (bleibt in Pimcore) Sie können kein neues Klassenfeld aus dem Editor anlegen. Die Klassendefinition wird in Pimcore verwaltet. ### Doppelte Keys über Ordner hinweg (zu beachten) Die Key-Prüfung sucht über alle Ordner hinweg. Existiert derselbe Key zweimal, bekommen Sie eine Warnung über doppelte Keys, und der Schreibvorgang trifft den ersten Treffer. ### Ein Update pro Sprache pro Objekt (Durchsatz) Ein breiter mehrsprachiger Katalog läuft langsamer als die gebündelten Schreibwege für Ergonode und Akeneo, bei denen viele Produkte in einem Request reisen. ### Der Ordner-Picker (konfigurationsabhängig) Das Lesen von Objektordnern ist in einer Datahub-Konfiguration standardmäßig aus. Schalten Sie es ein, um den Ordnerbaum zu bekommen, oder tippen Sie stattdessen den Zielpfad. ## FAQ ### Welche Pimcore-Version und welche API nutzt SDM Portal? Pimcore 11 über die Datahub-GraphQL-API. Pimcore 11 hat keinen REST-Webservice, deshalb ist Datahub die Integrationsfläche. Sie legen eine Datahub-Konfiguration an, geben die Klassen frei, die Sie füllen wollen, setzen einen API-Key an ihrer Security Definition und aktivieren sie. ### Was bedeutet Beta beim Pimcore-Connector? Er schreibt heute in eine echte Pimcore-Instanz: er findet Objekte über den Key, legt sie unter einem Zielordner an und aktualisiert Werte pro Sprache. Er ist jünger als die Connectoren für Ergonode und Akeneo und hat weniger Funktionen, die auf dieser Seite aufgeführt sind. Wir nennen ihn Beta, damit Sie das selbst beurteilen können. ### Werden die Objekte automatisch veröffentlicht? Nein. Von SDM Portal angelegte Objekte landen unveröffentlicht, und das Veröffentlichen bleibt eine Entscheidung in Pimcore. Die Bestandsprüfung findet unveröffentlichte Objekte, ein späterer Lauf aktualisiert also das angelegte Objekt, statt ein weiteres zu erzeugen. ### Wie werden Pimcore-Objekte den Lieferantenzeilen zugeordnet? Über den Objekt-Key. Vor dem Schreiben prüft SDM Portal die Keys, die es anfassen wird, und entscheidet pro Zeile, ob das ein Create oder ein Update ist. Die Prüfung sucht Keys über alle Ordner hinweg, existiert derselbe Key also zweimal, bekommen Sie eine Warnung über doppelte Keys, und der Schreibvorgang trifft den ersten Treffer. ### Kann ich den visuellen Editor und den Dry-Run trotzdem nutzen? Ja. Alles vor dem Schreiben ist gleich wie bei Ergonode und Akeneo: die Flow-Leinwand, Transformationen, KI-kompilierte Regeln, die Blöcke Translate und Compose, der Dry-Run Zeile für Zeile, der Freigabe-Workflow und Delta Sync. ## Loslegen 14 Tage kostenlos testen: https://app.sdmportal.com/signup?lang=de Andere PIMs: https://sdmportal.com/de/ergonode/ · https://sdmportal.com/de/akeneo/ · https://sdmportal.com/de/pimcore/ SDM Portal.