Zum Hauptinhalt springen

Daten innerhalb von SAP Business One übertragen

Zu jedem neuen Kundenauftrag soll im selben Mandanten sofort die Lieferung entstehen – mit allen Positionen außer der Frachtpauschale, die im Auftrag bleibt. Quelle und Ziel sind beide CAMBIRA_DE; nichts kommt von außen, nichts geht hinaus. Diese Anleitung richtet dafür die Route „Lieferungen aus Aufträgen“ ein.

Am Ende legt der Innendienst Kundenauftrag 4131 für K-10317 „Hollmann Bau GmbH“ an, mit ARM-4711 Menge 4 und FRACHT-PAUSCHAL Menge 1, und die Route legt daraus Lieferung 80251 an – mit genau einer Position, ARM-4711, Menge 4.

Abgrenzung

Hier bleiben die Daten im eigenen Mandanten. Sollen sie in einen zweiten SAP-Mandanten, ist das eine Exportroute mit eigener Anbindung – siehe Stammdaten in einen zweiten Mandanten übernehmen.

Was Sie brauchen​

  • Drei Berechtigungen, jede in der Stufe Voll: Routen legt die Route an, Aktivierung aktiviert den Stand, Automatik gibt die Route am Ende frei – siehe Berechtigungen.
  • Keine Anbindung. Eine interne Route hat kein Gegenüber.
  • Einstieg: Konfiguration → Routen.

Xchange sichert jede Eingabe automatisch. Im Betrieb wirkt sie erst mit dem aktivierten Konfigurationsstand – das ist Schritt 5.

1. Die Route anlegen​

  1. Konfiguration → Routen → Anlegen.
  2. Richtung Intern. Der Typ springt auf Verarbeitung, die Datenherkunft bietet nur noch Datenbestand an, und das Feld Anbindung verschwindet.
  3. Name: Lieferungen aus Aufträgen.
  4. Anlegen.

In der Routenliste steht die Route danach in der Gruppe „SAP Business One“, ganz oben. Was die drei Richtungen unterscheidet und welche Kombinationen der Dialog zulässt, steht unter Routen.

2. Sagen, woraus gelesen wird​

Auf dem Reiter Quelldaten:

  1. Abrufendpunkt: Orders.
  2. Darunter steht der Einzelabruf-Endpunkt Orders({{DocEntry}}). Xchange füllt ihn aus dem Abrufendpunkt; über ihn liest die Route den Auftrag nach, den das Ereignis meldet.

Einen Datenfilter braucht diese Route nicht – jeder neue Auftrag soll eine Lieferung bekommen.

3. Kopf und Positionen zuordnen​

Auf dem Reiter Zuordnung:

  1. Die Schritteinstellungen öffnen: Name Lieferung anlegen, Schreibabsicht Anlegen, Zielendpunkt DeliveryNotes. Ziel ist hier SAP Business One selbst, also ein Pfad des Service Layer.
  2. Eine Zeile mit Zielfeld CardCode und Quelle OriginalPayload.CardCode anlegen.
  3. Eine Liste hinzufügen und öffnen, in ihren Listeneinstellungen die Zielliste DocumentLines und die Quell-Liste OriginalPayload.DocumentLines[*] eintragen.
  4. In der Liste ItemCode und Quantity aus der Gruppe Elementfelder zuordnen.
  5. Die Frachtpauschale ausnehmen. Auf dem Reiter Filter der Listeneinstellungen die Bedingung ItemCode ist ungleich FRACHT-PAUSCHAL anlegen. Diese Position bleibt im Auftrag und kommt nicht in die Lieferung.

Wie eine Liste angelegt und befüllt wird, steht ausführlich unter Kopf und Positionen zuordnen, wenn das Ziel anders schneidet; alle Vergleiche des Filters führt Routen – Zuordnung.

4. Den Auslöser setzen​

Die Route soll laufen, sobald ein Auftrag angelegt wird. Auf dem Reiter Automatik:

  1. Auslöser hinzufügen, Typ Ereignis.
  2. Betriebsart Wie Abrufendpunkt – der Auslöser hört auf Orders, das Objekt, aus dem die Route liest.
  3. Bei Auslösen bei nur Angelegt einschalten. Eine Änderung am Auftrag soll keine zweite Lieferung anlegen.

Den ganzen Weg eines Ereignisauslösers beschreibt Auf eine Änderung in SAP reagieren.

Hören Sie nicht auf das Objekt, das die Route anlegt. Stünde der Auslöser auf Anderes Objekt DeliveryNotes, startete jede Lieferung, die die Route anlegt, die Route erneut. Xchange warnt dann: „Route legt ‚DeliveryNotes‘ selbst an und kann sich damit erneut auslösen – Ereignis mit einer Bedingung eingrenzen, die die angelegten Datensätze nicht erfüllen“. Wann die Warnung erscheint und warum sie auch mit einer Bedingung stehen bleibt, steht unter Routen – Automatik.

5. Prüfen und aktivieren​

  1. Im Testbereich des Reiters Zuordnung einen Auftrag mit Frachtpauschale durchrechnen und nachsehen, dass DocumentLines nur die übrigen Positionen trägt.
  2. Den Konfigurationsstand aktivieren – siehe Prüfen und aktivieren.
  3. Nach Ausführung wechseln und den Schalter in der Spalte Automatik dieser Route umlegen.

Erst danach legt die Route Lieferungen an.

Wie es weitergeht​

Nach dem ersten Auftrag steht der Vorgang im Verlauf: die Datensätze heißen dort Quelle und Ziel und liegen beide in SAP Business One. Wie Sie einen Vorgang dort lesen, steht unter Verlauf.

Siehe auch​