Handbuch:Erweiterung/Workflows/Activities/CustomForm

← Erweiterung/Workflows/Activities

 

Beschreibung

Dialogfenster zum Sammeln benötigter Daten

Die Aktivität CustomForm it eine generische Aktivität, die auf einem benutzerdefinierten Formular basiert. Diese Aktivität sammelt Daten für den Workflow, der ausgeführt werden soll. Daher hängen die Eingabefelder von der Art des Workflows ab. Generell sind die Daten immer gleich und unterscheiden sich nur im Bezug auf den jeweiligen Workflow und die benötigte Benutzeranzahl. Die CustomForm-Aktivität enthält meist leere Werte, die auch als Standardwerte eingefügt werden können.

Kurzprofil
Name	CustomForm
Async	Nein
Input/Formular	Abhängig vom Workflow-Typ, aber generell: Benutzerauswahl / Gruppenauswahl Texfeld für Kommentare Textfeld für Email/Benutzername ...
BPMN Element	bpmn:userTask
BPMN Extension Element "wf:type"	custom_form

Extension-Elemente

Name des Extension-Elements	Beschreibung	Typ
formModule		element
formModule/module	ResourceLoader-Modul, das geladen werden soll	string
formModule/class	Klasse der Formulardefinition, die angezeigt werden soll	string

Beispiel

<bpmn:extensionElements>
    <wf:type>custom_form</wf:type>
    <wf:formModule>
<wf:module>my.custom.form</wf:module>
<wf:class>MyCustomForm</wf:class>
</wf:formModule>
</bpmn:extensionElements>

Dies lädt das ResourceLoader-Modul my.custom.form und erwartet, dass hierfür die JavaScript-Klasse MyCustomForm implementiert ist. Ein solches RL-Modul kann durch eine Erweiterung oder durch ein benutzerdefiniertes Gadget bereitgestellt werden.

Attribute

Name des Attributs	Quelle	Beschreibung	Typ
due_date	UIActivity	Fälligkeitsdatum der Aufgabe	date/timestamp

Jedes Formfeld, das von formModule/class bereitgestellt wier, muss als Eigenschaft definiert sein-

Beispiel

Formular spezifiziert in <wf:class> :

MyCustomForm = function( cfg, activity ) {
MyCustomForm.parent.call( this, cfg, activity );
};

OO.inheritClass( MyCustomForm, workflows.object.form.Form );

MyCustomForm.prototype.getDefinitionItems = function() {
return [
{
name: 'username',
label: "Username",
type: 'user_picker',
required: true
},
{
name: 'comment',
label: 'Comment'
type: 'wikitext',
}
];
};

Die Attribute können so aussehen:

<bpmn:property name="username" />
<bpmn:property name="comment" default="Some default comment text" />

Wenn die id der Aktivität im Element <bpmn:userTask> als "CollectData" spezifiziert wurde, dann können verbundene Aktivitäten auf die Ausgabedaten in ihren jeweiligen Attributen zugreifen:

<bpmn:task id="SomeActivity">
    ...
    <bpmn:property name="user" default="{{{CollectData.username}}}"></bpmn:property>
    <bpmn:property name="intro" default="{{{CollectData.comment}}}"></bpmn:property>
    ...

PDF-Ausschluss - Start

---

Feedback zur Dokumentation ist im Community-Forum möglich.

PDF-Ausschluss - Ende