Zum Hauptinhalt springen

Zuordnung

Eine Route sagt, was übertragen wird, ihre Auslösung sagt wann. Die Zuordnung beantwortet die dritte Frage: welches Feld auf welches geht – und was geschieht, wenn der Wert fehlt.

Eine Zeile, ein Zielfeld​

Die Zuordnung ist eine Tabelle. Jede Zeile nennt links ein Zielfeld und rechts, was hineinkommt. Bei der Route „Bestellungen Webshop“ liest sich das so:

ZielfeldQuelle
CardCodeOriginalPayload.customer_no
NumAtCardOriginalPayload.order_id
PaymentMethodOriginalPayload.payment

Die rechte Spalte heißt auf dem Bildschirm Quelle, denn dort kann auch etwas anderes als ein Feld stehen.

Drei Sorten, was rechts stehen kann​

Ein Quellfeld. Der Normalfall: OriginalPayload.customer_no liest das Feld customer_no aus der Nachricht des Shops. Die Zelle zeigt einen Pfad, und ein Baum hilft beim Auswählen.

Ein konstanter Wert. Jede Zelle beginnt mit einem kleinen Umschalter; sein Hinweistext sagt Feldverweis gegen Konstanter Wert. Steht die Zelle auf konstant, tippen Sie den Wert selbst ein – Text, Zahl oder Wahrheitswert. Ein Zielfeld, das für jeden Datensatz dasselbe enthalten soll, kommt ohne Quellfeld aus.

Ein selbst erzeugter Wert. Einige Transformationen kommen ohne Quelle aus: ein Zeitstempel des Augenblicks, eine neue Kennung, eine Fallunterscheidung, die aus mehreren Bedingungen den passenden Wert wählt. Bei diesen Zeilen verschwindet die Quellzelle, und an ihrer Stelle steht, was den Wert erzeugt.

Vier Fragen an ein einzelnes Feld​

Ein Tippen auf die Zeile öffnet ihr Detail. Vier Reiter stehen dort, und sie stehen in der Reihenfolge, in der sie wirken.

Zeilendialog mit den vier Reitern und der Transformation der Zeile.

Transformation – der Weg dazwischen​

Manche Werte ändern sich unterwegs. Der Shop schreibt paypal, SAP Business One erwartet PP; diese Umschlüsselung steht in einer Wertetabelle, und die Zuordnungszeile schlägt darin nach.

Eine Zeile kann mehrere Transformationen hintereinander tragen; jede bekommt, was die vorige zurückgegeben hat. So entsteht auch ein Zielfeld aus mehreren Bestandteilen – die Auftragsreferenz für Kessler etwa, die aus dem festen Text CAMBIRA_DE- und dem Schlüssel der Lieferung, 80234, zusammenwächst – gebaut in Ein Zielfeld aus mehreren Quellwerten bilden.

Welche Transformationen es gibt und was jede einzelne verlangt, steht unter Routen – Zuordnung.

Leerer Quellwert – wenn nichts ankommt​

Ein Quellfeld, das in der Nachricht fehlt, ist der häufigste Grund, aus dem eine Zuordnung anders arbeitet als erwartet. Die Zeile entscheidet selbst, was dann gilt, und alle drei Möglichkeiten sagen etwas über die hinausgehende Nachricht: Das Feld geht leer hinaus, es fehlt darin ganz, oder es geht mit einem ausdrücklichen Leerwert hinaus. Was das Zielsystem daraufhin tut, ist seine Sache – Xchange entscheidet nur, was in der Nachricht steht. Wie die drei Stellungen heißen, steht unter Routen – Zuordnung.

Davor lässt sich ein Ersatzwert bei leerem Quellwert setzen: kommt nichts an, springt er ein. Bleibt auch er leer, gilt wieder eine der drei Möglichkeiten.

Diesen Reiter tragen nur Zeilen, die tatsächlich lesen. Ein konstanter und ein selbst erzeugter Wert sind immer gefüllt, und die Oberfläche blendet die Frage dort aus.

Bedingung – ob die Zeile überhaupt wirkt​

Eine Zeile kann an eine Bedingung geknüpft sein und schreibt dann nur, wenn diese zutrifft. Sonst fehlt das Feld in der Nachricht, als gäbe es die Zeile nicht.

Optionen – ob das Feld gebraucht wird​

Hier wird ein Zielfeld zum Pflichtfeld, in zwei Ausführungen: technisch, wenn das Zielsystem dieses Feld verlangt, und fachlich, wenn Ihr Haus darauf besteht. In der Wirkung sind die beiden gleich – beide brechen die Zuordnung ab. Bei einem Abbruch sehen Sie daran, ob das Zielsystem das Feld verlangt oder Ihr Haus.

Die vier greifen ineinander​

Am 7. Oktober 2026 um 16:20 Uhr kam die Bestellung WS-2026-104861 ohne customer_no herein. CardCode ist als Pflichtfeld zugeordnet, also hat Xchange die Zuordnung abgebrochen, statt einen Beleg ohne Geschäftspartner zu schreiben. Der Vorgang liegt in der Manuellen Klärung, Ursache Pflichtfeld ohne Wert in der Ursachengruppe Quelldaten – denn gefehlt hat der Wert im Datensatz, die Zuordnung selbst ist in Ordnung.

Hier hängen der zweite und der vierte Reiter zusammen: die Pflichtprüfung sieht nach, ob das Zielfeld einen Wert trägt – allein darauf kommt es an. Ein leerer Text und ein ausdrücklicher Leerwert zählen dabei als fehlend. Deshalb schützt keine der drei Stellungen unter Leerer Quellwert ein Pflichtfeld: Fehlt der Quellwert, bricht die Zuordnung ab, ob das Feld leer, gar nicht oder mit Leerwert hinausginge. Einspringen kann nur ein Ersatzwert, der tatsächlich etwas liefert.

Der dritte Reiter greift an derselben Stelle ein, nur andersherum: eine Zeile, deren Bedingung nicht zutrifft, wird von der Pflichtprüfung übergangen. Ein Pflichtfeld, das nur unter einer Bedingung gilt, richten Sie deshalb über die Bedingung ein und lassen die Pflicht eingeschaltet.

Wenn am Ziel eine Liste steht​

Ein Beleg besteht aus einem Kopf und seinen Positionen, und die Positionen sind eine Liste. In der Zuordnungstabelle steht dafür eine einzige Zeile; ein Tippen darauf führt eine Ebene tiefer, wo die Felder einer Position ihre eigene Tabelle haben – mit denselben vier Fragen an jedes Feld.

Bei den Bestellungen wird aus OriginalPayload.lines[*] die Liste DocumentLines: je ein Eintrag der Quelle wird eine Position des Belegs. Eine Liste kann ihre Zeilen auch anders bekommen, und sie kann eine Zusatzzeile tragen, die ohne Quelleintrag auskommt. Beides steht unter Routen – Zuordnung.

Die Versandkosten der Bestellungen sind so ein Fall. Der Shop schickt sie als einen Betrag im Kopf, shipping_total, nicht als Position. Eine Zusatzzeile „Fracht“ in derselben Liste macht daraus eine Position: Artikel FRACHT-PAUSCHAL, Menge 1, Preis aus OriginalPayload.shipping_total.

Schlüssel einer Liste​

Beim Anlegen ist jede Position neu. Beim Aktualisieren hat der Datensatz am Ziel schon Positionen, und Xchange muss wissen, welche davon eine Position der Quelle meint. Das sagt der Schlüssel der Liste: ein oder mehrere Felder eines Eintrags, die Sie in der aufgeklappten Liste mit dem Schlüsselsymbol markieren. Ob Xchange eine Position über ihren Schlüssel sucht, legen Sie in den Listeneinstellungen unter Suchen über fest: Markierte Felder oder Nicht suchen.

In „Bestellungen Webshop“ ist das ItemCode. Kommt Bestellung WS-2026-104877 ein zweites Mal, liest Xchange vor dem Schreiben den vorhandenen Beleg, findet darin die Position mit ARM-4711 und ändert ihre Menge. Eine Position mit einem Artikel, den der Beleg noch nicht hat, wird angehängt – oder füllt eine leere Zeile, wenn die Liste unter Leerzeilen Leerzeilen mit neuen Zeilen füllt. Positionen, die nur am Ziel stehen, bleiben, wie sie sind – es sei denn, die Liste ändert sie unter Vorhandene Zeilen. Gelöscht wird nichts.

Was dabei gilt:

  • Nur mit SAP Business One als Ziel. Der Abgleich greift bei Import- und internen Routen und bei Exportrouten an eine SAP-Business-One-Verbindung. Jedes andere Ziel erhält die Liste so, wie sie zugeordnet ist; dort gibt es weder Suchen über und Verknüpfen über noch das Schlüsselsymbol.
  • Ohne Suche wird angehängt. Steht Suchen über auf Nicht suchen, kommt jede Position der Quelle beim Aktualisieren neu hinzu – es sei denn, ihre Verknüpfung findet sie wieder (siehe unten). Das kann gewollt sein, etwa bei einer Liste, die nur wächst.
  • Der Schlüssel gehört zur Zielliste. Schreiben mehrere Listen in dieselbe Zielliste, gilt ein Schlüssel für alle, und jede von ihnen muss seine Felder zuordnen. Dasselbe gilt für Suchen über, Verknüpfen über, Leerzeilen und Vorhandene Zeilen.
  • Auch eine Zusatzzeile wird über den Schlüssel gefunden. Die Zeile „Fracht“ ordnet ItemCode zu, und Xchange findet die Frachtposition über FRACHT-PAUSCHAL wieder.
  • Verglichen wird genau. Groß- und Kleinschreibung zählt, und ein Schlüssel, der sich von einer vorhandenen Position nur darin unterscheidet – Arm-4711 gegen ARM-4711 –, gilt als nicht eindeutig.
  • Was nicht eindeutig ist, wird nicht geschrieben. Ein leeres Schlüsselfeld, derselbe Schlüssel zweimal in der Quelle oder zweimal am Ziel, derselbe Verknüpfungswert zweimal in der Quelle: Der Datensatz landet in der Manuellen Klärung, und die Meldung nennt Feld und Zeile. Zweimal am Ziel zählt nur unter den Zeilen, die mit keiner Zeile derselben Nachricht verknüpft sind.
  • Lässt sich der vorhandene Datensatz nicht lesen, wird nicht geschrieben – auch nicht ersatzweise angehängt. Ändert jemand den Datensatz zwischen Lesen und Schreiben, liest Xchange beim nächsten Versuch neu, sofern das Zielsystem solche Änderungen erkennen lässt.

Ein Schlüssel hängt an Feldern, und Felder ändern sich – in der Quelle wie am Ziel. Ändert sich der Schlüssel einer Position, findet Xchange sie nicht mehr, und der nächste Lauf hängt eine zweite an. Verknüpfen über schließt diese Lücke: Dort steht ein Feld des Quelleintrags, das ihn im Quellsystem eindeutig benennt – sein Wert ist der Verknüpfungswert. Xchange merkt sich nach dem Schreiben, welche Zeile am Ziel zu welchem Verknüpfungswert gehört, und findet sie beim nächsten Lauf über diese Verknüpfung wieder – gleich, was sich an ihren Feldern geändert hat.

Angenommen, der Shop schickt in „Bestellungen Webshop“ je Position eine eigene Kennung mit, line_id, und in den Listeneinstellungen von DocumentLines steht sie unter Verknüpfen über; der Schlüssel bleibt ItemCode. Der Beleg zu WS-2026-104877 entstand vor dieser Einstellung, seine Position mit ARM-4711 ist also noch mit nichts verknüpft.

  • Die Bestellung kommt unverändert noch einmal. Xchange findet die Position über ItemCode, aktualisiert sie und verknüpft sie mit ihrer line_id.
  • Der Kunde tauscht den Artikel. Er ersetzt im Shop ARM-4711 durch ARM-4712, die Position behält ihre line_id. Über ItemCode fände Xchange keine Position mit ARM-4712 und hinge eine zweite an. Die Verknüpfung findet die vorhandene, und Xchange schreibt den neuen Artikel in sie.

Für jede Zeile der Quelle sucht Xchange in dieser Reihenfolge:

  1. Verknüpfung – die Zeile am Ziel, die schon mit diesem Verknüpfungswert verknüpft ist.
  2. Schlüssel – bei Markierte Felder die Zeile mit demselben Schlüssel, unter den Zeilen, die mit keiner anderen Zeile derselben Nachricht verknüpft sind.
  3. Anhängen – findet sich keine, kommt die Zeile neu hinzu.

Danach verknüpft Xchange jede geschriebene Zeile, die einen Verknüpfungswert trägt. Die Verknüpfung wirkt also erst im Lauf danach: Käme der Artikeltausch vor der ersten Verknüpfung, würde die Position angehängt.

Was dabei gilt:

  • Vergeben ist eine Zeile nur an eine Zeile derselben Nachricht. Ist sie mit einem Verknüpfungswert verknüpft, den die Nachricht nicht mehr enthält, findet der Schlüssel sie wieder, und Xchange verknüpft sie neu. Löscht der Kunde eine Position im Shop und legt sie neu an, bekommt sie eine neue line_id; Xchange findet die alte Position über ItemCode und aktualisiert sie, statt eine zweite anzuhängen.
  • Fehlt die verknüpfte Zeile am Ziel, gilt wieder der Schlüssel. Wurde sie in SAP Business One gelöscht, verwirft Xchange die Verknüpfung und sucht über den Schlüssel; findet er nichts, wird angehängt.
  • Die Verknüpfung wird über den Schlüssel gegengeprüft. Steht Suchen über auf Markierte Felder, sucht Xchange auch für eine verknüpfte Zeile ihren Schlüssel. Ändert jemand in SAP Business One den Artikel der verknüpften Position auf ARM-4713, während die Bestellung weiter ARM-4711 nennt, findet der Schlüssel eine andere Zeile, mehrere oder keine. Dann schreibt Xchange den ganzen Datensatz nicht, sondern legt ihn als Suche gegen Objektzuordnung in die Manuelle Klärung – mit einem Punkt je abweichender Zeile. Ändert sich der Schlüssel dagegen in der Quelle, wie beim Artikeltausch oben, gilt die Verknüpfung, und Xchange merkt sich den neuen Schlüssel.
  • Ein leerer Verknüpfungswert verknüpft nichts. Die Zeile wird über den Schlüssel gefunden oder angehängt, wie ohne Verknüpfen über.
  • Mit Nicht suchen trägt allein die Verknüpfung. Eine Zeile ohne Verknüpfungswert oder ohne gespeicherte Verknüpfung wird bei jedem Lauf erneut angehängt. Prüfen weist darauf hin.
  • Nur am Hauptschritt und nur, wo sich Zeilen verknüpfen lassen. Verknüpfen lassen sich Listen, deren Zeilen SAP Business One eine eigene Kennung gibt, etwa die Positionen eines Belegs. An anderen Listen bietet die Oberfläche das Feld Verknüpfen über nicht an.

Was an anderer Stelle entschieden wird​

  • Ob angelegt oder aktualisiert wird, sagt die Schreibabsicht des Schritts – siehe Schreiben ins Zielsystem.
  • Woran das Zielsystem den Datensatz wiedererkennt, sagt die Schlüsselquelle – ebenfalls dort.
  • Wann etwas läuft, sagt der Auslöser der Route – siehe Auslösung.

Siehe auch​