Please rate how useful you found this document: 
Average: 2 (1 vote)

Overview

Available Version: The Task Scheduler feature is available as of ProcessMaker 3.5.0.

The Task Scheduler manages internal processes using the Laravel queue processing architecture, thereby processing jobs that bypass internal ProcessMaker functions. The Task Scheduler improves run-time efficiency, performance and handling errors. Use Task Scheduler to configure the time and periodicity to run the activities that previously cron jobs ran. Instead of cron jobs, the Task Scheduler works for the Task Manager using queue jobs.

The Task Manager runs with the Laravel queue jobs when:

  • Unpausing cases
  • Sending pending emails
  • Activating pending plugins
  • Calculating the elapsed time of all open tasks in active cases according to the configured calendar
  • Running triggers for self service cases that have a configured timeout setting
  • Running the messageeventcron.php script that runs the send and receive message events and the email intermediate throwing and email end events
  • Running the timereventcron.php script that runs the timer start and intermediate timer events
  • Running the ldapcron.php script that runs the LDAP and Active Directory synchronization, which is an option available in Advanced LDAP/AD in the Enterprise Edition
  • Running the sendnotificationscron.php script that sends notifications, including to ProcessMaker Mobile, when cases are created and when cases are routed to new tasks
  • Running the actionsByEmailEmailResponse.php script that reads the Action by Email receiver account inbox looking for new messages
  • Calculating the app data of all cases in all processes
  • Calculating the behavior of the users

All of them are described in the Cron Scripts page.

Requirements

The Task Scheduler requires the PM_TASK_SCHEDULER_ADMIN permission. By default, the PM_TASK_SCHEDULER_ADMIN permission is enabled for the PROCESSMAKER_ADMIN role.

Task Scheduler Information

Each task in the Task Scheduler has the following characteristics:

  1. Search query: Search for a specific task.
  2. Enable: Enable a task's toggle key to enable that task. Otherwise, the task is disabled.
  3. Service: View the task name to be scheduled.
  4. Schedule time: View the scheduled interval in which to run the task.

    Note: If the task has the default settings, which use starting and ending times, you must set the server time zone to display it in the Schedule time column.

  5. Default Settings:When the Default Settings label displays, the Task Scheduler is using the base setting ProcessMaker recommends. Click the gear icon next to the Default Settings to customize the task configuration. Thereafter, the label changes to Custom Settings.
  6. Custom schedule settings: After clicking the gear icon to customize the task configuration, the Custom schedule settings window displays:

    • Periodicity: Required Set the interval in minutes and hours with a recursive run-time of the job task. Choose among the following values: Every minute, Every five minutes, Every ten minutes, Every fifteen minutes, Every thirty minutes and Every hour.
    • Starting time: Set a starting time to run a job task. The Time Zone setting enables with the client desktop's default timezone.
    • Ending time: If the starting time is enabled, it allows you set an ending time to stop a job task.
    • Time Zone: After setting the starting time, select a new time zone setting if necessary.
    • Repeat every: Define the repetition in weeks, months, and years.
    • Repeat on: Days that the job task running repeat. All days are selected by default. The values are: Mon, Tue, Wed, Thu, Fri, Sat and Sun.
    • Cancel: Cancel the above settings.
    • Save: Save custom changes.

Task Scheduler Modules

The Task Scheduler has the following modules:

Case Actions

Select which actions to trigger that intervene in cases, and at which interval.

In the actions list, the Timer event is enabled by default. The actions are the following:

  • Unpause cases: The default time is every hour. Hovering on the Service label, a tooltip displays Unpauses any case whose pause time has expired.
  • Calculated the elapsed time: The default time is every hour in UTC. Hovering on the Service label, a tooltip displays Calculates the elapsed time according to the configured calendar of all open tasks in active cases.
  • Unassigned case: The default time is every hour. Hovering on the Service label, a tooltip displays Run the trigger for self-service cases that have a configured timeout setting.
  • Clean self service tables: The default time is every hour in UTC. Hovering on the Service label, a tooltip displays Clean unused records for Self-Service Value-Based feature. It is a maintenance command.
  • Timer event: The default time is every minute. Hovering on the Service label, a tooltip displays Executes timer start and intermediate timer events. By default this task is enabled.

Emails and Notifications

Select which emails and case notifications ProcessMaker sends, and at which interval.

In the actions list, all of them are enabled by default. The actions are the following:

  • Case emails: The default time is every five minutes. Hovering on the Service label, a tooltip displays Task, triggers, and actions by email notifications.
  • Message events: The default time is every five minutes. Hovering on the Service label, a tooltip displays Intermediate and end email event.
  • Action by Email Response: The default time is every five minutes. Hovering on the Service label, a tooltip displays Action by email response account email revision.
  • Send notifications: The default time is every five minutes. Hovering on the Service label, a tooltip displays ProcessMaker mobile notifications.

Plugins

Available Version: It is not available in the ProcessMaker Community version.

Task Scheduler can run custom plugins that are embedded in the Task Manager plugin class. Custom plugins run collectively in Task Scheduler. All custom plugins may be enabled, disabled, or run at a specified interval through Task Scheduler.

All actions in the actions list are disabled by default. Enable the toggle key for the ProcessMaker plugin service action to enable all custom plugins embedded in the Task Manager plugin class, and then schedule the interval at which to run all custom plugins collectively.

ProcessMaker Sync

Available Version: It is not available in the ProcessMaker Community version.

Select when Task Scheduler synchronizes with your advanced LDAP to sync users in your organization with ProcessMaker.

All actions in the actions list are disabled by default. Enable the toggle key for the ProcessMaker LDAP cron action so Task Scheduler syncs with your advanced LDAP, and then schedule the interval at which Task Scheduler syncs.

Reporting

Available Version: It is not available in the ProcessMaker Community version.

Schedule at which interval to run KPI reports on ProcessMaker users and processes. Both KPI reports must be enabled, though each may be scheduled at different times and intervals.

All actions in the actions list are disabled by default. The actions are the following:

  • KPI Report by user: The default time is every ten minutes. Hovering on the Service label, a tooltip displays Recalculate KPI's information by user.
  • KPI Report by process: The default time is every ten minutes. Hovering on the Service label, a tooltip displays Recalculate main KPI board information.

Error Logs

For the error logs, take into account the following:

  • All errors are logged in the ProcessMaker Standard Logs that describe all references for errors that occur based on the ProcessMaker logs format and include Laravel Queue format.
  • All Actions by Email are logged in their log list.