StartProcessInstanceFromGroupRepetitive

This timer starts processes periodically, at certain points in time. These starting points can be described very intuitively (e.g.: The third day of every month). Also, it prevents overlapping starts within defined periods, ensuring efficient resource allocation and streamlined operation. The timer starts an instance for each of the members of the given group.


Webservice Name

ProcessInstanceManager

Webservice Method

createProcessInstancesByHandler

 

Parameters

Parameter

Description

Valid examples

Parameter

Description

Valid examples

Actionhandler

Contains the actionhandler that will be called by the timer. Normally:com.dooris.bpm.actionhandler.StartProcessInstanceFromGroupRepetitive

 

processDefinition

Name of the process definition that should be started.

 

variableNameForTopic

 

The name of the process variable, that contains the “topic” of the new instance.

 

contentForTopicVariable

The content of said “topic”-variable.

 

referenceTimePeriodString

Contains the period in question: YEAR, MONTH, WEEK

 

relativeStartPoint

 

Contains all days, at which new instances should be started. All days must be separated by an &. Valid values are -365 bis 365 oder MAX.

Examples:

  1. Start on the first day of each year:
    referenceTimePeriodString=YEAR
    relativeStartPoint=1

  2. Start on the last day of each month:
    referenceTimePeriodString=MONTH
    relativeStartPoint=MAX

  3. Start every Wednesday:
    referenceTimePeriodString=WEEK
    relativeStartPoint=3

  4. Start three days before the end of each month:
    referenceTimePeriodString=MONTH
    relativeStartPoint=-3

useBusinessCalendar

If true is handed over, the action handler will count only business days.

 

timeForStartCheck

A starting time can be handed over. The format has to be HH:MM.

 

 

criteriaForDuplicateCheck

 

Valid values are DEFINITION or TOPIC. If DEFINITION is handed over, no instance will be started if another instance of the same process was started in a certain period of time (periodeInDaysForExistenceCheckOfStartedInstanceInPast). If TOPIC is selected, no new instance will be started if another one was started with the same content in the topic variable.

 

periodeInDaysForExistenceCheckOfStartedInstanceInPast

An integer from 0 to 365 can be handed over. It described (in days) the period in time which is checked for duplicates of the process (criteriaForDuplicateCheck).

 

groupName

The name of the group that should be taken for starting the instance

 

ignoreArchivedInstances

If this flag is set to true, instances in the archive are ignored for the duplicate check. If set to false, the archive is not ignored.

true / false


Example:

com.dooris.bpm.actionhandler.StartProcessInstanceFromGroupRepetitive,Onboarding;myTopic;topiccontent1;MONTH;22&0;true;00:00;TOPIC;5;groupWithMember;true



image-20240729-063306.png