Rock Jobs

Rock is using the open source Quartz.NET job scheduling system for handling longer running, recurring tasks (Job). Although Quartz is complex and feature rich, you only need to know a few things to create a Job for Rock.

NOTE: For shorter running, simple tasks, you can use Transactions.

Writing a Rock Job

To create a custom Rock Job you only need to extend the IJob interface and implement the Execute() method. You can also use [BlockProperty] to hold administrator configured settings/values for your job.

using Quartz;

[BlockProperty( 0, "My Property", "MyProperty", "General",
    "This would be the description of this property.", false, "100", "Rock", "Rock.Field.Types.Integer" )]

public class MyCustomJob : IJob
{
    public virtual void Execute( IJobExecutionContext context )
    {
        // get the stored configuration property
        JobDataMap dataMap = context.JobDetail.JobDataMap;
        int someNumber = Int32.Parse( dataMap.GetString( "MyProperty" ) );

        // TODO: your code that does something interesting
    }
}