Scheduling Jobs

Scheduling Concepts

Certain business use cases require specific operations to run automatically on a regular basis. JustOn Billing & Invoice Management provides a number of options that facilitate process automation.

With this respect, the following concepts are important:

Batch chain

A batch chain is a series of several linked complex operations, which are executed sequentially on multiple records (as selected from list views) at the same time.

JustOn Billing & Invoice Management ships a number of ready-to-use batch chains that cover certain business processes.

Batch parameters

Batch chains may require additional options. To this end, JustOn Billing & Invoice Management has introduced batch parameters, a type of custom settings that combine a batch chain with specific arguments. Consequently, you can use batch parameters to control the execution behavior of a batch chain.

Job schedule

Finally, you schedule a job. That is, you set up the specific Apex class ScheduledBatchChain to execute the intended batch chain at a defined interval. There are two options:

• If your batch chain does not need additional parameters, you schedule the job directly for the batch chain.
• If, otherwise, the batch chain requires additional parameters, you schedule the job for the specific batch parameters setting.

The following batch chains are available:

In a nutshell, setting up JustOn Billing & Invoice Management to automatically execute business processes comprises the following major tasks:

• Optionally, defining a batch parameter setting

• Scheduling the job, either

  • via JustOn's Scheduled Jobs page,
  • via the standard Salesforce Schedule Apex functionality, or
  • via the Developer Console

Defining Batch Parameters

Batch parameters control the execution behavior of a batch chain, a series of several linked complex operations, which are executed sequentially on multiple records (as selected from list views) at the same time.

You can define multiple batch parameters settings:

1. Click to enter Setup, then open Custom Settings.

   In Salesforce Lightning, navigate to Custom Code > Custom Settings.

   In Salesforce Classic, navigate to Develop > Custom Settings.

2. Click Manage in the row of Batch Parameters.

3. Click New.

4. Specify the details as required.

   • Name: Must match the Job Name to be set when scheduling the job
   • Batch Chain: The name of the batch chain to be executed as listed in Scheduling Concepts
   • Parameter 1..8: Define batch chain-specific execution options using the syntax parameter = value, for example, Interval = 2w or Alignment = next

5. Click Save.

Scheduling a Job

There are three ways to schedule a job:

• Scheduling a JustOn job
• Scheduling an Apex class
• Scheduling Job via the Developer Console

Scheduling JustOn Job

You can schedule a job using JustOn Billing & Invoice Management's Scheduled Jobs page.

1. Open the Scheduled Jobs page.

   Use the following URL https://login.salesforce.com/apex/ONB2__JobsSetup, or, if you are already logged in, append apex/ONB2__JobsSetup to your org's domain name.

   You can access the Scheduled Jobs page via the JustOn configuration app ( > JustOn Configuration > Jobs Setup).

   
   Scheduling a JustOn job

2. From the Apex Job drop-down list, select Batch Chain Job.

   Batch Chain Job is a user-friendly label for the ScheduledBatchChain Apex class.

3. In the Job Name field, specify the name of the batch chain (see Scheduling Concepts) or the name of the batch parameters setting.

   For details, see Scheduling Concepts.

4. From the Start Time drop-down list, select the preferred execution time.

   Optionally, edit the displayed cron expression to adjust the execution time.

5. Click Schedule.

   This sets up the job to execute the selected batch chain at the specified time.

Scheduling Apex Class

You can schedule a job using the standard Salesforce Schedule Apex functionality.

1. Click to enter Setup, then open Apex Classes.

   In Salesforce Lightning, navigate to Custom Code > Apex Classes.

   In Salesforce Classic, navigate to Develop > Apex Classes.

2. Click Schedule Apex on top of the list.

   
   Scheduling an Apex class

3. Specify the details as required.

   • Job Name: The name of the batch chain (see Scheduling Concepts) or the name of the batch parameters setting
   • Apex Class: ScheduledBatchChain
   • Frequency
   • Start
   • End
   • Preferred Start Time

4. Click Save.

   This sets up the job to execute the selected batch chain at the specified time.

For more details about Apex job scheduling, see Schedule Apex in the Salesforce Help.

Scheduling Job via the Developer Console

To schedule a batch chain, you can run the ScheduledBatchChain class in the Salesforce Developer Console, specifying the intended schedule.

1. Open the Developer Console.

   For details, see Open the Developer Console in the Salesforce Help.

2. Execute the following code

   ONB2.ScheduledBatchChain.setupSchedule(name, schedule);
   

   where name is the name of the batch chain or the batch parameters setting (see Scheduling Concepts) and schedule is a cron expression.

   This sets up the job to execute the selected batch chain at the specified time.

Scheduling JustOn Billing & Invoice Management Jobs