SimbaERP Online

Workflow Entrypoints in Modulen definieren und aufrufen

Es ist möglich, selbst Workflows-Entrypoints in NXPs zu defnieren und aufzurufen.

Workflow-Entrypoint definieren

Zum Definieren wird meist beim Start/OnLoad des Moduls die Funktion des Workflowmanagers aufgerufen, mit welchem ein Entrypoint definiert wird.

Beispiel für Registrierung eines Workflow-Entrypoints (hier aus IncAnschrift.nxp)

' ----------------------------------------------------------------------
' SUB REGISTERWORKFLOWENTRYPOINTS
' ----------------------------------------------------------------------
Private Sub registerWorkflowentrypoints()
	Dim flags as String = "/FLDS {CON}=Connection;{Kdnr}=Nr ausgewählter Kunde"
	nxgui.Workflowengine.WFLRegister("Kundenanschrift Beleg", WFLKey & "_CHOOSEINVREC", "Rechnungsempfänger ausgewählt",flags, "", "\ic8_DiagramIcons\Panes.png")
End Sub

Im Rahmen der Registrierung werden auch die Parameter definiert, welche beim Entrypoint mitgegeben werden. In diesem Beispiel wird die aktuelle Connection sowie die Kundennummer des gerade ausgewählten Kunden mitgegeben. Auf diese Werte kann später im Workflow zugegriffen werden.

Es muss nicht geprüft werden, ob der Workflow-Entrypoint schon registriert ist. Wenn dieser schon vorhanden ist auf dem System, ist der Aufruf aufwandsneutral da das Grundsystem bereits prüft, ob der Punkt registriert ist.

Aufruf/Auslösen eines Entrypoints im Codeablauf

Damit der Workflow auch tatsächlich aufgerufen wird, muss im Code an der relevanten Stelle der Entrypoint aufgerufen werden. Erst dann startet der evtl. dafür registrierte Workflow.

In folgendem Beispiel wird der Worfklow-Entrypoint aufgerufen (WFLExecute) und dabei alle relevanten Infos mit übergeben.
In einem zweiten Schritt wird geprüft, welchen Status der Workflow zurück liefert. Hier wird geprüft, ob "Success" als Ergebnis zurück kommt. Wenn nicht, wird der Ablauf hier abgebrochen.

Dim wflret as nxgui.Workflowengine.clsWorkFlowResult = Nothing
				For Each wflret in nxgui.Workflowengine.WFLExecute(WFLKey & "_BEFORE", "/KEY " & BUSourceNR, wflappdata,False)
					Exit For
				Next
				
				if Not wflret is Nothing AndAlso wflret.State<>nxGUI.Workflowengine.clsWorkFlowResult.enResultState.Success Then
					msgbox("Die Ausführung wurde durch die WorkFlowEngine abgebrochen" & VbCrLf & wflret.ErrorInfo)
					reset
					Exit Sub
				End if

In SP 2026.04.02.769 hat die Methode WFLExecute folgende Parameter

6877-grafik.png

Zur Übergabe der Werte/Parameter für den Workflow wird ein Dictionary(of String,object) verwendet

Dim WFLAppData as new system.Collections.Generic.Dictionary(of String,object)

In dieses Dictionary werden alle relevanten Parameter mit dem vorher definierten Key übergeben, damit diese im Workflow zur Verfügung stehen. Es sind hier alle beliebigen Typen möglich, neben String/Integer natürlich auch Objekte wie die STDV-Connection oder ein Updatemanager/CreateUpdate-Objekt.

wflappdata.Add("SourceK",sourcek)
			wflappdata.Add("SourceA",sourcea)
			wflappdata.Add("DestK",Destk)
			wflappdata.Add("DestA",Desta)
			wflappdata.Add("SourceFIELD",SourceNrField)
			wflappdata.Add("SourceNR",BUSourceNR)
            wflappdata.Add("UPD", upd)