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.
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
- Konfiguration → Routen → Anlegen.
- Richtung Intern. Der Typ springt auf Verarbeitung, die Datenherkunft bietet nur noch Datenbestand an, und das Feld Anbindung verschwindet.
- Name:
Lieferungen aus Aufträgen. - 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:
- Abrufendpunkt:
Orders. - 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:
- Die Schritteinstellungen öffnen: Name
Lieferung anlegen, Schreibabsicht Anlegen, ZielendpunktDeliveryNotes. Ziel ist hier SAP Business One selbst, also ein Pfad des Service Layer. - Eine Zeile mit Zielfeld
CardCodeund QuelleOriginalPayload.CardCodeanlegen. - Eine Liste hinzufügen und öffnen, in ihren Listeneinstellungen die Zielliste
DocumentLinesund die Quell-ListeOriginalPayload.DocumentLines[*]eintragen. - In der Liste
ItemCodeundQuantityaus der Gruppe Elementfelder zuordnen. - Die Frachtpauschale ausnehmen. Auf dem Reiter Filter der Listeneinstellungen die
Bedingung
ItemCodeist ungleichFRACHT-PAUSCHALanlegen. 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:
- Auslöser hinzufügen, Typ Ereignis.
- Betriebsart Wie Abrufendpunkt – der Auslöser hört auf
Orders, das Objekt, aus dem die Route liest. - 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
- Im Testbereich des Reiters Zuordnung einen Auftrag mit Frachtpauschale durchrechnen und
nachsehen, dass
DocumentLinesnur die übrigen Positionen trägt. - Den Konfigurationsstand aktivieren – siehe Prüfen und aktivieren.
- 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
- Auf eine Änderung in SAP reagieren (Anleitung) – der Ereignisauslöser Schritt für Schritt
- Kopf und Positionen zuordnen, wenn das Ziel anders schneidet (Anleitung) – Listen und ihr Filter
- Routen (Referenz) – Richtung, Typ und Datenherkunft im Anlegedialog
- Routen – Automatik (Referenz) – das Ereignis und die Warnung vor der Selbstauslösung
- Routen (Grundkonzept) – was eine interne Route von Import und Export unterscheidet