Skip to main content

Job WfFinishOrApproveActivities

General​

The job WfFinishOrApproveActivities processes open workflow activities for selected process definitions and persons. It can automatically process matching approval or review activities and complete other open activities. In the supplied job descriptor, the job can be activated, is configurable and is not active by default.

Processing​

  • The selected process definitions and also hidden workflow entries are queried.
  • The period is determined either absolutely via start and end date or relatively from today back over the configured number of days.
  • Processing can be restricted to persons, groups and clients. If these filters are empty and the job is assigned to a client, the persons of this client are used.
  • The job processes the activities found repeatedly until no further activity can be processed.
  • An activity is only processed if the configured role is not already assigned as a participant and a completing person can be determined.

Job configuration​

Process definitions and role​

  • Process definitions: Selection of the process definitions to which the job is applied.
  • Role: The job processes activities only if this role is not currently entered as a participant.

Person, group and client​

The optional filters Persons, Groups and Clients determine for which processors open activities are searched. Multiple selections are merged.

Completing person​

The mode determines on whose behalf the activity is processed:

  • Author: Author of the process.
  • Full System Administrator: System administrator.
  • Last processor: the last processor from the completion log; if there is none, the author.
  • Custom: a specifically selected person.

Approve and review​

  • Approve activity: If enabled, activities requiring approval are approved via the completing person. If the option is disabled, such activities remain unchanged.
  • Review activity: If enabled, activities requiring review are reviewed via the completing person. If the option is disabled, such activities remain unchanged.
  • Activities without required approval or review are completed. If necessary, the job accepts the activity beforehand.

Period​

  • Absolute: optional start and end date.
  • Relative: from today minus Number of days in the past until today.
  • Empty absolute limits remain open and are not set artificially.

JavaScript hook​

Optionally, a JavaScript hook function can be executed before the activity is processed. It can change workflow variables via varMap. Also available are appCtx, listItem, procId, actId, finishingPersonWorkflowId and processDefinition. The changed variables are then saved.

Email​

If Mail to the next workflow processor is enabled, the job collects the email addresses of the main processors of the affected processes and, after processing, sends a message with the configured Mail subject and Mail content.