Lieferantendaten in Ergonode überführen. Ohne Code.
Ergonode bietet nur GraphQL, und jede Attributart hat ihre eigene typisierte Mutation. SDM Portal weiß, welche zu nehmen ist, schreibt Ihre Varianten in der Reihenfolge, die Ergonode verlangt, und wiederholt die gleichen Regeln bei jeder Datei, die dieser Lieferant schickt.
Verbindung
- ProtokollNur GraphQL, /api/graphql/
- AuthentifizierungAPI-Key in einem X-API-KEY-Header
- StrukturTemplate
- SchreibenAliasierte GraphQL-Mutationen, 25 Operationen pro Request
- VariantenZuerst die Simple Products, dann das Variable Product mit Bindings
- Delta syncHash pro Schreiboperation
Wo ein Ergonode-Lieferantenfeed wirklich hängen bleibt
Lieferantendateien sind für Menschen gemacht. Ergonode ist für ein Schema gemacht. Die meiste Arbeit liegt im Abstand dazwischen, und dieser Abstand kommt mit jeder neuen Datei zurück.
Jede Art hat ihre eigene Mutation
Text, numeric, select, multi select, unit, price und relation brauchen jeweils eine andere typisierte Mutation. Schicken Sie einen Wert durch die falsche, antwortet Ergonode mit einem unbekannten Fehler und ohne Detail.
Varianten brauchen eine Reihenfolge
Die Kinder müssen existieren, bevor das Variable Product sie binden kann. Stimmt die Reihenfolge nicht, scheitern die Bindings.
Status ist ein Graph, kein Feld
Ergonode validiert Workflow-Übergänge serverseitig, Sie können den gewünschten Status also nicht einfach von dort setzen, wo das Produkt gerade steht.
Wie SDM Portal nach Ergonode schreibt
Sie zeichnen das Mapping auf einer Leinwand. Knifflige Regeln beschreiben Sie in normaler Sprache, und sie werden einmal in eine feste Regel kompiliert, damit Läufe reproduzierbar bleiben. Unten steht, was die Ergonode-Seite davon tatsächlich tut.
Mapping pro Template
Wählen Sie das Template, und die Attributleiste beschränkt sich auf seine Attribute. Templates tragen in der API keinen Anzeigenamen, deshalb zeigt der Picker den Template-Code. Die eingebaute SKU ist nicht Teil des Attributstreams, deshalb kommt ein Feld namens esa_sku hinzu und Sie mappen SKU wie jede andere Spalte.
Typisierte Schreibvorgänge, live aufgelöst
Text, textarea und date gehen als String hinaus, numeric, price und unit als Float, select als Optionscode, multi select als Liste von Optionscodes und relation als Liste von SKUs. Die Art kommt aus Ihrem Live-Katalog, nicht aus der Form des Werts, deshalb landet eine Artikelnummer, die numerisch aussieht, trotzdem als Text.
Werte pro Locale
Locale ist eine Eigenschaft der Verbindung, die Sie ziehen. Drei Beschreibungsspalten füllen ein Attribut in drei Sprachen, und die Sprache des Laufs entscheidet über den Standard.
Varianten mit Achsen und Bindings
Markieren Sie auf Quellspalten einen Parent Key, eine oder mehrere Variantenachsen und die Varianten-SKU. Zuerst werden die Simple Products angelegt, dann das Variable Product mit seinen Bindings, was die Reihenfolge ist, die Ergonode verlangt. Achsenwerte, die durch eine ValueMap laufen, lösen trotzdem auf Binding-Codes auf.
Workflow-Status über den kürzesten Pfad
Weil Ergonode den Übergangsgraphen erzwingt, wird der kürzeste Pfad vom aktuellen Status des Produkts zu dem gemappten Status berechnet und Schritt für Schritt gegangen, statt in einem Sprung gesetzt zu werden.
Kategorien aus mehreren Taxonomien
Ein Flow kann mehr als einen Taxonomie-Knoten enthalten. Jeder mappt einen Quellwert auf eine Kategorie, und ein Produkt bekommt die bereinigte Vereinigung von allem, was aufgelöst wurde, in einem Kategorie-Aufruf.
Optionen, angelegt und angereichert
Fehlende Optionen werden mit einem kurzen vorgeschlagenen Code in Kleinbuchstaben angelegt, den Sie pro Wert bearbeiten können. Custom Fields einer Option vom Typ text, textarea und rich text können aus anderen Spalten derselben Zeile gefüllt werden, sodass der lange Pflegetext in einem Custom Field landet und die Option einen lesbaren Namen behält. Optionsnamen sind auf 255 Zeichen begrenzt.
Neue Attribute aus dem Editor
Legen Sie Attribute der Typen text, textarea, numeric, date, select, multi select, unit, price und relation direkt auf der Leinwand an. Ergonode hat keine API, um ein Attribut zu einem Template hinzuzufügen, ein angelegtes Attribut gilt daher instanzweit und Sie fügen es in Ergonode selbst zum Template hinzu. Der Editor sagt Ihnen das in dem Moment, in dem Sie eines anlegen.
Batches, die eine schlechte Zelle überleben
Schreibvorgänge gehen als aliasierte GraphQL-Mutationen hinaus, 25 Operationen pro Request, mit Pausen. Ein abgewiesener Wert kann ein ganzes gebündeltes Dokument scheitern lassen, deshalb wird ein Batch, in dem jede Operation mit dem gleichen Fehler gescheitert ist, Operation für Operation wiederholt. Nur der echte Verursacher scheitert, und Ergonodes eigenes Validierungsdetail steht in der Zeile.
Weiche Fehler bleiben weich
Ein Wert wie nvt auf einem numerischen Attribut wird mit einer Warnung übersprungen, die die SKU nennt. Ein doppelter Wert auf einem Unique-Attribut, etwa ein gemeinsamer Zolltarifcode, wird als Skip verbucht, statt das Produkt scheitern zu lassen. Eine Relation auf eine SKU, die noch nicht existiert, wird aus diesem Schreibvorgang entfernt und in der Warnung genannt, sodass der Rest der Relation trotzdem landet.
Was wir nach Ergonode schreiben können
Select und Multi Select werden auf Optionscodes gemappt, und fehlende Optionen können angelegt und angereichert werden. Ein Preisattribut ist ein einzelner Float, dessen Währung am Attribut in Ergonode konfiguriert ist, und ein Unit-Attribut liest sein Symbol am Attribut.
Was der Ergonode-Connector noch nicht tut
Lesen Sie das lieber vor der Anmeldung, als es in Woche zwei zu entdecken. Jeder Punkt unten ist eine echte Grenze des Ergonode-Connectors von heute.
Bilder, Galerien, Dateien
Medienattribute sind in der Leiste sichtbar, werden aber nicht geschrieben. Custom Fields einer Option vom Typ image werden aus demselben Grund herausgefiltert.
Preise
Ein Ergonode-Preisattribut hält einen Float, und seine Währung ist am Attribut in Ergonode konfiguriert. Eine Währung pro Verbindung, bei der mehrere Spalten in einer Kollektion zusammenlaufen, ist eine Akeneo-Funktion.
Grouping Products
Nur Simple und Variable Products. Grouping Products werden nicht angelegt.
Ein Attribut zu einem Template hinzufügen
Ergonode hat dafür keine API. Ein im Editor angelegtes Attribut existiert instanzweit, und Sie fügen es in Ergonode zum Template hinzu, bevor es in der eingeschränkten Leiste erscheint.
Optionsnamen über 255 Zeichen
Ergonode weist längere Optionsnamen mit einem undurchsichtigen Fehler ab, deshalb werden Namen bei 255 abgeschnitten. Legen Sie den vollständigen Text in ein Custom Field der Option.
Template-Namen
Die Ergonode-API gibt für ein Template keinen Anzeigenamen zurück, deshalb zeigen Picker und Warnungen den Template-Code.
Fragen zu Ergonode und SDM Portal
Wie verbindet sich SDM Portal mit Ergonode?
Ergonode bietet nur GraphQL, unter /api/graphql/. Sie tragen die Instanz-URL und einen API-Key ein, der als X-API-KEY-Header gesendet wird, und die Verbindung wird mit einem echten Handshake geprüft. Der Key wird verschlüsselt gespeichert und ist niemals Teil eines exportierten Mappings.
Kommt SDM Portal mit Ergonode-Varianten zurecht?
Ja. Sie markieren auf Quellspalten den Parent Key, die Variantenachsen und die Varianten-SKU. Zuerst werden die Simple Products angelegt und dann das Variable Product mit seinen Bindings, was die Reihenfolge ist, die Ergonode verlangt. Achsenwerte, die durch eine ValueMap laufen, lösen trotzdem auf Binding-Codes auf.
Kann es den Ergonode-Workflow-Status setzen?
Ja. Ergonode validiert Statusübergänge serverseitig, deshalb berechnet SDM Portal den kürzesten Pfad vom aktuellen Status des Produkts zu dem gemappten Status und geht ihn Schritt für Schritt.
Wie lässt eine schlechte Zelle nicht den ganzen Batch scheitern?
Schreibvorgänge werden als aliasierte GraphQL-Mutationen gebündelt, 25 Operationen pro Request. Ein einzelner abgewiesener Wert kann das ganze gebündelte Dokument scheitern lassen, deshalb wird ein Batch, in dem jede Operation mit dem gleichen Fehler gescheitert ist, Operation für Operation wiederholt. Nur der echte Verursacher scheitert, und der Grund, den Ergonode zurückgegeben hat, steht in der Zeile.
Pusht ein zweiter Lauf alles erneut?
Nein. Jeder Schreibvorgang wird pro Operation gehasht, deshalb meldet ein erneuter Lauf einer unveränderten Datei die Produkte als unverändert und schreibt nichts. Für die Fälle, in denen Sie doch alles erneut pushen wollen, gibt es einen erzwungenen vollständigen Resync.
Nutzen Sie ein anderes PIM?
Editor, Transformationen und Workflow sind für alle gleich. Nur der Schreibpfad unterscheidet sich pro PIM, deshalb hat jeder Connector seine eigene Seite.
Ergonode einmal mappen. Danach läuft es von selbst.
Legen Sie einen Workspace an, verbinden Sie Ihre Ergonode-Instanz und mappen Sie Ihre erste Lieferantendatei. Vierzehn Tage kostenlos, während der Testphase wird Ihre Karte nicht belastet.