Fork me on GitHub

Module workflow alertforms

Introduction

This workflow module provides an alerting mechanism for form responses. It creates and stores alert entries based on a date extracted (or computed) from a form response and, when the deadline is reached, the module change automatically the state of the form response. The alert is displayed in the history of the form reponse.

Configuration

The task configuration defines the form, the retrieval strategy that yields the reference date, the number of days to add or subtract and the target state to apply after the deadline.

When TaskAlert runs for a form reponse, it computes the reference date (using a retrieval type) and inserts an Alert row if none exists for that form response.

A periodic daemon scans active alerts, compares reference_date + configured number of days with the current time, then triggers the action (state transition) and marks the alert executed.

Another daemon performs cleanup of obsolete alerts.

The retrieval system is extensible: new IRetrievalType implementations can be registered as Spring beans.

Usage

To use the module, install it into your Lutece instance. Configure the task in the workflow administration UI: choose the form, the retrieval type, the number of days, and the target state.