Zum Hauptinhalt springen

Routen – Zuordnung

Auf dem Reiter Zuordnung legen Sie fest, welches Feld der Quelle in welches Feld des Zielsystems geht und was unterwegs mit dem Wert geschieht. Was Schritte sind und in welcher Reihenfolge eine Route schreibt, steht unter Zuordnung.

Berechtigungen​

Der Reiter gehört zur Route und folgt deshalb der Berechtigung Routen:

Stufe auf RoutenWas Sie auf dem Reiter können
Keinenichts – der Menüpunkt Routen fehlt, und mit ihm dieser Reiter
Nur lesendie Zuordnungen ansehen, die Einstellungen von Schritt, Zeile, Liste und Zusatzzeile schreibgeschützt öffnen und den Testbereich benutzen
Vollzusätzlich Schritte, Zeilen, Listen und Zusatzzeilen anlegen, ändern, umsortieren und löschen

Im Beispiel: A. Vogt hat Voll und baut die Zuordnung von „Bestellungen Webshop“. M. Brandt hat Nur lesen, sieht nach, aus welchem Feld CardCode kommt, und schickt eine Bestellung durch den Testbereich – das Zielsystem bleibt dabei unberührt.

Reiter Zuordnung mit der Leiste Schritte, der Zuordnungstabelle links und dem Testbereich rechts.

Aufbau​

Der Reiter zeigt dieselbe Zuordnungstabelle an drei Stellen: im Schritt, in einer aufgeklappten Liste und in einer Zusatzzeile. Es sind dieselben Zeilen mit denselben Spalten, nur der Ort wechselt.

BereichInhalt
Schrittedie Leiste oben mit allen Schritten der Route; der ausgewählte bestimmt, was darunter steht
Zuordnungszeilelinks die Tabelle Zuordnungen des ausgewählten Schritts, eine Zeile je Zielfeld
Zeileneinstellungenhinter dem Zahnrad jeder Zeile: Transformationen, Leerverhalten, Bedingung, Optionen
Transformationendie 24 Funktionen, die einen Wert unterwegs umformen
Schritteinstellungenwohin und wie der Schritt schreibt
Listen und Zusatzzeileneine Ebene tiefer: die Einträge einer Zielliste
Testbereichrechts, ein- und ausblendbar: eine Beispielnachricht und was die Zuordnung daraus macht

Die Trennlinie zwischen Tabelle und Testbereich können Sie verschieben. Klappen Sie eine Liste oder eine Zusatzzeile auf, erscheint über der Tabelle ein Band mit dem Weg dorthin. Es bleibt beim Blättern stehen, führt über den Rückwärtspfeil (Zurück zum Schritt) zurück und trägt das Zahnrad für die Einstellungen der aufgeklappten Ebene.

Schritte​

Die Leiste Schritte zeigt alle Schritte der Route in der Reihenfolge, in der sie laufen. Den ersten Schritt legt Xchange mit der Route an. Kommt eine Route ohne Schritt in den Entwurf, etwa über einen Import, steht in der Leiste Keine Schritte konfiguriert.

  • Schritt hinzufügen legt einen weiteren Schritt an.
  • Schritteinstellungen öffnet die Einstellungen des ausgewählten Schritts.
  • Schritt löschen liegt im Überlauf der Leiste und entfernt den ausgewählten Schritt samt allen seinen Zuordnungen. Die Rückfrage lautet Der Schritt „…“ und alle seine Zuordnungen werden gelöscht. Diese Aktion kann nicht rückgängig gemacht werden. Eine Route behält immer mindestens einen Schritt; beim letzten antwortet Xchange mit Der letzte Schritt kann nicht gelöscht werden.

Die Zuordnungszeile​

Der Kopf der Tabelle Zuordnungen trägt drei Schaltflächen:

  • Zeile hinzufügen legt eine Zeile an. Hat der Schritt keine Zuordnung, steht beim Öffnen des Reiters schon eine leere Zeile bereit; gespeichert wird sie erst, wenn Sie etwas eintragen.
  • Liste hinzufügen legt eine Liste an.
  • Alle Zuordnungen löschen liegt im Überlauf und leert den Schritt einschließlich aller Listen samt ihren Einträgen. Der Schritt selbst bleibt. Auch das ist endgültig.

Ist die gespeicherte Zuordnung eines Schritts nicht lesbar, zeigt der Reiter statt der Tabelle Die gespeicherte Zuordnung ist nicht lesbar. Sie bleibt unverändert erhalten. Nichts daran lässt sich versehentlich überschreiben; erst Neu aufbauen verwirft sie und beginnt den Schritt neu.

Eine Zeile hat sieben Spalten, von links nach rechts: die laufende Nummer, das Zielfeld, die Quelle, eine Reihe von Symbolen, das Schlüsselsymbol, das Zahnrad und die Schaltfläche zum Entfernen.

Zielfeld. Das Feld im Zielsystem, in das geschrieben wird. Die Auswahl kennt die Struktur des Ziels – bei einer Import- oder internen Route aus dem gewählten Zielendpunkt, bei einer Exportroute aus der Feldstruktur der Anbindung. Liefert die Anbindung keine, tritt die eingefügte Zielstruktur an ihre Stelle; fehlt auch die, sagt die leere Auswahl, was fehlt.

Beschreibt eine OpenAPI-Feldstruktur das Ziel, zeigt die Auswahl die Felder, die der Schritt sendet, und folgt der Schreibabsicht: bei Anlegen die Felder des POST-Aufrufs, bei Aktualisieren die des PATCH-Aufrufs, bei Anlegen oder aktualisieren beide. Felder, die das Ziel nur zurückliefert, fehlen darin. Nennt die Feldstruktur für den Aufruf keinen Inhalt, zeigt die Auswahl die Felder der Leseantwort. Suchfeld im Zielsystem und Anzeigefeld wählen Sie immer aus der Leseantwort.

Quelle. Woher der Wert kommt. Die Schaltfläche am linken Rand des Felds schaltet zwischen zwei Arten um:

  • Pfad – ein Feld der Quelldaten, z. B. OriginalPayload.customer_no. Der erste Teil sagt, woher: OriginalPayload ist der Datensatz, wie das Quellsystem ihn geliefert hat, Enrichments sind die Zusatzdaten. Die Auswahl kennt die Felder der Quelle, sobald der Reiter Quelldaten sie ermittelt hat.
  • Konstante – ein fester Wert, den Sie eintragen.

Zeigt der Pfad auf eine Liste, erscheint daneben die Auswahl Listenwerte: Einzelwert, Summe oder Anzahl der Einträge. Die Schaltfläche Listenwerte filtern öffnet den gleichnamigen Dialog, der die Zusammenfassung auf einen Teil der Einträge beschränkt.

Manche Transformationen erzeugen den Wert selbst und kommen ohne Quelle aus. Dann steht in der Spalte statt des Eingabefelds eine Kurzfassung dessen, was die Zeile tut, z. B. Bedingte Wertermittlung (3 Fälle).

Das Pflichtfeld. Ein Sternchen vor dem Zielfeld markiert ein Pflichtfeld. Der Tooltip sagt, wer es verlangt: Pflichtfeld: Die Zielstruktur verlangt dieses Feld, Pflichtfeld: Ihre Konfiguration verlangt dieses Feld oder Pflichtfeld: Zielstruktur und Ihre Konfiguration verlangen dieses Feld. Dasselbe Sternchen steht vor einer Liste, deren Ziel verlangt wird.

Die Symbole. Zwischen den Spalten und dem Zahnrad liegen zwei feste Plätze. Beide melden Einstellungen, nach denen die Zeile anders arbeitet, als ihre zwei Spalten es vermuten lassen:

PlatzSymbolBedeutung
1DoppelpfeilDer Wert wird unterwegs umgeformt. Der Tooltip nennt die Transformationen.
2TrichterAn einer Feldzeile oder Zusatzzeile: Eine Bedingung entscheidet, ob sie geschrieben wird. An einer Liste: Ein Filter legt fest, welche Elemente die Liste behält. Der Tooltip sagt, welches von beiden gilt.

An einer Liste bleibt Platz 1 leer, weil eine Liste keine Transformation trägt.

Die Warnzeichen. Ein Warnzeichen steht dort, wo ein Befund liegt, den Sie an dieser Stelle nicht sehen. Das Symbol trägt die Schwere: rot für einen Fehler, orange für etwas zu Prüfendes, grau für eine fehlende Angabe. Kommt Verschiedenes zusammen, zeigt es das Schwerste. Eine Zahl trägt es nicht – es sagt, wo Sie hinschauen sollen, nicht wie viel dort liegt.

WoWas darunter liegt
In der Ecke eines Schritts in der Leiste SchritteEin Befund in diesem Schritt. Der Tooltip lautet Dieser Schritt hat Validierungsprobleme.
Neben dem Namen einer Liste oder ZusatzzeileEin Befund in einer ihrer eigenen Zeilen, die sie verbirgt, z. B. Diese Liste enthält fehlerhafte Einträge.
Neben dem Zahnrad einer FeldzeileEin Befund in den Einstellungen der Zeile, den die Zeile selbst nicht zeigt.
In der Ecke einer Station, in den Einstellungen der ZeileEin Befund an dieser Transformation. Der Tooltip lautet Diese Transformation hat Validierungsprobleme.

Was eine Feldzeile selbst betrifft, zeigt sie direkt am Feld, rot, sobald Sie sie bearbeitet haben. Gesammelt stehen alle Befunde unter Meldungen in der Fußzeile.

Das Schlüsselsymbol. Es erscheint nur an den Zeilen innerhalb einer Liste und markiert dort den Schlüssel der Liste. Den Schlüssel des Datensatzes selbst – seine Adresse im Zielsystem – legen Sie nicht an einer Zeile fest, sondern in den Schritteinstellungen.

Umsortieren. Zeilen lassen sich mit der Maus verschieben. Die Reihenfolge ist die, in der geschrieben wird.

Zuordnungszeilen mit Zielfeld, Quelle, dem Sternchen für ein Pflichtfeld und dem Symbol für eine Transformation.

Was eine Zeile sonst noch trägt​

Das Zahnrad am rechten Rand öffnet die Einstellungen der Zeile. Sie sind auch mit einer Leseberechtigung zu öffnen, denn nur hier ist zu sehen, was auf der Zeile eingestellt ist. Sie sind auf vier Reiter verteilt: Transformation, Leerer Quellwert, Bedingung und Optionen. Im Fuß blättern Zurück und Weiter zur vorigen und nächsten Zeile, ohne den Dialog zu schließen; Fertig schließt ihn.

Einstellungen einer Zeile mit den Reitern Transformation, Leerer Quellwert, Bedingung und Optionen.

Hervorgehoben ist das Zahnrad, wenn dahinter etwas eingestellt ist, das nur dort sichtbar ist – ein Ersatzwert, ein Leerverhalten außer dem Normalfall, unter Schreiben etwas anderes als Immer oder der Ausschluss aus der Änderungserkennung. Der Tooltip lautet dann Zeileneinstellungen – diese Zeile trägt Einstellungen, die hier nicht angezeigt werden.

Trägt einer dieser Reiter eine Marke, wartet dort etwas. Der Tooltip sagt, was: Enthält Fehler, Enthält Warnungen oder Hat fehlende Angaben. Dieselbe Marke steht an den Reitern der übrigen Einstellungen dieses Bildschirms.

Transformationen. Der Wert kann mehrere Stationen durchlaufen; jede gibt ihr Ergebnis an die nächste weiter. Liegt keine darauf, steht dort Keine Transformation – der Quellwert wird unverändert übernommen. Funktionen, die ohne Quelle auskommen, sind nur an der ersten Station wählbar.

Leerverhalten. Was mit dem Feld geschieht, wenn nach allen Stationen nichts übrig ist. Drei Stellungen, und alle drei sprechen über die hinausgehende Nachricht:

StellungWirkung
Unverändert übertragenDas Feld geht leer hinaus. Voreinstellung.
Nicht übertragenDas Feld fehlt in der Nachricht ganz.
Null schreibenDas Feld geht mit einem ausdrücklichen Leerwert hinaus.

Der Unterschied zwischen den letzten beiden zählt bei Zielsystemen, die ein fehlendes Feld anders behandeln als ein leeres – viele lassen ein fehlendes Feld unverändert stehen und überschreiben bei einem leeren. Was dort daraufhin geschieht, entscheidet das Zielsystem; Xchange entscheidet nur, was in der Nachricht steht.

Zusätzlich können Sie einen Ersatzwert einschalten, der bei leerem Quellwert einspringt. Er ist wie die Quelle wahlweise ein Pfad oder eine Konstante; eine Konstante trägt den Werttyp Text, Zahl oder Wahrheitswert. Der Ersatzwert hat eine eigene Kette von Transformationen. Bleibt auch er leer, greift wieder die gewählte Stellung. Ist eines von beiden gesetzt, ist das Zahnrad der Zeile hervorgehoben.

Eine Zeile, deren Quelle eine Konstante ist oder die ohne Quelle auskommt, hat keinen leeren Quellwert; ihr fehlt der Reiter Leerer Quellwert.

Zwei Ersatzwerte, zwei Anlässe

Der Ersatzwert hier greift, wenn die Quelle nichts liefert. Der Ersatzwert einer Wertetabelle greift, wenn ein vorhandener Wert in der Tabelle fehlt. Sie können beide an derselben Zeile haben, und beide wirken nebeneinander. Siehe Wertetabellen.

Pflichtfeld. Erklärt das Feld zur Pflicht. Fehlt der Wert, bricht die Zuordnung ab, statt einen unvollständigen Datensatz zu schreiben. Ein leerer Text und ein Leerwert zählen als fehlend, gleich welches Leerverhalten die Zeile trägt; nur ein Ersatzwert, der etwas liefert, füllt das Feld. In „Bestellungen Webshop“ ist CardCode so gesetzt – eine Bestellung ohne Kundennummer landet deshalb in der Manuellen Klärung mit der Ursache Pflichtfeld ohne Wert, statt einen Beleg ohne Geschäftspartner zu erzeugen.

Dafür gibt es zwei Kästchen mit derselben Wirkung; sie unterscheiden sich darin, wer die Pflicht verlangt: Technisch, wenn die Zielstruktur das Feld verlangt, und Fachlich, wenn Ihre Konfiguration es verlangt. Bei einer Import- oder internen Route setzt Xchange Technisch selbst, weil es die Struktur von SAP Business One kennt – das Kästchen ist dort schreibgeschützt. Bei einer Exportroute setzen Sie beide selbst.

Bedingung. Entscheidet, ob die Zeile geschrieben wird – eine Gruppe mit bis zu 10 Bedingungen, verknüpft mit UND oder ODER. Ist eine gesetzt, trägt die Zeile den Trichter auf Platz 2.

Schreiben. Wann die Zeile in die Nachricht kommt: Immer (Voreinstellung), Nur beim Anlegen oder Nur beim Ändern. Entscheidend ist, ob Xchange den Datensatz im Ziel anlegt oder einen vorhandenen ändert – nicht die Ereignisart der Quelle. Schickt der Shop den Wunschtermin des Kunden mit, bekommt DocDueDate in „Bestellungen Webshop“ Nur beim Anlegen: Findet die Suche den Beleg schon vor, geht das Feld nicht mit, und der Termin, den der Innendienst zugesagt hat, bleibt stehen. Siehe Ein Feld nur beim Anlegen schreiben.

Die Zeilen einer Liste folgen bei SAP Business One ihrer eigenen Zeile am Ziel: Eine gefundene Zeile wird geändert, eine angehängte angelegt. Bei einem REST-Ziel und in einem neu angelegten Datensatz folgen sie dem Datensatz. Ein Pflichtfeld gilt nur, wo die Zeile gesendet wird – ein Feld Nur beim Anlegen, das beim Ändern leer bleibt, bricht die Zuordnung nicht ab. Die Einstellung gibt es nur an Schritten, die schreiben, und nicht an der einen Zuordnung einer Werteliste; dort stellen Sie sie an der Liste ein. An einem Feld einer Zusatzzeile gilt sie für dieses Zielfeld in allen Einträgen der Liste, denn die Nachricht hält nicht fest, aus welcher Zeile ein Eintrag stammt.

Sichtbar ist Schreiben nur, wo die Schreibabsicht eine Wahl lässt – also unter Anlegen oder aktualisieren. Unter Anlegen oder Aktualisieren wird jede Zeile auf dieselbe Weise geschrieben, und die Einstellung fehlt. Die Ausnahme ist ein Feld in einer Liste bei SAP Business One unter Aktualisieren: Auch an einem geänderten Datensatz wird eine angehängte Zeile angelegt, die Wahl wirkt dort also weiter. Ein gespeicherter Wert, der nie gesendet wird, bleibt mit seiner Meldung sichtbar; Sie stellen ihn selbst um.

Prüfen meldet an dieser Einstellung:

MeldungBedeutung
„Schreiben“ ist wirkungslos – der Schritt legt keine Datensätze anDie Schreibabsicht ist Aktualisieren, und das Feld steht nicht in einer Liste bei SAP Business One.
„Schreiben“ ist wirkungslos – der Schritt ändert keine DatensätzeDie Schreibabsicht ist Anlegen.
„Schreiben“ schützt das Feld nicht – „Endpunkt zum Ändern“ ersetzt den ganzen DatensatzDer Schritt ändert im Sammelaufruf mit PUT, das den ganzen Datensatz ersetzt.
„Schreiben“ widerspricht der Liste – Feld wird nie gesendetDas Feld steht in einer Liste, die selbst nur in einem der beiden Fälle geschrieben wird, und verlangt den anderen.
„Schreiben“ weicht vom selben Feld in einer anderen Zeile der Liste abDasselbe Zielfeld steht in einer anderen Zeile der Liste, etwa einer Zusatzzeile, auf einem anderen Wert. Es gilt aber für alle Einträge gleich.

Änderungserkennung. Jede Zuordnung zählt in den Vergleich, der entscheidet, ob sich ein Datensatz seit der letzten Übertragung verändert hat. Über Feld ausschließen nehmen Sie eine einzelne Zeile heraus – etwa einen Zeitstempel, der sich ohnehin bei jedem Lauf ändert. Eine ausgeschlossene Zeile löst keine Übertragung aus; wird der Datensatz wegen eines anderen Felds übertragen, geht sie mit. Schließen Sie alle aus, weist die Oberfläche darauf hin, dass dann nie eine Änderung erkannt wird. Siehe Nur Geändertes übertragen.

Verglichen wird die Nachricht, die der nächste Lauf sendet – unter der Schreibabsicht Anlegen die beim Anlegen, sonst die beim Ändern. Fehlt die Zeile in dieser Nachricht, etwa ein Feld Nur beim Anlegen an einem Schritt, der auch ändert, entfällt die Einstellung. Ein gesetzter Ausschluss bleibt gespeichert und gilt wieder, sobald die Zeile wieder in der Nachricht steht.

Die Transformationen​

24 Funktionen in sechs Gruppen. Die Reihenfolge der Gruppen ist die der Auswahl.

GruppeFunktionWas sie tut
NachschlagenWertetabellenSchlägt den Wert in einer Wertetabelle nach.
Bedingte WertermittlungPrüft Fälle der Reihe nach und nimmt den ersten, der zutrifft; sonst den Sonst-Wert. Die Bedingung eines Falls hat bis zu 3 Gruppen mit je bis zu 10 Bedingungen, jede Gruppe mit eigenem UND / ODER; zwischen den Gruppen gilt immer ODER. Jeder Fall und Sonst können eine eigene Transformation tragen.
Erster vorhandener WertPrüft Alternativen der Reihe nach und nimmt die erste, die einen Wert liefert. Jede Alternative kann eine eigene Transformation tragen. Siehe Wenn mehrere Werte in Frage kommen.
DatumDatum formatierenBringt ein Datum in ein anderes Format, z. B. ISO-Datum (JJJJ-MM-TT) oder Kalenderwoche (KW).
In Datum umwandelnLiest einen Text als Datum.
In Datum/Uhrzeit umwandelnLiest einen Text als Zeitpunkt.
Nächster StichtagSetzt den nächsten festen Stichtag ab dem Datum ein, z. B. das Saisonende am 30.06.
TypkonvertierungIn Dezimalzahl umwandelnLiest einen Text als Dezimalzahl; das Dezimaltrennzeichen geben Sie an.
In Ganzzahl umwandelnLiest einen Text als ganze Zahl.
In Wahrheitswert umwandelnLiest einen Text als wahr oder falsch.
ZeichenketteVerkettenSetzt mehrere Bestandteile zu einem Wert zusammen.
HerausschneidenNimmt einen Ausschnitt ab einem Zeichen, über eine Anzahl von Zeichen.
AufteilenZerlegt den Wert an einem Trennzeichen und nimmt einen Teil.
ErsetzenErsetzt einen Suchtext durch einen Ersatztext; ohne Ersatztext wird er entfernt.
Umschließende Leerzeichen entfernenEntfernt Leerzeichen am Anfang und am Ende.
In Großbuchstaben umwandelnSchreibt den Wert groß.
In Kleinbuchstaben umwandelnSchreibt den Wert klein.
ArithmetikAddierenZählt einen Summanden hinzu.
SubtrahierenZieht einen Subtrahenden ab.
MultiplizierenMultipliziert mit einem Faktor.
DividierenTeilt durch einen Divisor.
Wert erzeugenAktueller ZeitstempelSetzt den Zeitpunkt der Übertragung ein, in der Zeitzone der Systemeinstellungen und mit ihrem Versatz zu UTC, z. B. 2026-10-17T00:30:00+02:00.
Neue GUIDErzeugt eine neue eindeutige Kennung.
ObjekttypSetzt den Objekttyp eines SAP-Business-One-Objekts ein.
UmgebungskennungSetzt die Kennung der Umgebung ein, in der Xchange läuft.

Die vier Rechenfunktionen nehmen ihren zweiten Wert wahlweise fest oder aus einer Wertetabelle – nützlich, wenn der Faktor vom Wert eines anderen Felds abhängt.

Wie ein Datum gelesen wird. Die Datumsfunktionen erkennen die üblichen Schreibweisen (2027-01-10, 10.01.2027, ein Zeitpunkt wie 2027-01-10T08:00:00Z). Ein Datum mit Schrägstrich wie 05/12/2026 lesen sie nach der Einstellung Datumsangaben mit Schrägstrich der Anbindung (Schreibweise der Daten). Von einem Zeitpunkt zählt das Datum, das darin steht. Bei In Datum umwandeln und In Datum/Uhrzeit umwandeln legen Sie mit Quellformat ein festes Muster fest, wenn das System anders schreibt; ist es gesetzt, gilt nur dieses.

Nächster Stichtag. Sie wählen Tag und Monat des Stichtags. Mit dem 30.06. wird aus dem 16.10.2026 der 30.06.2027. Fällt das Datum genau auf den Stichtag, ist es selbst das Ergebnis – aus dem 30.06.2026 wird der 30.06.2026. Soll in diesem Fall der Stichtag des Folgejahres gelten, haken Sie Stichtag selbst nicht mitzählen an. Einen Tag, den es im gewählten Monat nie gibt, etwa den 31.06., meldet die Prüfung am Feld Tag. Der 29.02. ist erlaubt und wird in Jahren ohne diesen Tag zum 28.02.

Wie Sie eine dieser Funktionen in einem echten Fall einsetzen, zeigt Werte umwandeln und umschlüsseln.

Wohin geschrieben wird​

Die Schaltfläche Schritteinstellungen in der Schrittleiste öffnet die Einstellungen des gewählten Schritts. Sie gelten für den ganzen Schritt und verteilen sich auf die Reiter Allgemein, Bedingung, Zielstruktur, Antwortstruktur und – an einem schreibenden Schritt – Sammelaufruf.

Schritteinstellungen mit dem Reiter Allgemein: Name, Modus, Schreibabsicht, Zielendpunkt und Schlüsselquelle.

Allgemein​

FeldWas es festlegt
NameWie der Schritt in der Leiste Schritte heißt, höchstens 150 Zeichen. Pflichtfeld, sobald die Route mehr als einen Schritt hat.
KennungUnter welchem Namen andere Schritte auf seine Antwort zugreifen.
ModusOb der Schritt schreibt oder nur liest.
HauptschrittOb dieser Schritt das Hauptobjekt der Route schreibt.
AusführungNicht am Hauptschritt: ob der Schritt Einmal je Nachricht läuft oder Je Element einer Liste der Nachricht. Der Wechsel fragt nach, wenn er Angaben entfernt – zu Je Element die des Sammelaufrufs, zu Einmal Liste und Elementschlüssel.
Liste und ElementschlüsselNur bei Je Element: die Liste, deren Einträge der Schritt einzeln bearbeitet, z. B. OriginalPayload.persons[*], und das Feld, das jeden Eintrag eindeutig benennt.
SchreibabsichtOb angelegt, aktualisiert oder beides erlaubt ist.
ZielendpunktDie Sammlung im Zielsystem, in die angelegt wird, höchstens 254 Zeichen: bei einer Exportroute ein Pfad der API des Zielsystems, z. B. products, bei einer Import- oder internen Route ein Pfad des Service Layer, z. B. Items. Er trägt keinen Schlüsselplatzhalter – die Adresse eines einzelnen Datensatzes steht im Einzelziel-Endpunkt.
Einzelziel-EndpunktNur bei Aktualisieren und Anlegen oder aktualisieren: die Adresse eines einzelnen Datensatzes, mit einem Platzhalter für seinen Schlüssel, z. B. products/{{key}}. Bei einem REST-Ziel schlägt das Feld grau eine Adresse aus dem Zielendpunkt vor; bleibt es leer, gilt dieser Vorschlag. Schlüssel einfügen daneben setzt einen Platzhalter an die Schreibmarke und legt die passende Zeile Schlüssel an. Bei SAP Business One steht die Adresse fest, z. B. Items('{{ItemCode}}'), und lässt sich nicht ändern.
SchlüsselquelleWoher der Schlüssel kommt: Zuordnung oder Quelle, Antwort des Zielsystems, Suche im Zielsystem oder Kein Schlüssel.
Schlüssel und WertNur bei Zuordnung oder Quelle: eine Zeile je Platzhalter im Einzelziel-Endpunkt. Wert wählt, was eingesetzt wird – unter Zuordnungen den Wert einer Zuordnungszeile, wie er nach ihren Transformationen ins Ziel geht, oder ein Feld der Quelldaten. Eine Zeile, deren Platzhalter es nicht mehr gibt, steht rot und lässt sich mit Schlüssel entfernen löschen.
Suchfeld im Zielsystem und Suchwert aus der QuelleNur bei Suche im Zielsystem: wonach gesucht wird und womit. Der Suchwert kommt aus den Quelldaten oder unter Zuordnungen aus einer Zuordnungszeile.
SchlüsselfeldNur bei Suche im Zielsystem: das Feld des gefundenen Datensatzes, unter dem das Zielsystem ihn führt, z. B. id. Daraus liest Xchange die Adresse, an die geschrieben wird. Kennt die Zielstruktur es, steht es fest; sonst tragen Sie es ein.
Entnehmen ausBei Antwort des Zielsystems: ob der Schlüssel in den Antwortdaten steht oder in einer Kopfzeile der Antwort. Kopfzeile steht zur Wahl, wenn die Anbindung Kopfzeilen der Antwort auswerten kann. Am Hauptschritt einer Exportroute erscheint das Feld auch bei Suche im Zielsystem, sofern die Schreibabsicht nicht Aktualisieren ist – dann sagt es, wo der Schlüssel eines neu angelegten Datensatzes steht.
Pfad in den AntwortdatenBei Antwortdaten: wo der Schlüssel steht, z. B. id. Die Auswahl kennt die Felder der Antwortstruktur.
Name der Kopfzeile und Wert übernehmenBei Kopfzeile: welche Kopfzeile den Schlüssel trägt, z. B. Location (höchstens 254 Zeichen), und ob ihr Wert Vollständig übernommen wird oder als Letzter Pfadabschnitt – aus …/orders/4711 also 4711.
AnzeigefeldNur am Hauptschritt einer Export- oder internen Route, unter Datensatzkennung: das Feld des geschriebenen Datensatzes, an dem Sie ihn im Zielsystem erkennen, z. B. orderNumber. Der Verlauf zeigt seinen Wert unter Datensätze neben dem externen Schlüssel. Es dient nur der Anzeige und ist nie Pflicht. Kennt die Zielstruktur ein solches Feld, ist es vorbelegt; Auf abgeleiteten Wert zurücksetzen stellt diesen Wert nach einer Änderung wieder her.

Der Schlüssel aus den Zeilen Schlüssel und Wert geht allein in die Adresse. Ist sein Wert eine Zuordnungszeile, steht diese Zeile trotzdem im geschriebenen Datensatz.

Prüfen meldet an diesen Feldern:

MeldungBedeutung
„Zielendpunkt“ darf keinen Schlüsselplatzhalter enthalten – den Pfad mit Schlüssel als „Einzelziel-Endpunkt“ eintragenDer Zielendpunkt trägt einen Platzhalter wie {{key}}.
„Einzelziel-Endpunkt“ enthält keinen SchlüsselplatzhalterDie Adresse im Einzelziel-Endpunkt nennt keinen Schlüssel und träfe damit keinen bestimmten Datensatz.
PflichtfeldEine Zeile Schlüssel hat keinen Wert. In der Prüf-Liste steht dazu Zeile N: „Wert“ fehlt.
Diesen Schlüsselteil kennt die Adresse des Datensatzes nicht mehr – Zeile entfernenDer Platzhalter der Zeile steht nicht mehr im Einzelziel-Endpunkt.
Das Zielsystem kann den Datensatz nicht lesen – andere Schreibabsicht wählenBei Anlegen oder aktualisieren mit Zuordnung oder Quelle liest Xchange den Datensatz vor dem Schreiben, und die Feldstruktur des Ziels beschreibt für diese Adresse kein Lesen. Die Meldung steht an der Schreibabsicht.
Nach dem Anlegen lässt sich der Schlüssel nicht ermitteln – angeben, wo er in der Antwort stehtBei Suche im Zielsystem braucht Xchange nach dem Anlegen den Schlüssel des neuen Datensatzes, und die Feldstruktur des Ziels nennt ihn nicht. Geben Sie unter Entnehmen aus an, wo er in der Antwort steht.
Ungültiger FeldpfadDas Anzeigefeld ist kein gültiger Feldpfad.
„Anzeigefeld“ existiert in der Feldstruktur nichtDie Zielstruktur kennt das Anzeigefeld nicht.

Was diese Einstellungen für das Ergebnis bedeuten – und warum eine leere Suche stillschweigend Doppelte erzeugt – steht unter Schreiben ins Zielsystem und Doppelte vermeiden und aufklären.

Bedingung​

Entscheidet, ob der Schritt für einen Datensatz überhaupt läuft – eine Gruppe mit bis zu 10 Bedingungen, verknüpft mit UND oder ODER. Trifft sie nicht zu, überspringt Xchange den Schritt für diesen Datensatz: Er schreibt dann nichts, und das gilt als ordnungsgemäß. Ohne Bedingung läuft der Schritt immer.

Lässt sich die Bedingung für einen Datensatz nicht auswerten – meist weil sie auf ein Feld verweist, das dieser Datensatz nicht führt –, landet der Vorgang in der Manuellen Klärung mit der Ursache Schrittbedingung fehlerhaft.

Zielstruktur und Antwortstruktur​

Die Zielstruktur gibt es nur an einem schreibenden Schritt. Sie zeigt ein Beispiel dessen, was der Schritt ins Zielsystem schreibt. Kann Xchange die Struktur des Ziels lesen, füllt es sie selbst vor; sonst fügen Sie ein Beispiel ein. Zuordnungen generieren im Fuß des Dialogs legt daraus für jedes Feld und jede Liste eine Zuordnungszeile an – was schon zugeordnet ist, bleibt, wie es ist. Ab 50 neuen Zeilen fragt Xchange vorher nach.

Die Antwortstruktur zeigt ein Beispiel dessen, was das Zielsystem auf den Schritt antwortet. Liefert das Zielsystem beim Schreiben keinen Datensatz zurück, liest Xchange ihn danach nach. Aus ihr kennen die folgenden Schritte die Felder, die sie aus dieser Antwort übernehmen können, und der Testbereich legt sie als Antwort vor. Aus letztem Lauf übernehmen setzt die Antwort des letzten erfolgreichen Laufs ein; gab es noch keinen, sagt Xchange Für diesen Schritt liegt noch kein erfolgreicher Lauf vor. Am letzten Schritt bleibt die Antwort ohne Folgeschritt, und ein Hinweis unter dem Editor sagt das.

Sammelaufruf​

Gibt es nur an einem schreibenden Schritt. Hier legen Sie fest, ob der Schritt mehrere Datensätze in einem Aufruf an das Zielsystem sendet statt jeden einzeln. Jeder Datensatz bleibt dabei ein eigener Vorgang – mit eigenem Ergebnis, eigener Wiederholung und eigenem Eintrag in der Manuellen Klärung.

FeldWas es festlegt
AufrufEinzeln – die Vorgabe – sendet jeden Datensatz in einem eigenen Aufruf. Gesammelt sendet mehrere Datensätze in einem Aufruf und beginnt mit 100 Datensätzen je Aufruf. Zurück auf Einzeln bleiben die Angaben zum Sammelaufruf erhalten, sie greifen nur nicht.
Datensätze je AufrufNur bei Gesammelt: wie viele Datensätze höchstens in einem Aufruf hinausgehen, 2 bis 1000 – ein einzelner Datensatz je Aufruf ist Einzeln. Xchange erhöht den Wert nie von selbst.

Bei SAP Business One genügen diese beiden Felder. Xchange bündelt die Datensätze in einem Aufruf, schreibt aber jeden für sich: Ein abgelehnter Datensatz hält die übrigen nicht auf, und keiner wartet auf das Ergebnis eines anderen. Halten Sie die Zahl trotzdem maßvoll – SAP rät von langen Sammelaufrufen ab, und ein großer Aufruf belegt den Service Layer entsprechend lange. Daran erinnert der Hinweis unter Datensätze je Aufruf.

Bei einem REST-Ziel beschreiben Sie zusätzlich, wie das Zielsystem den Aufruf erwartet. Die Felder erscheinen bei Gesammelt, unterteilt in Anfrage und Antwort:

FeldWas es festlegt
Endpunkt zum AnlegenMethode (POST, PUT oder PATCH) und Pfad, unter dem das Zielsystem mehrere neue Datensätze auf einmal annimmt, z. B. POST und products/batch. Nicht bei der Schreibabsicht Aktualisieren.
Endpunkt zum ÄndernDasselbe für Änderungen. Nicht bei der Schreibabsicht Anlegen.
Liste der EinträgeUnter welchem Feld der Anfrage die Liste der Datensätze steht, z. B. items.
Schlüssel im EintragNicht bei der Schreibabsicht Anlegen: unter welchem Feld ein Eintrag den Schlüssel seines Datensatzes trägt, z. B. key. Hinein kommen die Werte der Zeilen Schlüssel und Wert unter Allgemein.
Daten im EintragUnter welchem Feld ein Eintrag den Datensatz selbst trägt, z. B. fields. Leer: Der Eintrag ist der Datensatz.
Liste der ErgebnisseUnter welchem Feld der Antwort die Ergebnisse stehen, eines je Eintrag, z. B. results.
Position im ErgebnisWelches Feld eines Ergebnisses sagt, zu welchem Eintrag es gehört, z. B. index. Leer: Die Ergebnisse folgen der Reihenfolge der Anfrage.
Status im ErgebnisWelches Feld eines Ergebnisses den HTTP-Status dieses einen Eintrags trägt, z. B. status.
Datensatz im ErgebnisWo ein erfolgreiches Ergebnis den angenommenen Datensatz trägt, z. B. item. Leer: das ganze Ergebnis.
Fehler im ErgebnisWo ein abgelehntes Ergebnis seinen Fehler trägt, z. B. problem. Leer: das ganze Ergebnis.

Welcher Endpunkt nötig ist, folgt aus der Schreibabsicht: bei Anlegen der zum Anlegen, bei Aktualisieren der zum Ändern. Bei Anlegen oder aktualisieren genügt einer; bleibt der andere leer, sendet der Schritt die Datensätze dieser Art einzeln – nimmt das Zielsystem etwa nur neue Datensätze gesammelt an, tragen Sie nur Endpunkt zum Anlegen ein.

Kennt die Anbindung die Feldstruktur des Ziels, wählen Sie den Pfad aus der Liste. Xchange setzt dann die passende Methode ein, füllt Liste der Einträge und Liste der Ergebnisse, sofern diese noch leer sind, und die übrigen Felder bieten die Felder der Anfrage und der Antwort zur Auswahl an. Ohne Feldstruktur fügen Sie mit Beispielanfrage einfügen und Beispielantwort einfügen je einen Aufruf mit mindestens einem Eintrag ein; danach stehen dessen Felder zur Auswahl. Gespeichert wird das Beispiel nicht. Solange keines vorliegt, sagt die Auswahl Wählen Sie einen Endpunkt oder fügen Sie ein Beispiel ein.

Jedes Ergebnis zählt für seinen eigenen Datensatz. Ein Status 2xx schließt den Datensatz ab wie ein Einzelaufruf, jeder andere lässt ihn scheitern wie ein Einzelaufruf mit diesem Status – 429 und 5xx wiederholt Xchange, 404, 409 und 422 nicht. Lehnt das Zielsystem den ganzen Aufruf ab, scheitert jeder Datensatz darin mit dieser Antwort. Bleibt der Ausgang offen – die Antwort kam nicht an, oder ein Ergebnis fehlt –, prüft Xchange den betroffenen Datensatz vor einer Wiederholung wie nach einem abgebrochenen Einzelaufruf und sendet ihn danach nur noch einzeln.

Im Beispiel: Artikelexport schreibt Gesammelt mit Datensätze je Aufruf 50 in den Shop. Endpunkt zum Anlegen und Endpunkt zum Ändern stehen beide auf POST und products/batch, der Umschlag ist items / key / fields, die Antwort results / index / status / item / problem. Ein Aufruf sieht so aus:

{"items":[{"key":{"key":"ARM-4711"},"fields":{"sku":"ARM-4711","name":"Einhebelmischer Nordfluss 120"}}]}

Der Shop antwortet mit 200, auch wenn ein Eintrag scheitert:

{"results":[{"index":0,"status":200,"item":{"id":"p-5f2c91","sku":"ARM-4711"}},{"index":1,"status":422,"problem":{"detail":"name: darf nicht leer sein"}}]}

Der erste Datensatz ist geschrieben, der zweite scheitert mit seinem eigenen Fehler; die übrigen Datensätze des Aufrufs berührt das nicht.

Wie viele Datensätze zusammen hinausgehen, bestimmt die Route. Xchange nimmt Vorgänge derselben Route gemeinsam auf, höchstens so viele, wie der kleinste Wert von Datensätze je Aufruf unter ihren Schritten zulässt, und nie zwei Vorgänge desselben Datensatzes. Solange ein Lauf noch Datensätze liest, gehen nur volle Aufrufe hinaus; der Rest folgt, sobald der Lauf alle gelesen hat. Steht nur ein Vorgang an, geht auch er über den Sammelaufruf hinaus, als einziger Eintrag seines Aufrufs. In den Vorgangsdetails steht bei der gesendeten Nachricht, welcher Aufruf den Datensatz getragen hat und der wievielte Teil er darin war.

Prüfen meldet an diesen Feldern:

MeldungBedeutung
Nur ein schreibender Schritt sendet mehrere Datensätze je Aufruf – „Aufruf“ auf „Einzeln“ stellenDer Schritt liest nur, steht aber auf Gesammelt.
Im Sammelaufruf nicht zulässig – Antwortdaten wählenUnter Allgemein steht Entnehmen aus auf Kopfzeile. Ein Ergebnis im Sammelaufruf hat keine Kopfzeilen; am Feld Entnehmen aus steht Im Sammelaufruf nicht zulässig.
Für den Sammelaufruf fehlt der Endpunkt – „Endpunkt zum Anlegen“ oder „Endpunkt zum Ändern“ eintragenBei einem REST-Ziel mit der Schreibabsicht Anlegen oder aktualisieren steht Aufruf auf Gesammelt, aber keiner der beiden Pfade ist eingetragen.
Der Endpunkt nimmt höchstens 0 Datensätze je Aufruf an – „Datensätze je Aufruf“ verringernDie Feldstruktur des Ziels begrenzt die Liste des gewählten Pfads auf weniger Einträge. Statt {0} steht die Grenze.
PflichtfeldAufruf steht auf Gesammelt, aber Datensätze je Aufruf ist leer. Oder bei einem REST-Ziel fehlt der Pfad, den die Schreibabsicht verlangt – bei Anlegen der von Endpunkt zum Anlegen, bei Aktualisieren der von Endpunkt zum Ändern. Oder ein Pfad ist eingetragen, aber Liste der Einträge, Liste der Ergebnisse oder Status im Ergebnis fehlt – bei Endpunkt zum Ändern auch der Schlüssel im Eintrag.
Wert muss zwischen 2 und 1000 liegenDatensätze je Aufruf liegt außerhalb dieses Bereichs.

Listen​

Steht im Ziel eine Liste – etwa die Positionen eines Belegs –, trägt der Schritt dafür eine Zeile mit Listensymbol. Ein Klick darauf führt eine Ebene tiefer, in die Liste hinein; der Weg dorthin steht danach im Brotkrumenband. Dort steht wieder die bekannte Zuordnungstabelle, diesmal für die Felder eines Eintrags. Eine Liste, die Sie mit Liste hinzufügen anlegen, heißt zunächst „Neue Liste“.

An der Zeile der Liste zeigen zwei Symbole, was für sie gilt:

SymbolTooltipBedeutung
FilterFilter: Diese Liste behält nur die Elemente, auf die er zutrifftDie Liste hat einen Filter, siehe unten.
KetteIn eine gemeinsame Zielliste zusammengeführtWeitere Listen schreiben in dieselbe Zielliste.

Im Brotkrumenband steht dann die Schaltfläche Listeneinstellungen. Sie öffnet die Einstellungen der Liste und steht auch ohne Schreibrecht offen – die Felder darin sind dann schreibgeschützt. Die Einstellungen stehen auf den Reitern Allgemein, Filter, Leerzeilen und Vorhandene Zeilen; Filter fehlt bei Feste Zeilen, Leerzeilen und Vorhandene Zeilen erscheinen unter denselben Voraussetzungen wie Suchen über.

Im Überlauf des Brotkrumenbands liegt Liste löschen. Die Rückfrage lautet: „Die Liste „…“ und ihre Zuordnungen werden gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.“

Über der Tabelle der aufgeklappten Liste stehen zwei Schaltflächen. Zeile hinzufügen legt eine Zuordnung für ein Feld des Eintrags an; bei Feste Zeilen fehlt sie. Die zweite legt eine Zusatzzeile an und heißt Zusatzzeile hinzufügen, bei Feste Zeilen Zeile hinzufügen. Kennt Xchange die Felder der Quell-Liste nicht, steht in der Feldauswahl der Hinweis Elementfelder unbekannt – Felder direkt eingeben z. B. Element.Name.

Befüllung. Woher die Einträge kommen – drei Möglichkeiten:

  • Aus Quell-Liste: Für jeden Eintrag der Quell-Liste entsteht ein Eintrag im Ziel. So läuft OriginalPayload.lines[*] in „Bestellungen Webshop“ auf die Belegpositionen.
  • Feste Zeilen: Die Liste hat keine Quelle; jeder Eintrag ist eine Zusatzzeile, die Sie selbst anlegen.
  • Aus Textwert: Ein einzelnes Textfeld wird an einem Trennzeichen zerlegt, jeder Teil wird ein Eintrag. Das Textfeld steht unter Quellfeld, das Zeichen unter Trennzeichen; beide sind Pflicht. So wird in „Kunden Webshop“ aus OriginalPayload.payment_methods mit dem Wert paypal|invoice und dem Trennzeichen | die Liste BPPaymentMethods mit zwei Einträgen.

Ein Wechsel der Befüllung verwirft, was zur bisherigen gehörte; die Rückfrage sagt jeweils, was verlorengeht.

Ergebnistyp. Was ein Eintrag der Zielliste ist:

  • Objektliste: Jeder Eintrag ist ein Objekt mit den Feldern, die Sie ihm zuordnen. Das ist die Vorgabe.
  • Werteliste: Jeder Eintrag ist ein einzelner Wert, etwa ["Fußball", "Tennis"]. Die Liste hat dann genau eine Zuordnung; ihr Zielfeld lautet (Wert des Elements). Pflicht und Leerverhalten stellen Sie an der Liste ein, nicht an der Zuordnung. Liefert die Zuordnung für einen Eintrag keinen Wert, entfällt er.

Kennt das Zielschema die Art der Einträge, wählt Xchange den Ergebnistyp beim Anlegen der Liste vor und meldet in der Prüfung, wenn eine bestehende Liste davon abweicht. Der Wechsel zu Werteliste fragt nach, bevor er Zielfelder, Pflichtangaben und Leerverhalten der Zuordnungen entfernt; Quellen und Transformationen bleiben. SAP Business One hat keine Werteliste als Ziel.

Quell-Liste und Zielliste benennen die beiden Seiten. Innerhalb der Einträge greifen Sie auf Elementfelder, auf die Übergeordnete Zeile und auf den Hauptdatensatz zu – bei einer Quelle aus einfachen Werten zusätzlich auf den Wert des Elements. Bei einer Quell-Liste erscheint er nur, wenn Quellschema, Zusatzdatenabfrage oder Beispieldaten zeigen, dass ihre Einträge einzelne Werte sind.

Filter. Schränkt ein, welche Einträge übernommen werden. Er hat eine einzige Gruppe mit bis zu 10 Bedingungen, verknüpft mit UND oder ODER. Als Vergleiche stehen bereit: ist gleich, ist ungleich, enthält, enthält nicht, beginnt mit, beginnt nicht mit, ist größer als, ist größer oder gleich, ist kleiner als, ist kleiner oder gleich, ist leer, ist nicht leer, enthält Wert. Welche davon eine Zeile anbietet, hängt vom Feld ab: Ein Feld, das mehrere Werte liefert, bietet nur enthält Wert, ist leer und ist nicht leer; ein Feld mit einem einzelnen Wert bietet enthält Wert nicht. Ohne Bedingung werden alle Einträge übernommen.

Pflichtfeld. Technisch und Fachlich wie an einer Zuordnungszeile, für die Liste als Ganzes.

Leerverhalten. Was geschieht, wenn keine Einträge übrig bleiben: Nicht übertragen, Null schreiben oder Leere Liste schreiben.

Schreiben. Dieselbe Auswahl wie an einer Zuordnungszeile, für die ganze Liste: Steht sie auf Nur beim Anlegen, fehlt die Liste beim Ändern ganz in der Nachricht, und ihre Zeilen am Ziel bleiben unberührt. Ein Feld in der Liste kann die Einstellung nur gleich lassen oder enger fassen; verlangt es den anderen Fall, meldet Prüfen den Widerspruch. Sichtbar ist die Einstellung nur unter der Schreibabsicht Anlegen oder aktualisieren – die Ausnahme der Zeile für Felder in einer Liste gilt für die Liste selbst nicht. Ein gespeicherter Wert, der nie gesendet wird, bleibt wie an der Zeile mit seiner Meldung sichtbar.

Suchen über und Verknüpfen über. Woran eine Zeile der Liste beim Aktualisieren ihre Zeile am Ziel wiedererkennt. Beide Felder erscheinen nur, wenn der Schritt in SAP Business One schreibt und seine Schreibabsicht Aktualisieren oder Anlegen oder aktualisieren ist – beim Anlegen ist jede Zeile neu –, und erst, wenn eine Zielliste gewählt ist:

FeldWas es festlegt
Suchen überMarkierte Felder: Die Zeile wird über die Felder gefunden, die Sie mit dem Schlüsselsymbol markieren. Nicht suchen: Eine Zeile, die nicht über ihre Verknüpfung gefunden wird, wird angehängt. Pflichtfeld; anfangs ist nichts gewählt.
Verknüpfen überEin Feld des Quelleintrags, das ihn im Quellsystem eindeutig benennt. Xchange verknüpft jede geschriebene Zeile mit dessen Wert und findet sie beim nächsten Lauf zuerst darüber – auch wenn sich ihre Felder geändert haben. Freiwillig; erscheint nur bei Listen, deren Zeilen sich verknüpfen lassen, etwa den Positionen eines Belegs.

Wie die beiden zusammenwirken, steht unter Zuordnung. Prüfen meldet an diesen Feldern:

MeldungBedeutung
Kein Schlüsselfeld markiertMarkierte Felder ist gewählt, aber keine Zeile trägt das Schlüsselsymbol. Markieren Sie ein Feld oder wählen Sie Nicht suchen.
„Verknüpfen über“ wirkt nur am Hauptschritt – Feld leerenVerknüpft wird nur am Hauptschritt.
Zeilen dieser Liste lassen sich nicht verknüpfen – „Verknüpfen über“ leerenSAP Business One gibt den Zeilen dieser Liste keine eigene Kennung.
„Verknüpfen über“ muss aus dem Listenelement kommen – sonst erhalten alle Zeilen denselben WertDas gewählte Feld liegt außerhalb des Listeneintrags, etwa am Kopf der Nachricht.
„Verknüpfen über“ gilt für alle festen Zeilen gleich – bei mehreren festen Zeilen leer lassenDie Liste besteht aus mehreren Zusatzzeilen, die sich denselben Wert teilen würden.

Der Schlüssel der Liste. In der aufgeklappten Liste steht an jeder Zeile mit Zielfeld das Schlüsselsymbol, sobald Suchen über der Liste auf Markierte Felder steht. Der Tooltip lautet Schlüsselfeld der Zielliste – identifiziert eine vorhandene Zeile beim Aktualisieren. Sie können mehrere Zeilen markieren; zusammen bilden sie den Schlüssel. In „Bestellungen Webshop“ ist ItemCode markiert. Mit Nur lesen sehen Sie das Symbol nur an markierten Zeilen.

Hat die Zielliste einen Schlüssel und schreiben mehrere Listen in sie, steht über der Liste der Hinweis Schlüssel gilt für alle Listen auf mit dem Namen der Zielliste: Markieren Sie ein Feld in einer von ihnen, ist es in allen markiert. Jede Liste, die in eine Zielliste mit Schlüssel schreibt, und jede ihrer Zusatzzeilen muss jedes markierte Feld schreiben, bei festen Zeilen nur die Zusatzzeilen; fehlt eines, meldet Prüfen dort Nicht alle Schlüsselfelder zugeordnet. Was der Schlüssel beim Aktualisieren bewirkt, steht unter Zuordnung.

Leerzeilen. Manche Ziele legen beim Speichern selbst eine leere Zeile am Ende einer Liste an. Voreingestellt ist Unverändert lassen: Neue Zeilen der Nachricht werden darunter angehängt. Mit Mit neuen Zeilen füllen füllt eine neue Zeile zuerst eine solche Leerzeile. Unter Leerzeilen erkennen an legen Sie fest, woran Xchange eine Leerzeile erkennt – eine Gruppe mit bis zu 10 Bedingungen und denselben Vergleichen wie beim Filter, links ein Feld der Zeile am Ziel, rechts ein fester Wert oder ein Feld der Nachricht, meist mit ist leer. Die Bedingung ist Pflicht; bei der Auswahl steht deshalb schon eine leere Bedingungszeile bereit.

Eine Zeile der Nachricht, die weder über ihre Verknüpfung noch über den Schlüssel eine Zeile am Ziel findet, belegt die erste freie Leerzeile; erst wenn keine mehr frei ist, wird sie angehängt. Die belegte Zeile behält ihre Zeilennummer, Felder ohne Zuordnung behalten ihren Wert. Eine Zeile mit Verknüpfung gilt nie als Leerzeile, und übrige Leerzeilen bleiben unverändert – auch die Regel unter Vorhandene Zeilen lässt sie aus. Wechseln Sie zurück zu Unverändert lassen, fragt Xchange nach, bevor es eine ausgefüllte Bedingung entfernt. Prüfen meldet hier:

MeldungBedeutung
Keine Bedingung hinzugefügtMit neuen Zeilen füllen ist gewählt, aber keine Bedingung beschreibt eine Leerzeile.
„Bedingung“ ist ungültigEine Bedingungszeile ist unvollständig oder nennt ein Feld, das die Zielliste nicht hat.

Vorhandene Zeilen. Was beim Aktualisieren mit den Zeilen am Ziel geschieht, die die Nachricht nicht liefert – die also weder über den Schlüssel noch über ihre Verknüpfung einer Zeile der Nachricht zugeordnet werden:

  • Unverändert lassen: Die Zeilen bleiben, wie sie sind. Das ist die Vorgabe.
  • Ändern: Xchange setzt in diesen Zeilen die Felder unter Dann setzen. Gelöscht wird keine Zeile.

Unter Wenn schränken Bedingungen ein, welche dieser Zeilen geändert werden – eine Gruppe mit bis zu 10 Bedingungen und denselben Vergleichen wie beim Filter. Links steht ein Feld der Zeile am Ziel, rechts ein fester Wert oder ein Feld der Nachricht. Ohne Bedingung gilt die Regel für alle diese Zeilen. Unter Dann setzen steht je Zeile ein Zielfeld und sein Wert: ein fester Wert oder ein Feld der Nachricht, auf Wunsch mit Transformation. Felder des Listeneintrags stehen dort nicht zur Auswahl, denn eine nicht gelieferte Zeile hat keinen.

In „Kunden Webshop“ steht an der Liste ContactEmployees Ändern ohne Bedingung, darunter Dann setzen mit Active = tNO. Fehlt ein Ansprechpartner im nächsten Datensatz des Shops, bleibt er in SAP Business One bestehen und wird inaktiv gesetzt.

Die Regel greift nur, wenn die Liste in der Nachricht steht. Fehlt sie – etwa mit Nicht übertragen oder Nur beim Anlegen –, bleibt jede Zeile unberührt. Geht sie mit Leere Liste schreiben hinaus, gilt jede vorhandene Zeile als nicht geliefert. Der Wechsel zurück auf Unverändert lassen fragt nach, bevor er die Regel entfernt. Prüfen meldet auf diesem Reiter:

MeldungBedeutung
Kein zu setzendes Feld hinzugefügtÄndern ist gewählt, aber unter Dann setzen steht kein Feld. Fügen Sie eines hinzu oder wählen Sie Unverändert lassen.
Schlüssel- und Verknüpfungsfelder lassen sich hier nicht setzen – anderes Feld wählenDas Zielfeld gehört zum Schlüssel der Liste, zu ihrer Verknüpfung oder zur Kennung, die SAP Business One der Zeile gibt.
„Bedingung“ ist ungültigEine Bedingung unter Wenn ist unvollständig oder vergleicht auf eine Weise, die hier nicht zur Verfügung steht.

Wie Sie einen Beleg zuordnen, dessen Ziel anders schneidet als die Quelle, zeigt Kopf und Positionen zuordnen.

Aufgeklappte Liste mit dem Weg dorthin und den Zuordnungen ihrer Einträge.

Zusatzzeilen​

Innerhalb einer Liste können Sie Einträge ergänzen, die über die Quelle hinausgehen – etwa die Position „Fracht“ in „Bestellungen Webshop“: Artikel FRACHT-PAUSCHAL, Menge 1, Preis aus OriginalPayload.shipping_total. Sie erscheinen als Zeile mit Plussymbol und klappen sich wie eine Liste auf; darin steht dieselbe Zuordnungstabelle. Eine neue Zusatzzeile heißt zunächst „Neue Zusatzzeile“, in einer Liste mit Feste Zeilen „Neue Zeile“.

Eine Zusatzzeile hat keinen Eintrag der Quell-Liste hinter sich. Ihre Felder lesen deshalb aus dem Hauptdatensatz, und sie entsteht einmal je Datensatz, nicht einmal je Eintrag. Eine Bedingung auf der Zeile lässt sie weg, wenn sie nicht zutrifft – „Fracht“ entfällt so bei versandkostenfreien Bestellungen. Eine Zusatzzeile mit Bedingung trägt an ihrer Zeile ein Symbol mit dem Tooltip Bedingung: Diese Zusatzzeile wird nur geschrieben, wenn sie zutrifft.

Das Zahnrad im Brotkrumenband öffnet die Zusatzzeilen-Einstellungen:

ReiterInhalt
AllgemeinBezeichner – der Name der Zusatzzeile, etwa „Fracht“.
BedingungBedingungen, unter denen die Zusatzzeile geschrieben wird; Bedingung hinzufügen legt eine an. Ohne Bedingung wird sie immer geschrieben.

Fertig schließt den Dialog. Im Überlauf des Bands liegt Zusatzzeile löschen, bei Feste Zeilen Zeile löschen; die Rückfrage lautet „Diese Zusatzzeile löschen?“ bzw. „Diese Zeile löschen?“.

Der Testbereich​

Der Testbereich zeigt, was am Ende herauskommt. Sie geben eine Beispielnachricht hinein und sehen das Ergebnis, das die Zuordnung daraus macht.

Ein Test lässt das Zielsystem unberührt – der Tooltip der Schaltfläche sagt es ausdrücklich. Sie können also jederzeit testen, auch an einer Route, die produktiv läuft.

Zusatzdaten ruft der Test wirklich ab. Trägt die Route Zusatzdaten, liest er sie dafür in SAP Business One nach. Ein Test kann deshalb an etwas scheitern, das außerhalb der Zuordnung liegt – etwa weil eine Abfrage zu viele Datensätze liefert. Die Meldung nennt die Zusatzdaten dann beim Namen.

Die Schaltfläche Test ausführen steht in einem Band, das beim Blättern stehen bleibt. Darunter liegen die Bereiche:

Testnachricht. Ein Editor für die Beispieldaten. Ist er leer, steht dort der Hinweis, dass Sie hier etwas einfügen oder es über die Quelldaten laden können – der Link führt auf den Reiter Quelldaten, wo Sie einen echten Datensatz abrufen. Zwei Schaltflächen im Kopf: Auf Referenz zurücksetzen holt die dort hinterlegten Referenzdaten zurück und erscheint nur, wenn es welche gibt; Testnachricht leeren räumt den Editor.

Bei einer Export- oder internen Route steht darüber die Auswahl Ereignisart mit den drei Werten Anlage, Änderung und Löschung, bei einer Importroute dann, wenn ihr Löschverhalten Im Zielsystem deaktivieren ist und sie kein Löschkennzeichen trägt. Sie füllt das Quellfeld Ereignisart der Testnachricht, damit Sie eine Zuordnung prüfen können, die von der Art des Vorgangs abhängt.

Trägt die Route ein Löschkennzeichen, entscheidet die Testnachricht – so wie im Betrieb. Die Auswahl Ereignisart entfällt dann: Eine gekennzeichnete Testnachricht läuft als Löschung, eine andere als Änderung. Trifft es auf die Testnachricht zu, sagt ein Hinweis über dem Ergebnis, was die Route daraus macht: Sie überspringt den Datensatz, oder sie ordnet die zuletzt übertragene Fassung mit der Ereignisart Löschung zu; das Ergebnis zeigt dann diese Fassung, nicht die eingegebene Testnachricht.

Antwort aus „…“. Verwendet die Zuordnung die Antwort eines vorangegangenen Schritts, bekommt jeder dieser Schritte einen eigenen Editor. Vorbelegt ist die Antwortstruktur, die in den Einstellungen jenes Schritts hinterlegt ist. Was Sie hier ändern, gilt nur für diesen Testlauf und verfällt danach; Auf Antwortstruktur zurücksetzen stellt die Vorbelegung wieder her. Ist dort keine hinterlegt, steht im leeren Editor Noch keine Antwortstruktur hinterlegt. Pflegen Sie sie in den Schritteinstellungen des Vorschritts oder geben Sie hier testweise eine Antwort ein.

Element. Läuft der Schritt Je Element, steht im Kopf des Ergebnisses die Auswahl Element: Das Ergebnis zeigt die Nachricht für einen Eintrag der Liste, und die Auswahl wechselt zwischen ihnen. Lässt sich die Liste nicht aufteilen, nennt der Testbereich den Grund:

MeldungBedeutung
Die Liste enthält keine Elemente – der Schritt würde übersprungen.Die Liste des Schritts ist in der Testnachricht leer.
Element 0 der Liste hat keinen Schlüssel – prüfen Sie den Elementschlüssel des SchrittsDer Elementschlüssel liefert für diesen Eintrag keinen Wert. Statt {0} steht seine Nummer.
Zwei Elemente der Liste haben den Schlüssel „0“ – prüfen Sie den Elementschlüssel des SchrittsDer Elementschlüssel unterscheidet die Einträge nicht.

Ergebnis. Erscheint, sobald ein Lauf etwas hervorgebracht hat – ein Ergebnis oder einen Fehler. Der Kopf trägt höchstens eines dieser Abzeichen:

AbzeichenBedeutung
Teilergebnis – siehe Liste der fehlgeschlagenen FelderDer Lauf ist durchgelaufen, einzelne Felder sind aber fehlgeschlagen.
Veraltet – neu testenSie haben nach dem Lauf etwas geändert. Das angezeigte Ergebnis gehört zum alten Stand.

Steht beides an, zeigt der Kopf Veraltet – neu testen.

Ansicht. Trägt eine Zeile des Schritts unter Schreiben etwas anderes als Immer, wählt die Auswahlliste Ansicht im Kopf, welche Fassung der Nachricht das Ergebnis zeigt:

SchreibabsichtEinträge
Anlegen oder aktualisierenBeim Anlegen, Beim Ändern; bei SAP Business One mit einem betroffenen Feld in einer Liste Beim Anlegen, Beim Ändern – vorhandene Listenzeilen, Beim Ändern – neue Listenzeilen
Aktualisieren, bei SAP Business One mit einem betroffenen Feld in einer ListeVorhandene Listenzeilen, Neue Listenzeilen

Neue Listenzeilen zeigt die Nachricht so, als würde jede Zeile der Liste am Ziel angehängt und damit angelegt; Vorhandene Listenzeilen so, als fände jede ihre Zeile am Ziel. Welcher Fall eintritt, entscheidet erst das Ziel – der Test liest es nicht. Ein Wechsel startet keinen neuen Lauf. Voreingestellt ist der erste Eintrag. In allen anderen Fällen fehlt die Auswahl, und das Ergebnis zeigt die Fassung, die dieser Schritt sendet.

Was fehlgeschlagen ist, steht unter dem Ergebnis in der Liste Im Testlauf fehlgeschlagen, mit der Anzahl in Klammern. Jeder Eintrag nennt die Zeile, ihr Zielfeld und den Grund – etwa Pflichtfeld ohne Wert, Quellpfad liefert keinen Wert oder dass ein Quellausdruck mehrere Werte liefert, wo ein einfaches Feld genau einen nimmt. Ein Klick auf den Eintrag öffnet die Zeile. Liegt der Fehler in einer Transformation, öffnen sich die Einstellungen der Zeile an genau dieser Station. Hat der Lauf gar kein Ergebnis hervorgebracht, steht darüber Zuordnung fehlgeschlagen – prüfen Sie die Felder in der Liste unten.

Die Liste gehört zu diesem einen Testlauf. An den Zeilen selbst erscheint davon nichts: Deren Markierungen und die Meldungen beurteilen die Konfiguration, der Test nur die eine Nachricht, die Sie hindurchgeschickt haben.

Enthält die Zuordnung Fehler, startet der Test nicht. Dann steht dort Der Testlauf wurde nicht ausgeführt, weil die Zuordnung Fehler enthält. Beheben Sie die Fehler und starten Sie den Test erneut. Die Fehler selbst stehen darunter in der Liste Vor dem Testlauf fehlgeschlagen, mit der Anzahl in Klammern. Ein Klick auf einen Eintrag führt wie die Markierung an der Zeile genau zu dem Feld, in dem der Fehler liegt.

Testbereich mit eingefügter Beispielnachricht und dem daraus erzeugten Ergebnis.

Siehe auch​