Creating rowsource-based alerts

To create rowsource-based alerts, you must have Java class knowledge or the assistance of someone with Java class knowledge.

Before you can create a rowsource-based alert, create a source class. For an example of a source class, see the Late – Left Early alert that is included with the application.

To create a rowsource-based alert:

  1. Select Maintenance > Messaging > Alert Definitions.
  2. Click Create New Entry.
  3. Specify the name of the new alert in the Alert Name field and a brief description in the Description field.
  4. Specify the start time and end time in the fields that are provided. These times define when the alert can be run by the Job Scheduler.
    Be sure that the start and end times that you specify are coordinated with the times that are defined for the Job Scheduler task that runs the alert.

    For example, if the alert start and end times are set to 10:00am and 3:00pm and the Job Scheduler task that runs the alert is set to run every hour between 9:00am and 4:00pm, the alert is not generated by the Job Scheduler task at 9:00am and 4:00pm.

  5. Select alert recipients from these options:
    • Select the individual users to receive the alert from the Recipient User Names lookup.
    • Select the teams to receive the alert from the Recipient Team Names lookup.
    • Select the roles to receive the alert from the Recipient Role Names lookup.
  6. Optionally, select the Send to Self check box to send the alert to all the employees that are selected in the alert query. Employees can only see their own information.
  7. Optionally, select the Recipient Check Scheduled check box to send the alert to only employees who are scheduled to work. Recipients that are not scheduled to work when the alert is sent do not receive the alert message.
  8. Select ROWSOURCE from the Source Type drop-down list.
  9. Specify the path of the application rowsource builder class for the alert in the Source Class field.
    For example, the Late-Left Early Alert uses this source class:
    com.workbrain.app.wbalert.source.TimeCodeAlertSource 
    			 
  10. Specify a brief description of the message subject in the Message Subject field.
  11. Specify the title to display at the top of the alert message in the Message Header field.
  12. Optionally, specify a message to display at the bottom of the alert message in the Message Footer field.
  13. Optionally, select the Send Message If Blank check box to send alerts with no query results to recipients.
  14. Select one of these options from the Message Content Type drop-down list:
    • text: Uses plain text to format the message output.
    • HTML: Uses HTML to format the message output.

    Messages cannot exceed 4000 characters in length, including HTML code.

  15. Click Save.
Now that the alert is created, schedule the alert using the Job Scheduler.