About

Designed to perform periodic tasks for a process, such as reminding the executor about it.

Setup

You can see (process Plugin Task) the plugin operation in Demo System.

Make sure the plugin is enabled and append to the configuration for every task type:

task:type.{@inc:cnt}.id=<ID>
task:type.{@cnt}.title=<TITLE>
task:type.{@cnt}.doExpression=<JEXL>

Where:

  • <ID> - unique string identifier;

  • <TITLE> - displayed task title;

  • <JEXL> - JEXL expression with the logic.

In addition to Standard Process Context, the JEXL script context also receives:

Example of task type configuration, sending news reminders:

task:type.{@inc:cnt}.id=reminder
task:type.{@cnt}.doExpression=<<END
    text =
        "Please pay attention to the process in which you are listed as an executor.<br/>" +
        "Description:<br>" + process.getDescription();
    text += "<br/><a href='#' onClick='$$.process.open(" + process.getId() + "); return false;'>Open Process</a>";
    news = new("ru.bgcrm.model.News", true, "Reminder about the process #" + process.getId(), text);
    news.setUserId(taskObject.getConfig().getInt("userId", 0));
    // send a news to process executors
    new("ru.bgcrm.dao.NewsDAO", conSet.getConnection()).updateNewsUsers(news, process.getExecutorIds());
    // or to the users with ID 1 and 2
    // new("ru.bgcrm.dao.NewsDAO", conSet.getConnection()).updateNewsUsers(news, { 1, 2 });
END

Scheduler

Checking and executing tasks is performed by the TaskRunner class, the launch of which is configured in Scheduler. Example:

// PzdcDoc snippet of: 'Configuration of "TaskRunner"', lines: 15 - 15

scheduler.task.taskRunner.class=TaskRunner

Process Type

To enable the Tasks tab, add process type configuration.

task:processShowTasks=1

A task itself can be created using Standard Process Change Listener. For the reminder example task type above it has been done on change a process parameter of type date (you can use datetime as well) with ID 39.

onProcessEvent.{@inc:cnt}.events=paramChanged:39
onProcessEvent.{@cnt}.doExpression=<<END
    t = new("ru.bgcrm.plugin.task.model.Task", "reminder", process.getId(), event.getValue());
    t.getConfig().put("userId", user.getId().toString());
    task.setTask(t);
END

Usage

A reminder task appears in the Tasks tab after changing the process parameter.

reminder set

Once the scheduler task is executed first time after the deadline has been reached, the news is shown for executors.

reminder show