Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Beschreibung

The ActionHandler ConditionalMandatoryDocumentHandler checks if one or more document(s) are uploaded and if a condition is valid. It can also check if the uploaded files do match one or more supplied file names. If no matching documents are found, an error message appears and the task can only be finished once the required document(s) are attached.

Info

If the document should be mandatory without a condition, this handler should be used:

MandatoryDocumentHandler

...

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.

Info

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

MandatoryDocumentHandler

...

Klasse

Code Block
com.dooris.bpm.actionhandler.ConditionalMandatoryDocumentHandler

...

Parameter

Parameter

Default ValueStandardwert

DescriptionBeschreibung

Valid examplesGültige Beispiele

pattern

A Character string, which must be present in the document name or description. One or multiple patterns may be entered (multiple terms being separated by commas).

If no pattern is given, a check is run to make sure that at least one document (regardless of how it is named) is attached!

PhoneNumberList

Muster

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 (Rufnummernliste)

  • PhoneNumberList,docx,TravelCostsReisekosten

descriptionBeschreibung

true

Denotes if the description of the document should also be checked according to the supplied pattern. Possible values for this are STIMMT

Gibt an, ob die Beschreibung des Dokuments auch nach dem mitgelieferten Muster geprüft werden soll. Mögliche Werte hierfür sind true (include) or oder false (do not include).false

FALSCH

caseSensitive

false

Denotes if upper and lowercase formatting should be considered. This parameter is only taken into account if there is a pattern specified! Possible values for this are true (upper- and lower-case formatting are important) or false (ignore).

false

fileType

Declaration of file endings (separated by commas). Checks if all documents conform to the file ending, no matter if upper- or lower-case (example: given fileType=pdf both .pdf and .PDF are valid). If only this parameter is supplied, the uploading of documents is not mandatory. However, if documents are attached, they must conform to the file endingsFALSCH

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).

FALSCH

fileType (Dateityp)

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

If set to “true”, all the attached documents must conform to the pattern specified above FALSCH

Wenn diese Option auf "true" gesetzt ist, müssen alle angehängten Dokumente dem oben angegebenen Muster (Parameter 1) . If “false”, only one file must conform to the pattern. Possible values for this are “true” or “false”.

true

checkCurrentNode

false

If set to “true”, the restrictions set by this handler are checked for documents uploaded on this current node.

true

conditionentsprechen. Wenn "false", muss nur eine Datei dem Muster entsprechen. Mögliche Werte hierfür sind "true" oder "false".

STIMMT

checkCurrentNode

FALSCH

Wenn auf "true" gesetzt, werden die von diesem Handler gesetzten Einschränkungen für Dokumente überprüft, die auf diesen aktuellen Knoten hochgeladen werden.

STIMMT

Zustand

Status
titlemandatory

The dependency is set here. E.gHier wird die Abhängigkeit festgelegt. Zum Beispiel. condition="${variableA}"=="true"; checks if the variableA has been set. If yes, the specified document is mandatory 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}"

Example:

We created a simple example process for this actionhandler.

We have a smartform attached to the process which asks for the number of the requested items. When the user enters a bigger number than the threshold, for our example it will be 100, a mandatory document will be requested, and the process won't be continued until the document is uploaded.

...

The actionhandler is set here with one parameter, condition. variableX is already set in the smartform attached to the process.

...

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, Zustand. 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.

...