Everything you need to know about Schedulable Batch Apex

Sharing is Caring

Batch Apex has some incredible advantages over regular apex. The execution time of batch apex can be much longer and a lot more records can be processed. As you might remember from my blog article How to Process Thousands Of Records on Salesforce batch apex implements the Database.batchable interface and allows you to do large amounts of querying and processing.

Scheduling Batch Apex has even more benefits than batch apex: it can do large jobs regularly.

Schedulable Batch Apex Use Cases

One of my favourite uses of Scheduleable batch apex is using it to run daily or weekly data cleanup. For example, you might want to verify the billing state or country based on the postal code or zipcode OR maybe you need to create a renewal opportunity for your SaaS business.

How to Create a Schedulable Batch Apex Class

There are three fairly large steps in creating a Schedulable Batch Apex Class.

  1. Write a Batch Class.
  2. Write a Scheduled Apex class which then executes the Batch Class.
  3. Schedule the Scheduled Apex class from the Developer Console or from the User Interface.

Writing a Batch Class

As described above, a batch class is any class that implements Database.Batchable . A batch class includes a start method that returns a Database.QueryLocator, an execute method that returns void, and a finish method that returns void as well.

global class BatchClassExample implements Database.Batchable<SObject>{
    // used to build the query and get the records. For every 200 execute is called.
    // It's possible to have the execute run for smaller batches too. :)
    global Database.QueryLocator start(Database.BatchableContext BC) { 
        String soqlquery = 'SELECT Id, name, phone FROM Account';
        return database.getquerylocator(soqlquery);
    }
    
    // The batch job executes and operates on records of a max size of 200
    global void execute(Database.BatchableContext BC, List<SObject> scope) { 
        // your logic on the list of records goes in here...
    }

    // Finish runs at the end
    global void finish(Database.BatchableContext BC) { 
        System.debug('BatchApexClassExample Batch job completed successfully.');
    }
}

The finish method executes at the end and is a good way of doing any cleanup.

Writing Schedule Apex Class that Executes the batch Class

Scheduling Apex makes a lot of sense for routine operations – data cleanup, enrichment, closing off old opportunities, etc. All the class has to do is implement Schedulable and have an execute method which takes in the SchedulableContext.

global with sharing class ScheduleBatchExample implements Schedulable {
    global void execute(SchedulableContext sc) {
        //Database.executeBatch takes in the class, and then the size of batches.
        ID BatchId = Database.executeBatch(new BatchClassExample(), 200);
    }
}

Next, we need to schedule the class.

Scheduling the Schedulable Apex Class

A class can be scheduled through the user interface (Setup -> Apex Classes -> Click on Schedule Apex Button), through the developer console, or even through code.

 System.schedule('ScheduleBatchExample', '0 0 * * * ?', new ScheduleBatchApexClassExample());

I’ve used apex to schedule jobs during a package installation process. In particular, Spinify’s package actually uses quite a bit of scheduled apex.

Wrapping It Up

Scheduling Batch Apex is a great way of processing a lot of records. Salesforce reduces a lot of the governor limits if you used asynchronous apex.

Sharing is Caring

Brian is a software architect and technology leader living in Niagara Falls with 13+ years of development experience. He is passionate about automation, business process re-engineering, and building a better tomorrow.

Brian is a proud father of four: two boys, and two girls and has been happily married to Crystal for more than ten years. From time to time, Brian may post about his faith, his family, and definitely about technology.