Zum Hauptinhalt springen

Schreiben ins Zielsystem

Die Zuordnung füllt die Felder eines Datensatzes. Dann steht er fertig da, und es bleibt eine Frage: Ist er drüben schon vorhanden? Diese Seite erklärt, woher Xchange die Antwort nimmt – und warum dabei ein zweiter Datensatz entstehen kann.

Ändern braucht eine Adresse​

Xchange kennt zunächst nur, was in der Nachricht steht. Ob die Bestellung WS-2026-104877 in SAP Business One schon als Beleg liegt, muss es erst herausfinden.

Darin unterscheiden sich die beiden Vorgänge:

  • Anlegen richtet sich an die Sammlung. „Lege einen neuen Beleg an“ – dafür genügt der Inhalt.
  • Ändern richtet sich an einen einzelnen Datensatz. „Ändere diesen Beleg“ – dafür braucht es seine Adresse im Zielsystem, und die ist sein Schlüssel dort.

Was ein Schritt tun soll, sagt seine Schreibabsicht: Anlegen, Aktualisieren oder Anlegen oder aktualisieren. Sie steht zusammen mit der Schlüsselquelle im Dialog Schritteinstellungen, den das Zahnrad über der Zuordnungstabelle öffnet. Beides gehört zu den Schritten, die einen Datensatz schreiben. Ein Schritt im Modus Ausführen stößt im Zielsystem nur einen Vorgang an und kommt ohne beides aus.

Die Schreibabsicht sehen Sie auch, ohne den Dialog zu öffnen: Die Leiste über der Zuordnungstabelle zeigt sie an jedem Schritt als kleines Abzeichen. Die Schlüsselquelle steht allein im Dialog.

Schritteinstellungen mit Schreibabsicht und Schlüsselquelle.

Woher der Schlüssel kommt​

Die Schlüsselquelle beantwortet genau eine Frage: Woher kennt Xchange die Adresse des Datensatzes im Zielsystem? Die beiden Wege, die im Betrieb auseinanderliegen, zeigen zwei Routen.

Aus den Quelldaten – „Artikel Cambira Austria“. Der Artikel ARM-4711 heißt im deutschen wie im österreichischen Mandanten ARM-4711. Die Schlüsselquelle steht auf Zuordnung oder Quelle, und der Schlüssel ItemCode nimmt seinen Wert aus der Zuordnungszeile ItemCode → ItemCode. Die Adresse liegt damit schon im Datensatz, bevor irgendetwas gefragt wird. Eine Übersetzungstabelle entfällt – das ist der bequeme Fall, und er hat eine Voraussetzung: dass beide Seiten denselben Schlüssel verwenden.

Vom Zielsystem – „Bestellungen Webshop“. Der Shop nummeriert seine Bestellungen selbst, SAP Business One nummeriert seine Belege selbst. WS-2026-104877 bleibt die Nummer des Shops und landet im Feld NumAtCard. Die Adresse des Belegs kennt allein SAP Business One – also wird sie gesucht, Schlüsselquelle Suche im Zielsystem.

Zwei weitere Stellungen gibt es. Antwort des Zielsystems nimmt den Schlüssel aus dem, was das Zielsystem nach dem Anlegen zurückmeldet – so bekommt „Lieferaufträge Kessler“ die Nummer, die der Logistikpartner vergeben hat. Kein Schlüssel steht für einen Schritt, der ohne Adresse auskommt.

Welche Stellungen zur Wahl stehen, hängt vom Schritt ab. Suche im Zielsystem und Kein Schlüssel gibt es immer. Zuordnung oder Quelle bietet jeder schreibende Schritt an, sobald die Schreibabsicht Aktualisieren oder Anlegen oder aktualisieren ist. Antwort des Zielsystems bietet nur der Hauptschritt einer Route, die hinausschreibt – der Schritt also, der das Hauptobjekt schreibt (siehe Das Grundmodell).

Die Adresse eines einzelnen Datensatzes​

Ein Schritt kennt zwei Adressen. Der Zielendpunkt nennt die Sammlung – dorthin wird angelegt. Der Einzelziel-Endpunkt nennt einen einzelnen Datensatz darin und trägt dafür einen Platzhalter für seinen Schlüssel. Er erscheint, sobald die Schreibabsicht Aktualisieren oder Anlegen oder aktualisieren ist.

Ein Beispiel mit einem erfundenen Benutzerverzeichnis: Benutzer werden unter users angelegt, ein einzelner Benutzer heißt dort users/kscid:{{kscid}}. Dann gilt:

FeldWert
Zielendpunktusers
Einzelziel-Endpunktusers/kscid:{{kscid}}
SchlüsselquelleZuordnung oder Quelle
Schlüssel kscid → Wertein Feld der Quelldaten mit der Kundennummer

Für jeden Platzhalter steht unter der Schlüsselquelle eine Zeile Schlüssel mit ihrem Wert. Den Wert wählen Sie aus den Quelldaten oder unter Zuordnungen aus einer Zuordnungszeile – dann gilt der Wert, wie die Zeile ihn ins Ziel schreibt. Schlüssel einfügen neben dem Einzelziel-Endpunkt setzt den Platzhalter an die Schreibmarke und legt die Zeile gleich mit an. Bei einem REST-Ziel dürfen Sie das Feld auch leer lassen; dann gilt die Adresse, die es grau vorschlägt. Bei SAP Business One steht die Adresse fest, etwa Items('{{ItemCode}}').

Der Schlüssel steht nur in der Adresse. Xchange setzt ihn in den Einzelziel-Endpunkt ein und schickt ihn nicht zusätzlich im Datensatz mit. Soll er auch dort stehen, braucht er eine eigene Zuordnungszeile – eine Zeile, die Sie als Wert wählen, wird ohnehin geschrieben.

Aktualisieren legt nie an. Mit der Schreibabsicht Aktualisieren ändert der Schritt den Datensatz unter dieser Adresse. Gibt es ihn dort nicht, schreibt Xchange nichts, und der Schritt endet als Übersprungen (Nicht vorhanden) – weitere Schritte laufen trotzdem. Zeigte die Adresse auf eine Objektzuordnung, verwirft Xchange sie, damit der nächste Lauf wieder sucht. Antwortet ein REST-Ziel auf einen fehlenden Datensatz mit Erfolg, lässt sich das von einer Aktualisierung nicht unterscheiden.

Anlegen oder aktualisieren liest zuerst. Xchange fragt den Datensatz unter dem Einzelziel-Endpunkt ab. Gibt es ihn, wird er geändert; meldet das Zielsystem, dass es ihn nicht gibt, wird im Zielendpunkt angelegt. Jede andere Antwort legt nichts an. Lässt sich der Einzelziel-Endpunkt gar nicht lesen, endet der Vorgang als Einzelziel nicht lesbar.

Ein geänderter Schlüssel wird nicht überschrieben. Hat der Datensatz schon eine Objektzuordnung und führt sein Schlüssel zu einem anderen Zieldatensatz, schreibt Xchange nichts. Der Vorgang endet als Schlüssel gegen Objektzuordnung – siehe Wenn die Objektzuordnung widerspricht.

Die Suche vor dem Schreiben​

Steht die Schlüsselquelle auf Suche im Zielsystem, fragt Xchange vor jedem Schreiben nach. Zwei Felder sagen, wonach: Suchfeld im Zielsystem nennt das Feld drüben, Suchwert aus der Quelle den Wert, der darin stehen soll. Bei den Bestellungen heißt das: Gibt es einen Beleg mit NumAtCard = "WS-2026-104877"?

Die Antwort hat drei Ausgänge:

Was die Suche findetWas geschieht
Genau einen DatensatzEr wird geändert. Seine Adresse ist gefunden.
KeinenEs wird angelegt – außer die Schreibabsicht war Aktualisieren, dann endet der Schritt als Übersprungen (Nicht vorhanden).
Mehr als einenEs wird nichts geschrieben; der Vorgang geht als Mehrere Zieldatensätze in die Klärung. Zwei Treffer heißen, dass die Suchfelder den Datensatz mehrdeutig bestimmen.

Bei mehreren Treffern entscheiden Sie, welcher der richtige ist: Der Fall in der Manuellen Klärung zeigt die Treffer, und mit Objektzuordnung festlegen wird der gewählte die Objektzuordnung dieses Schritts, bevor der Vorgang erneut läuft. Bestimmen die Suchfelder den Datensatz grundsätzlich nicht eindeutig, ist die Suche selbst zu ändern.

Ein abgelehntes Anlegen fragt noch einmal nach. Zwischen Suche und Anlegen kann ein anderer den Datensatz drüben schon angelegt haben. Lehnt das Zielsystem das Anlegen ab, sucht Xchange deshalb einmal erneut, sofern sich der Zieldatensatz suchen oder adressieren lässt: Findet die Suche ihn jetzt, wird er bei Anlegen oder aktualisieren geändert und bei Anlegen als vorhanden vermerkt. Findet sie nichts, bleibt die Ablehnung stehen.

Eine gescheiterte Suche endet immer in der Klärung. Antwortet das Zielsystem gar nicht oder mit einem Fehler, bricht der Vorgang ab und geht in die Manuelle Klärung. Eine Zeitüberschreitung lässt offen, ob der Datensatz drüben liegt. Würde Xchange sie als „nicht gefunden“ lesen, entstünde bei jeder Wiederholung ein weiterer Datensatz – und Wiederholungen sind der Normalfall.

Die Objektzuordnung – was Xchange sich merkt​

Hat ein Schritt einen Datensatz geschrieben, merkt Xchange sich das Paar: welcher Datensatz hier welchem drüben entspricht. Dieser Merkzettel heißt Objektzuordnung und führt zwei Schlüssel nebeneinander – den Internen Schlüssel in SAP Business One und den Externen Schlüssel im angebundenen System.

Beim nächsten Mal wird er zuerst gelesen. Steht das Paar dort, kennt Xchange die Adresse sofort. Ist eine Suche eingerichtet, läuft sie trotzdem – als Gegenprobe, siehe Wenn die Objektzuordnung widerspricht. Die Detailseite eines Vorgangs im Verlauf zeigt im Abschnitt Datensätze, welches Paar dieser Vorgang angesprochen hat. Für die Bestellung WS-2026-104879 steht dort der Beleg mit dem internen Schlüssel 4127.

Bereich Datensätze mit internem Schlüssel 4127 und externem Schlüssel WS-2026-104879.

Stimmt ein Eintrag nicht mehr, berichtigt Xchange ihn selbst. Ein Datensatz im Zielsystem kann dort unbemerkt von Xchange gelöscht werden. Meldet das Zielsystem beim Schreiben, dass die Adresse ins Leere zeigt, verwirft Xchange den Eintrag und geht den Weg ein zweites Mal – diesmal über die Suche. Bleibt sie ohne Treffer, wird bei Anlegen oder aktualisieren angelegt; bei Aktualisieren endet der Schritt als Übersprungen (Nicht vorhanden).

Jeder Schritt führt seine eigene Objektzuordnung, sofern er seinen Zieldatensatz sucht oder adressiert – ein zweiter Schritt, der in ein anderes Objekt schreibt, landet so nie unter dem Schlüssel des ersten. Auf der Detailseite im Verlauf steht der Schlüssel, den der Hauptschritt dieses Vorgangs angesprochen hat.

Eine Objektzuordnung bleibt, auch wenn sich die Datensätze, die sie verbindet, ändern. Ein Beispiel: Die Bestellung WS-2026-104879 ist dem Beleg 4127 zugeordnet. Ändert jemand in SAP Business One die Kundenreferenz dieses Belegs auf WS-2026-104879-B, findet die Suche nach NumAtCard = "WS-2026-104879" nichts mehr – ohne Gegenprobe würde Xchange die nächste Änderung der Bestellung trotzdem in Beleg 4127 schreiben, und niemand bemerkte die Abweichung.

Deshalb prüft Xchange die Objektzuordnung vor dem Schreiben, bei jeder Schreibabsicht außer Anlegen:

  • Mit der Suche. Steht die Schlüsselquelle auf Suche im Zielsystem, läuft die Suche auch bei vorhandener Objektzuordnung. Findet sie genau den zugeordneten Datensatz, wird geschrieben. Findet sie einen anderen, mehrere ohne den zugeordneten oder keinen, obwohl der zugeordnete noch besteht, schreibt Xchange nichts. Der Vorgang endet als Suche gegen Objektzuordnung – im Beispiel oben bei der nächsten Änderung von WS-2026-104879. Gibt es den zugeordneten Datensatz nicht mehr, gilt der Weg aus dem vorigen Abschnitt: Xchange verwirft die Objektzuordnung.
  • Mit dem Schlüssel. Steht die Schlüsselquelle auf Zuordnung oder Quelle und führt der Schlüssel des Datensatzes zu einem anderen Zieldatensatz, endet der Vorgang als Schlüssel gegen Objektzuordnung.

Eine gewollte Änderung blockiert nicht. Xchange merkt sich zu jeder Objektzuordnung die Suchwerte, mit denen sie zuletzt geprüft wurde. Ändern sich diese Werte in der Quelle selbst, gilt die Objektzuordnung, es wird geschrieben und der neue Stand gemerkt. Geprüft wird nur, solange die Suchwerte dieselben sind. Fehlt der Suchwert in der Quelle, gilt ebenfalls die Objektzuordnung.

Dieselbe Gegenprobe gilt für jede verknüpfte Zeile einer Liste – über ihren Schlüssel, siehe Zeilen über ihre Verknüpfung wiederfinden. Widersprechen mehrere Zeilen, entsteht ein Fall mit einem Punkt je Zeile; widerspricht schon der Datensatz selbst, prüft Xchange die Zeilen nicht mehr.

In der Manuellen Klärung entscheiden Sie je Punkt, wer recht hat, und übernehmen alle Entscheidungen auf einmal:

EntscheidungWas geschieht
Objektzuordnung umhängenDie Objektzuordnung zeigt danach auf den gefundenen Datensatz. Die bisherige Objektzuordnung und ihre Zeilenzuordnungen werden verworfen.
Objektzuordnung bestätigenDie Objektzuordnung bleibt. Xchange merkt sich, was die Suche gefunden hat, und schreibt weiter über die Objektzuordnung, solange die Suche dasselbe Ergebnis liefert. Nur bei Suche gegen Objektzuordnung.
Zeilenzuordnung umhängenDie Zeile der Quelle ist danach mit der gefundenen Zeile verknüpft.
Zeilenzuordnung bestätigenDie Verknüpfung bleibt. Die Werte der Quelle werden beim Schreiben in die Zeile übernommen und überschreiben eine Änderung im Zielsystem.

Danach wird der Vorgang einmal erneut verarbeitet.

Vorgänge, die einen Datensatz löschen oder aus dem Datenfilter entfernen, sind von der Prüfung ausgenommen – das Löschen erreicht den Datensatz, den die Objektzuordnung nennt.

Warum trotzdem ein zweiter entstehen kann​

Alle drei Fälle liegen in der Einrichtung der Route.

Die Schreibabsicht steht auf Anlegen. Dann wird angelegt, jedes Mal, ohne zu fragen. Das ist für einen Beleg, der genau einmal entsteht, die richtige Einstellung – und für einen Artikelstamm, der immer wieder kommt, die falsche. Wie Sie das bei einer Route nachsehen, steht unter Doppelte vermeiden und aufklären.

Das Suchfeld des Datensatzes ist leer. Die Schlüsselquelle steht auf Suche im Zielsystem, die Schreibabsicht auf Anlegen oder aktualisieren, die Route scheint geschützt – aber das Suchfeld des einzelnen Datensatzes ist leer. Dann legt Xchange an, ungeprüft. Bei der nächsten Lieferung desselben Datensatzes geschieht dasselbe. Steht die Schreibabsicht dagegen auf Aktualisieren, bricht der Vorgang mit einer Meldung ab.

Das Suchfeld trifft den falschen Datensatz. Ein Suchfeld, das mehrere Datensätze tragen können – ein Name, eine Postleitzahl –, findet bei einem Treffer den vermeintlich richtigen und schreibt hinein. Das Ergebnis ist ein überschriebener fremder Datensatz statt eines doppelten. Bei zwei Treffern greift der Abbruch von oben; ein einzelner Treffer gilt als der richtige.

Was an anderer Stelle entschieden wird​

  • Was in den Feldern steht, entscheidet die Zuordnung, Zeile für Zeile.
  • Ob ein Datensatz übertragen wird, entscheiden Datenfilter und Bedingungen der Route.
  • Wann geschrieben wird, sagt der Auslöser – siehe Auslösung.

Siehe auch​