This article discusses the process of creating DotNetNuke Scheduled Jobs, all examples provided are for illustration purposes and represent the general structure of implementation.

Overview of Scheduled Jobs

At a foundation level a DotNetNuke Scheduled Job is simply a class that inherits from the SchedulerClient base class. As such you override a "DoWork" method that performs whatever custom action you desire.

The base class exposes a ScheduleHistoryItem class that provides a mechanism for your process to report success/failure and a method to report helpful information to users via the "History" reporting that is available within DotNetNuke.

Now, this all seems pretty simple right? Well there is one common gotcha with scheduled jobs that you want to be aware of, and that is the impacts of the "Scheduler Mode" property within Host Settings. Now the first question comes to mind is how would that change things, well the key is that if the scheduler is set to "Timer Mode", which is my recommended setting, Scheduled jobs will NOT have access to an HttpContext as they are processing. This can make file access a bit harder.

General Format

The following is a sample scheduled job class with all comments and custom code removed.

using System; 

using System.Collections.Generic;

using DotNetNuke.Services.Scheduling;



namespace YourNamespace

{

  public class YourJob : SchedulerClient 

  {

    public YourJob (ScheduleHistoryItem oItem)

     : base()

    {

       this.ScheduleHistoryItem = oItem;

    }



    public override void DoWork()

    {

       try

       {

          //Perform required items for logging

          this.Progressing();



          //Your code goes here

          //To log note

          //this.ScheduleHistoryItem.AddLogNote("note")



          //Show success

          this.ScheduleHistoryItem.Succeeded = true;

       }

       catch (Exception ex)

       {

          this.ScheduleHistoryItem.Succeeded = false;

          InsertLogNote("Exception= " + ex.ToString());

          this.Errored(ref ex);

          DotNetNuke.Services.Exceptions.Exceptions.LogException(ex);

       }

    }

 }

}

As you can see the format is pretty basic, thee are just a few key items to remember.

* Always wrap your custom code inside of a Try/Catch block to ensure that you can handle and log the detailed information about any error that might occur
* To enable logging and to show that your job has truly started, call the Progressing method early in your code
* Use the available AddLogNote functionality to log additional information that might be helpful. (For example Records Affected, or other types of diagnostic information)

From here you can build out your scheduled job as needed.

Installing/Configuring the Job

Once you have created your Scheduled Job and installed the dll, either via a module package or some other process, you simply need to add a new item to the DotNetNuke Schedule. To complete this process you will simply go to "Host" -> "Scheduler" and select the "Add Item to Schedule" option. The following is an outline of the values that you supply.

* Full Class Name and Assembly - Your assembly and class name, in the format of FQCN, Assembly (Example YourNamespace.YourJob, YourNamespace where YourNamespace.dll was the compiled project)
* Schedule Enabled - Check this to enable the item
* Time Lapse and Retry - To configure the frequency, values you desire
* Retain History - If set to none, any log writes you do will not be preserved, if using the AddLogNote option, you will want to retain at least a few values.

All of the other items are dependent upon your environment and specific needs. Once you save the record, your job will be scheduled to execute for the first time.
Conclusion

DotNetNuke scheduled jobs are very simple to build and are a great method to handle batch or offline processing for many needs. With a bit of planning and logging in place you can handle complex business needs easily. Feel free to share feedback below.

FORMATTER ERROR (Snippet Not Found)