Um die Call SAP Function Nintex Workflow Custom Action zu verwenden, suchen Sie im Nintex Workflow Manager nach der Action Call SAP Function oder rufen Sie den Menüpunkt mit ERPConnect Services auf der linken Seite auf. Dort sind alle Custom Actions der ERPConnect Services aufgelistet. Per Drag & Drop lässt sich die Action zum Workflow hinzufügen.
Anschließend muss die Custom Action konfiguriert werden. Rufen Sie dafür über die Dropdown-Liste innerhalb der Action den Punkt Configure auf.
In den Konfigurations-Einstellungen muss zunächst die ERPConnect Service Application in der Dropdown-Liste ausgewählt werden.
Die ERPConnect Service Application muss vorher in der Zentraladministration angelegt werden:
ECS Service Application anlegen
Im Feld SAP Function wird der Funktionsbaustein eingetragen, der aufgerufen werden soll. Mit Search lässt sich in dem hinterlegten SAP System nach dem Funktionsbaustein suchen.
Mit dem Button (Re-)Load parameters werden die Parameter des Funktionsbausteins in die Konfigurationsmaske geladen. Denken Sie daran, dass alle Konfigurationseinstellungen verloren gehen, wenn Sie die Parameter neu laden.
Input
Der Punkt Input lässt sich mit einem Klick auf das Pluszeichen aufklappen. Darunter sind alle Input-Parameter des Funktionsbausteins aufgeführt und können mit Werten hinterlegt werden. Oftmals benötigen Funktionsbausteine zwingend Eingabewerte wie z.B. ein Datum oder eine Personalnummer, um Rückgabewerte zu liefern.
Schauen Sie sich daher vor der Nutzung der Custom Action immer zunächst die Eigenschaften des Funktionsbausteins in SAP an.
Changings
Unter Changings sind Changing-Parameter eines Funktionsbausteins aufgeführt, falls dieser solche enthält. Ansonsten ist dieser Bereich leer.
Tables
Unter Tables sind alle Ein- und Ausgabetabellen des Funktionsbausteins aufgeführt und stehen für die Dateneingabe zur Verfügung.
Table Input
Neben Table Input sind alle Eingabetabellen des Funktionsbausteins aufgelistet. Mit einem Klick auf die jeweilige Tabelle öffnet sich ein Editierfenster, in dem Werte für die entsprechenden Tabellenfelder hinterlegt werden können. Zum Editieren klickt man auf das Symbol mit dem Stift.
Über den Plus-Button können zusätzlich Zeilen hinzugefügt und mit Daten hinterlegt werden, vorausgesetzt der SAP Funktionsbaustein unterstützt die Verarbeitung mehreren Input-Zeilen.
Additional XML table input
Mit Additional XML table input kann zusätzlich über eine Workflow Variable ein weiterer XML-Input zu einer oder mehreren Input-Tabellen hinzugefügt werden. Zum Aufbau des XML-Input schauen Sie sich bitte im weiteren Verlauf das Beispiel Call SAP Function mit zusätzlichem XML-Input an.
XML output table/ XML output variable
Mit der Funktion XML Output table und XML Output variable ist es möglich, die Rückgabewerte der Tabellen des Funktionsbausteins in eine Output-Variable wegzuschreiben. Daten können einem Nintex-Workflow grundsätzlich immer nur immer nur im XML-Format gespeichert werden.
In der Dropdown-Liste neben XML Output table sind alle Tabellen des Funktionsbausteins aufgelistet. Es stehen folgende Auswahloptionen zur Verfügung:
- Die Auswahl einer einzelnen Tabelle
- Die Auswahl keiner Tabelle
- Die Auswahl aller Tabellen
Eine Workflow-Variable muss in der Konfigurationsmaske im Menüpunkt Variables zunächst angelegen werden, damit sie unter XML output variable auswählbar ist.
Output
Output parameters
Unter Output parameters sind alle Export-Parameter des gewählten Funktionsbausteins aufgelistet und können
zur Sicherung der Rückgabewerte Workflow-Variablen zugewiesen werden.
Die Workflow-Variablen müssen im Menüpunkt Variables in der Konfigurationsmaske erst angelegen werden, damit sie auswählbar sind. Es kann dabei nur jeweils ein Element einer Workflow-Variable zugewiesen werden.
Advanced Options
Unter Advanced Options stehen zusätzlich noch folgende Optionen zur Verfügung:
Transaction commit
Wenn der Haken bei Transaction commit gesetzt wird, wird nach der Verarbeitung des gewählten Funktionsbaustein noch der Bapi BAPI_TRANSACTION_COMMIT aufgerufen. Manche SAP Funktionsbausteine benötigen diese Commit-Funktion zwingend, um Daten erfolgreich in der Datenbank zu verbuchen.
Connection Scope
Einige Szenarien erfordern es, dass mehrere Funktionsbausteine hintereinander ausgeführt werden, um den Prozess erfolgreich abzuschließen. Insbesondere bei HR-Prozessen ist dies der Fall, wo häufig eine Personalnummer zunächst gesperrt und nach der Verbuchung im entsprechenden Infotyp wieder entsperrt werden muss. Dieses Hintereinanderschalten von Funktionen muss jedoch immer im selben sogenannten Connection Scope erfolgen. Damit wird sichergestellt, dass die Funktionen zusammenhängen.
Um einen Connection Scope zu nutzen, gehen Sie bitte folgendermaßen vor:
Schritt 1: Variable definieren
Frei benennbare Variable vom Typ Multiple lines of text anlegen und im Feld Connection Scope selektieren.
Schritt 2: Scope beginnen
In der selben Action für den Beginn des Scopes den Haken bei Begin scope here setzen.
Schritt 3: Funktionen innerhalb des Scopes setzen (falls erforderlich)
Für zusätzliche Funktionen innerhalb des Scope lediglich die XML-Variable im Feld Connection Scope hinzufügen.
Schritt 4: Scope schließen
Haken bei End connection scope here setzen. Optional kann zusätzlich noch der Haken bei Transaction commit gesetzt werden, falls dies der Baustein erfordert.
Nach dieser Vorgehensweise ist die Nutzung mehrerer Scopes innerhalb eines Workflows möglich.