Feld-Mapping

Ein Mapping sagt, welches Feld der Quelle welches Attribut hier wird, und was mit dem Wert unterwegs passiert. Es ist Konfiguration, aber es ist auch die Stelle, an der die Entscheidungen aus Das führende System festlegen aufhören, eine Wiki-Seite zu sein, und anfangen, durchgesetzt zu werden.

Die eine Regel

Mappen Sie nur die Felder, die die Quelle besitzt. Alles, was Sie nicht mappen, ist per Konstruktion geschützt: Kein Lauf kann überschreiben, wovon er nie erfahren hat.

Das ist die stärkste Kontrolle, die Sie haben, und sie kostet nichts. Ein Quellsystem, das zufällig eine Spalte description mitschickt, darf nicht Beschreibungen schreiben, nur weil die Spalte da ist.

Das Mapping bauen

1. Öffnen Sie Data Exchange › Import & Export und öffnen (oder erstellen) Sie das Profil für diesen Feed. Ein Profil beschreibt die Struktur einer Datei oder Nutzlast und ihr Mapping auf Plattformfelder.
2. Laden Sie die Beispiel-Nutzlast. Die Quellfelder erscheinen mit ihren Beispielwerten, und gegen die mappen Sie.
3. Wählen Sie für jedes Feld, das die Quelle besitzt, das Zielattribut. Ordnen Sie über den Attribut-Code zu (thread_size), nicht über die Bezeichnung („Gewindegröße“).
4. Legen Sie die Kennung fest. Dieses Feld entscheidet, ob ein Datensatz angelegt oder aktualisiert wird: die SKU bei Produkten, die Kundennummer bei Organisationen. Stimmt sie, konvergieren Wiederholungsläufe; stimmt sie nicht, erzeugen Wiederholungsläufe Dubletten.
5. Fügen Sie eine Transformation hinzu, wo der Wert nicht in der Form ankommt, in der Sie ihn speichern. Die häufigen Fälle:

   Situation	Transformation
   0004711 hier, 4711 dort	Führende Nullen entfernen, nur auf einer Seite, konsequent
   10,5 aus einem deutschen ERP	Dezimaltrennzeichen zu ., bevor der Wert als Zahl gespeichert wird
   10 bar in einem String	In Wert und Einheit aufteilen für ein Maßattribut
   ST, Stk., Stück bedeuten alle Stück	Über eine Werteliste auf einen Optionscode abbilden
   J / N	Auf Boolean abbilden
   31.12.2026	Mit explizitem Format als Datum parsen
   HTML in einer Beschreibung	Tags entfernen für Kanäle, die Markup ablehnen

6. Entscheiden Sie das Schreibverhalten je Feld: immer aktualisieren, nur anlegen oder nur wenn hier leer. Nutzen Sie nur anlegen für Felder, bei denen die Quelle ein brauchbarer Startpunkt ist, ohne der Eigentümer zu sein; der Artikelname ist der übliche Fall.
7. Legen Sie das Verhalten bei fehlenden Feldern fest. Ein fehlendes Feld und ein leeres Feld sind zwei verschiedene Dinge. Ein fehlendes Feld heißt meist „keine Information“ und sollte den vorhandenen Wert in Ruhe lassen. Ein leeres Feld kann tatsächlich „das hier löschen“ bedeuten. Wählen Sie bewusst, denn wer das verwechselt, hat einen Feed, der 12.000 Beschreibungen in einem Lauf leert.
8. Speichern Sie und führen Sie eine Vorschau gegen die Beispieldaten aus.

Die Vorschau lesen, bevor Sie irgendetwas ausführen

Die Vorschau zeigt, wie jeder gemappte Datensatz nach dem Lauf aussähe. Lesen Sie sie auf die Dinge hin, die keine Fehler werfen:

• Würde ein Feld mit eigener Hoheit überschrieben? Suchen Sie in der Vorschau nach Ihren geschützten Feldern. Taucht dort eine Beschreibung auf, ist Ihr Mapping falsch, egal ob es validiert.
• Passen die Kennungen zu vorhandenen Datensätzen? Zeigt die Vorschau 12.000 Anlagen auf einem Katalog, der schon 12.000 Artikel hält, passt das Kennungsformat nicht. Stopp.
• Stimmen Einheiten und Dezimalstellen? 4.2 kg, 4,2 und 4200 sind für eine Versandkostenberechnung drei verschiedene Produkte.
• Treffen Auswahlwerte vorhandene Optionen, oder kommen sie als neue an? Ein Mapping, das für jede Schreibvariante eine neue Option erfindet, erzeugt einen Filter mit 40 Einträgen, die alle „Edelstahl“ bedeuten.

Was Sie nach dem ersten echten Lauf prüfen

Laufen Sie zuerst gegen einen eingegrenzten Umfang: eine Produktgruppe, oder fünfzig Artikel. Prüfen Sie dann drei Dinge von Hand:

1. Öffnen Sie drei Datensätze im Cockpit und vergleichen Sie sie Feld für Feld mit dem Quellsystem auf einem zweiten Bildschirm. Die Werte, nicht die Zähler.
2. Prüfen Sie einen Datensatz, der schon vor dem Lauf hier war. Hat sich etwas geändert, das sich nicht ändern sollte?
3. Führen Sie denselben Umfang unverändert erneut aus. Das Ergebnis sollten null Anlagen sein und entweder null Aktualisierungen oder dieselben Aktualisierungen noch einmal; siehe die Idempotenzregeln in Integrationsmuster.

Wenn es nicht funktioniert

Weiter

• Einen Workflow bauen: das Mapping einplanen und laufen lassen.
• Häufige Sync-Fehler: die Fehlschläge, die Ihnen begegnen werden.