Fehlende Angaben nachladen
Eine Lieferung aus SAP Business One nennt den Kunden nur mit der Kundennummer; die Telefonnummer fehlt. Ihre Positionen nennen den Artikel, und ob er ein Lagerartikel ist oder eine Frachtpauschale, steht am Artikel selbst. Beides steht in SAP Business One, außerhalb der Lieferung.
Zusatzdaten holen solche Angaben dazu, bevor die Zuordnung läuft. Danach stehen sie in der Zuordnung zur Auswahl wie jedes andere Quellfeld.
Im Beispiel: Die Route „Lieferaufträge Kessler“ schickt Lieferungen an den Logistikpartner.
Kessler verlangt die Telefonnummer des Empfängers im Feld recipient_phone und in der Liste lines
nur die Artikel, die tatsächlich verpackt werden. Lieferung 80234 für den Kunden K-10317, Hollmann
Bau GmbH, hat zwei Positionen: ARM-4711 mit Menge 2 und eine Frachtpauschale. Am Ende trägt das
Testergebnis die Telefonnummer und in lines genau einen Eintrag.
Was Sie brauchen
- Die Berechtigung Routen in der Stufe Voll. Siehe Berechtigungen.
- Eine Route, deren Quelldaten bereits geladen sind – die Datenvorschau zeigt einen echten Datensatz. An ihm probieren Sie die Abfragen aus.
- Einstieg: Konfiguration → Routen, die Route auswählen, Reiter Quelldaten, Abschnitt Zusatzdaten.
Xchange sichert jede Eingabe automatisch. Im Betrieb wirkt sie erst mit dem aktivierten Konfigurationsstand – das ist Schritt 6.
1. Eine Abfrage für den Datensatz anlegen
Die Telefonnummer gehört zum Kunden, und der Kunde gehört zur ganzen Lieferung. Die Abfrage läuft also einmal je Lieferung.
- Zusatzdaten hinzufügen wählen. Links erscheint die neue Abfrage, rechts ihre Einstellungen.
- Im Feld Bezeichnung
Kundeeintragen. Tun Sie das zuerst: Unter diesem Namen bietet die Zuordnung die Ergebnisse später an, und eine Abfrage erscheint dort erst mit Bezeichnung. - Im Feld Ebene steht Hauptdatensatz. So bleibt es.
- Im Block Hauptobjekt im Feld Objekt
BusinessPartnerswählen. - Im Feld Felder
Phone1auswählen. - In der Zeile Verknüpfung zum Hauptdatensatz als Feld des Hauptdatensatzes
CardCodeund als Feld des HauptobjektsCardCodewählen. Alle Felder der Zeile beschreibt Routen – Quelldaten. - Im Feld Maximale Zeilen
1eintragen.
Die Verknüpfung holt bei jeder Lieferung deren eigene Kundennummer. Das Feld des
Hauptdatensatzes CardCode ist ein Verweis auf die Lieferung, kein fester Wert. Ohne Verknüpfung oder Bedingung liest die
Abfrage alle Kunden.
Brauchen Sie statt des Kunden seinen Standardansprechpartner, wählen Sie im Block Hauptobjekt
zusätzlich das Unterobjekt ContactEmployees. Die Verknüpfung zum Objekt CardCode = CardCode
liefert alle Ansprechpartner des Kunden. Mit der Schaltfläche Verknüpfung fügen Sie eine zweite Zeile
ContactPerson = Name hinzu; nun bleibt nur der Ansprechpartner, der am Kunden als Standard
eingetragen ist.

2. Eine Abfrage für jede Position anlegen
Ob ein Artikel ein Lagerartikel ist, steht am Artikel, und jede Position hat ihren eigenen. Diese Abfrage läuft also je Position.
- Noch einmal Zusatzdaten hinzufügen wählen und als Bezeichnung
Artikeleintragen. - Im Feld Ebene Zeilen einer Liste wählen. Die Felder darunter ändern sich: Ergebnistyp und Maximale Zeilen verschwinden, dafür erscheinen die Zeilenliste und die Verknüpfung zur Zeile.
- Im Feld Zeilenliste
OriginalPayload.DocumentLines[*]eintragen – die Positionen der Lieferung. - Im Block Hauptobjekt im Feld Objekt
Itemswählen. - In der Zeile Verknüpfung zur Zeile als Feld der Zeile
ItemCodeund als Feld des Hauptobjekts ebenfallsItemCodewählen. So findet jede Position ihren Artikel. - Im Feld Felder
InventoryItemauswählen.
Eine Abfrage je Zeile trägt für jede Position genau einen Datensatz bei. Deshalb entfallen hier Ergebnistyp und Maximale Zeilen: Zu einer Position gehört ein Artikel.
3. Abrufen und nachsehen
Die Abfragen laufen erst, wenn Sie sie in der Datenvorschau abrufen.
- In der Datenvorschau Zusatzdaten abrufen wählen.
- Unter Anzeige Referenzdaten wählen und nachsehen, was angekommen ist: unter
Enrichmentsder Kunde mit seiner Telefonnummer, und an jeder Position unterEnrichmentsder Artikel mitInventoryItem. BeiARM-4711steht dorttYES, bei der FrachtpauschaletNO.
Ändern Sie danach eine Abfrage, steht an der Schaltfläche Veraltet – neu abrufen. Die Vorschau zeigt dann noch das alte Ergebnis.
Scheitert eine Abfrage, sagt die Meldung, woran es liegt – etwa ein Feld, das im gewählten Objekt fehlt, oder eine Abfrage auf den Hauptdatensatz ohne Verknüpfung oder Bedingung auf das Hauptobjekt. Die ganze Liste steht unter Routen – Quelldaten.

4. Die Ergebnisse zuordnen
Wechseln Sie auf den Reiter Zuordnung.
Die Telefonnummer: Zeile hinzufügen, Zielfeld recipient_phone, und in der Spalte
Quelle Enrichments.Kunde[0].Phone1 auswählen. Das [0] steht dort, weil eine Abfrage auf den
Hauptdatensatz immer eine Liste liefert, auch wenn sie nur einen Treffer hat.
Die Positionen: In der Liste lines mit der Quell-Liste DocumentLines bieten die
Elementfelder jetzt neben ItemCode und Quantity auch Enrichments.Artikel.InventoryItem an.
- Die Liste öffnen und Listeneinstellungen wählen.
- Auf dem Reiter Filter eine Bedingung anlegen: Feld
Enrichments.Artikel.InventoryItem, Operator ist gleich, WerttYES. - Fertig wählen.
Die Frachtpauschale fällt damit aus der Liste, ARM-4711 bleibt. Wie Listen und ihre Filter
aufgebaut werden, zeigt Kopf und Positionen zuordnen.
5. Prüfen im Testbereich
- Auf dem Reiter Zuordnung die Schaltfläche Testbereich wählen.
- Die Lieferung
80234als Beispielnachricht verwenden. - Test ausführen wählen.
Der Test führt die Zusatzdaten mit aus und liest dafür in SAP Business One. Im Ergebnis steht
recipient_phone mit der Telefonnummer des Kunden K-10317, und lines hat einen Eintrag. Das
Zielsystem bleibt unberührt.
Liefert eine Abfrage auf den Hauptdatensatz mehr Datensätze als unter Maximale Zeilen erlaubt, bricht der Test mit einer Meldung ab, die die Abfrage beim Namen nennt. Im Beispiel hieße das, dass die Verknüpfung mehr als einen Kunden trifft.
6. Aktivieren
Ihre Änderung liegt im Entwurf. Prüfen Sie ihn und aktivieren Sie ihn; erst dann lädt die Route die Angaben nach. Der Weg dorthin steht in Prüfen und aktivieren.
Wenn im Betrieb Zusatzdaten fehlen
Findet eine Abfrage im Betrieb nicht, was die Zuordnung braucht, bricht der Vorgang ab und landet in der Manuellen Klärung mit der Ursache Zusatzdaten fehlen. Im Beispiel wäre das ein Kunde ohne Telefonnummer. Wie Sie den Fall auflösen, steht in Eine Klärung auflösen.
Wie es weitergeht
- Soll ein nachgeladener Wert übersetzt werden, bevor er hinausgeht: Werte umwandeln und umschlüsseln.
- Fehlt ein Feld in der Auswahl, obwohl die Abfrage es liefert: Ein Feld fehlt in der Zuordnung.
Siehe auch
- Routen – Quelldaten (Referenz) – alle Felder einer Abfrage, ihre Operatoren und Meldungen
- Routen – Zuordnung (Referenz) – Listen, Filter und die Feldauswahl
- Manuelle Klärung (Referenz) – die Ursache Zusatzdaten fehlen