Formulare zum Starten von Prozessen (Start Dialoge)
Start Dialoge sind Komponenten, die zum Starten von Prozessen genutzt werden können. Damit ist es möglich, dem Prozess Daten in Form eines (Start) Tokens zu übergeben, bevor dieser gestartet wurde. In diesem Kapitel wird erklärt, wie ein solcher Start Dialog zum Starten von Prozessen implementiert werden kann.
Start Dialog Renderer
Wie auch für Custom Forms gibt es für die Start Dialoge einen Renderer. Dieser verwaltet die Start Dialoge und bietet Funktionen wie das Starten von Prozessen.
Beispiel Start Dialog
Zunächst muss die Komponente im Renderer registriert werden.
private components: StartDialogComponentDict = {
TestStartDialog: TestStartDialog1,
};Außerdem muss die Komponente mit ihrer ID und URL in der config.json des Portals im Processcube-Ordner unter startDialogs registriert werden.
"startDialogs": {
"TestStartDialog": {
"url": "http://localhost:5111",
"id": "TestStartDialog"
},
}Einer Start Dialog Klasse müssen die StartDialogProps vom Renderer übergeben werden.
Nun kann man die Komponente so gestalten, wie sie gebraucht wird, um beispielsweise die Daten für einen Start Token zu wählen.
export class TestStartDialog1 extends React.Component<StartDialogProps> {
public render(): JSX.Element {
return (
<div>
<p>Hallo, das ist ein Test Start Dialog</p>
<button onClick={() => this._handleOnClick()}>Prozess starten</button>
</div>
);
}
private _handleOnClick(): void {
this.props.startProcess('UntypedTaskTest', { key: 'Hello World' });
}
}
Die Methode startProcess benötigt eine Prozessmodell-ID. Außerdem hat sie die optionalen Parameter payload (ein Objekt)
und startEventId.
startProcess: (processModelId: string, payload?: unknown, startEventId?: string) => void;Der gezeigte Start Dialog startet (sobald der Button gedrückt wird) einen Prozess und übergibt ihm das Beispielobjekt. Die Daten sind nun beim Start des Prozesses im Token enthalten und können verwendet werden.
