ConditionalMandatoryDocumentHandler

Beschreibung

Der ActionHandler ConditionalMandatoryDocumentHandler prüft, ob ein oder mehrere Dokumente hochgeladen wurden und ob eine Bedingung gültig ist. Es kann auch überprüft werden, ob die hochgeladenen Dateien mit einem oder mehreren angegebenen Dateinamen übereinstimmen. Wenn keine übereinstimmenden Dokumente gefunden werden, wird eine Fehlermeldung angezeigt und die Aufgabe kann erst abgeschlossen werden, wenn die erforderlichen Dokumente angehängt sind.

Wenn das Dokument ohne Bedingung obligatorisch sein soll, sollte dieser Handler verwendet werden:

https://tim-doc.atlassian.net/wiki/spaces/DE/pages/228525200

Klasse

com.dooris.bpm.actionhandler.ConditionalMandatoryDocumentHandler

Parameter

Parameter	Standardwert	Beschreibung	Gültige Beispiele

Parameter	Standardwert	Beschreibung	Gültige Beispiele
`pattern`		Eine Zeichenfolge, die im Dokumentnamen oder in der Beschreibung enthalten sein muss. Es können ein oder mehrere Muster eingegeben werden (mehrere Begriffe werden durch Kommas getrennt). Wenn kein Muster angegeben ist, wird geprüft, ob mindestens ein Dokument (unabhängig davon, wie es benannt ist) angehängt ist!	`PhoneNumberList` `PhoneNumberList,docx,TravelCosts`
`description`	`true`	Gibt an, ob die Beschreibung des Dokuments auch nach dem mitgelieferten Muster geprüft werden soll. Mögliche Werte hierfür sind `true` (include) oder `false` (do not include).	`false`
`caseSensitive`	`false`	Gibt an, ob die Formatierung von Groß- und Kleinbuchstaben berücksichtigt werden soll. Dieser Parameter wird nur berücksichtigt, wenn ein Muster angegeben ist! Mögliche Werte hierfür sind `true` (Groß- und Kleinschreibung sind wichtig) oder `false` (ignorieren).	`false`
`fileType`		Deklaration von Dateiendungen (durch Kommas getrennt). Prüft, ob alle Dokumente der Dateiendung entsprechen, unabhängig davon, ob Groß- oder Kleinschreibung (Beispiel: bei fileType=pdf sind sowohl .pdf als auch .PDF gültig). Wenn nur dieser Parameter angegeben wird, ist das Hochladen von Dokumenten nicht zwingend erforderlich. Wenn jedoch Dokumente angehängt werden, müssen sie den Dateiendungen entsprechen.	`pdf, docx, pptx`
`enforcePattern`	`false`	Wenn diese Option auf `true` gesetzt ist, müssen alle angehängten Dokumente dem oben angegebenen Muster (Parameter 1) entsprechen. Wenn `false`, muss nur eine Datei dem Muster entsprechen. Mögliche Werte hierfür sind `true` oder `false`.	`true`
`checkCurrentNode`	`false`	Wenn auf `true` gesetzt, werden die von diesem Handler gesetzten Einschränkungen für Dokumente überprüft, die auf diesen aktuellen Knoten hochgeladen werden.	`true`
`condition`mandatory		Hier wird die Abhängigkeit festgelegt. Zum Beispiel. condition="${variableA}"=="true"; prüft, ob die Variable A gesetzt wurde. Wenn ja, ist das angegebene Dokument obligatorisch.	`"${variableB}">="100"` `"${variableB}"!="${variableC}"` `"${variableB}"=="${variableA}"` `"(${count}+1)"=="150"` `"${varibleA}"=="${variableB}&&100>${count}"` `"${varibleA}"=="${variableB}\|\|100>${count}"`

Beispiel:

Wir haben einen einfachen Beispielprozess für diesen Actionhandler erstellt.

Wir haben dem Prozess ein intelligentes Formular beigefügt, das nach der Anzahl der angeforderten Artikel fragt. Wenn der Benutzer eine größere Zahl als den Schwellenwert eingibt, in unserem Beispiel 100, wird ein obligatorisches Dokument angefordert und der Vorgang wird erst fortgesetzt, wenn das Dokument hochgeladen wurde.

Der Actionhandler wird hier mit einem Parameter gesetzt, condition. variableX ist bereits in der SmartForm festgelegt, die dem Prozess zugeordnet ist.

Wenn wir 101 in das Eingabefeld eingeben und auf die Instanz des Startprozesses klicken, erhalten wir eine Fehlermeldung, die besagt, dass das obligatorische Dokument hochgeladen werden musste. Der Prozess wird erst gestartet, wenn die obligatorischen Dokumente hochgeladen wurden.