Zum Hauptinhalt springen

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.

  1. Zusatzdaten hinzufügen wählen. Links erscheint die neue Abfrage, rechts ihre Einstellungen.
  2. Im Feld Bezeichnung Kunde eintragen. Tun Sie das zuerst: Unter diesem Namen bietet die Zuordnung die Ergebnisse später an, und eine Abfrage erscheint dort erst mit Bezeichnung.
  3. Im Feld Ebene steht Hauptdatensatz. So bleibt es.
  4. Im Block Hauptobjekt im Feld Objekt BusinessPartners wählen.
  5. Im Feld Felder Phone1 auswählen.
  6. In der Zeile Verknüpfung zum Hauptdatensatz als Feld des Hauptdatensatzes CardCode und als Feld des Hauptobjekts CardCode wählen. Alle Felder der Zeile beschreibt Routen – Quelldaten.
  7. Im Feld Maximale Zeilen 1 eintragen.

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.

Eine Abfrage liest zur Kundennummer der Lieferung die Telefonnummer des Kunden.

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.

  1. Noch einmal Zusatzdaten hinzufügen wählen und als Bezeichnung Artikel eintragen.
  2. 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.
  3. Im Feld Zeilenliste OriginalPayload.DocumentLines[*] eintragen – die Positionen der Lieferung.
  4. Im Block Hauptobjekt im Feld Objekt Items wählen.
  5. In der Zeile Verknüpfung zur Zeile als Feld der Zeile ItemCode und als Feld des Hauptobjekts ebenfalls ItemCode wählen. So findet jede Position ihren Artikel.
  6. Im Feld Felder InventoryItem auswä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.

  1. In der Datenvorschau Zusatzdaten abrufen wählen.
  2. Unter Anzeige Referenzdaten wählen und nachsehen, was angekommen ist: unter Enrichments der Kunde mit seiner Telefonnummer, und an jeder Position unter Enrichments der Artikel mit InventoryItem. Bei ARM-4711 steht dort tYES, bei der Frachtpauschale tNO.

Ä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.

Die Datenvorschau zeigt die nachgeladene Telefonnummer und die Artikelangabe je Position.

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.

  1. Die Liste öffnen und Listeneinstellungen wählen.
  2. Auf dem Reiter Filter eine Bedingung anlegen: Feld Enrichments.Artikel.InventoryItem, Operator ist gleich, Wert tYES.
  3. 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​

  1. Auf dem Reiter Zuordnung die Schaltfläche Testbereich wählen.
  2. Die Lieferung 80234 als Beispielnachricht verwenden.
  3. 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​

Siehe auch​