Skip to main content
A Job Group is an ordered set of steps that the Async Job Coordinator runs together. You build and schedule groups in the Job Group Manager.

Prerequisites

  • You have the FC Platform - Manage Async Jobs permission set.
  • A developer has deployed classes that implement FCORE_BASE.JobExecutor. See For Developers.

Create a Job Group

1

Open the Job Groups tab

Click the App Launcher and search for Job Groups.
The App Launcher search box with Job Groups typed in and Job Groups listed under Items

Find Job Groups from the App Launcher

2

Start a new group

Click New. The Job Group Manager opens.
The Job Groups All list view with the New button and one Job Group, Prospect Account Enrichment

The New button on the Job Groups list

3

Fill in the details

In Details, enter a Name and a Description. Leave Version at 1. Leave Is Active off for now.
The Job Group Manager Details section with Name, Version 1, Is Active off, and a Description filled in

The Details section of a new Job Group

4

Add the steps

In Job Definitions, click Add New Definition for each step. For each row, enter a Definition Name, choose an Apex Class, and set the Batch Size. Turn on Await wherever a later step depends on that step’s output.
The Job Definitions section with three rows, each with a Definition Name, Apex Class and Batch Size 200, Await checked on rows 1 and 2, and the Add New Definition button

Three Job Definitions with Await on for steps 1 and 2

5

Order the steps

Drag a row by its handle, or click Move Up or Move Down. The Seq. column renumbers from 1 as you reorder.
6

Save

Click Save. The message “Saved Successfully” appears, and the new group reopens in the Job Group Manager.
7

Activate and schedule the group

Turn on Is Active. Choose a Frequency in Scheduling (see Scheduling), then click Save.
The Scheduling section with Frequency set to Daily and Start Time 2:00 AM

A Daily schedule at 2:00 AM

You can turn on Is Active before the first Save. The Job Group Manager saves the group inactive, adds its definitions, then activates it, all in one Save. Inserting an active Job Group any other way fails with “A Job Group cannot be created in an active state.” Leave Frequency as None if you only want to start runs from code.

The Job Group Manager Sections

Click Exit in the header, or Cancel in the footer, to discard your changes. Exiting returns you to the record, or to the Job Groups list for a new group.

Details

Scheduling

The Scheduling panel appears only while Is Active is on. When it is off, the panel reads “Scheduling is available only for active Job Groups. Saving an inactive Job Group removes its existing schedule.”
  • Start Time uses your user time zone.
  • A Cron Expression is a Salesforce CRON expression in the form sec min hour day month ? year. It needs 6 or 7 parts and a ? in either the day-of-month or day-of-week position.
  • When you reopen a scheduled group, Frequency always shows Custom (CRON) with the stored expression, whichever preset you originally chose.

Job Definitions

Each row is one step. When a run starts, each row creates a Job Run Stage that tracks that step.

Save Rules

Save stays disabled until all of these are true:
  • Name, Version, and Description are filled in.
  • Every row has a name, an Apex class, and a batch size.
  • For an active group with Custom (CRON), the expression has 6 or 7 parts and a ? in the day-of-month or day-of-week position.
  • For Hourly, the minute is from 0 to 59.
If a pending run exists for the group, Save is blocked with a Pending Runs Found message. The banner “There are pending Job Runs for this Job Group” links to those runs with View Run. Other errors appear in a Save failed message that shows the first error, for example: If any part of the save fails, none of your changes are saved.

Change an Active Group

An active group is locked. Its Name, Version, and Description, and every step row, are disabled. The lock follows the group’s saved state.
The Job Group Manager for an active group: Is Active on, and the Name, Version, Description and every Job Definition row greyed out

An active Job Group in the Job Group Manager

1

Deactivate and save

Open the group, turn Is Active off, then click Save. Deactivating removes the schedule.
2

Make your changes

Edit the details and steps, then click Save.
3

Reactivate

Turn Is Active on, set the Frequency again, then click Save.

Delete a Job Group

An active group cannot be deleted. Deactivate it and save first, then open the Job Group record and click Delete.

Edit (Admin)

On a Job Group record, the Edit (Admin) action opens the standard Salesforce edit form instead of the Job Group Manager. It sits in the record page header next to Edit and Delete. All validation rules still apply.
The Job Group record page header with the Edit, Edit (Admin) and Delete buttons

Edit (Admin) on the Job Group record page

Limitations and Common Pitfalls

  • You cannot edit an active group. Deactivate and save first, then edit. Turning Is Active off on screen is not enough until you save.
  • Deactivating removes the schedule. Set the Frequency again when you reactivate.
  • Pending runs block saving. There is no Cancel action. To clear a stuck run, delete it; see Monitoring Job Runs.
  • The preset is not remembered. A saved schedule reopens as Custom (CRON).
  • Weekly and Monthly are fixed days. Weekly always runs on Monday and Monthly on the 1st. Use Custom (CRON) for other days.
  • Sequence does not mean wait. If step 2 reads what step 1 writes, turn on Await for step 1. Otherwise step 2 can start before step 1 finishes.
  • A schedule silently skips inactive or deleted groups. It does nothing and shows no error in the UI.
  • Retry context holds 32,768 characters. If too many failed record Ids do not fit in a retry stage’s context, fusionCore logs a Job Error and leaves the original errors on the run.
  • Inactive groups do not run. Starting one from code fails with “Cannot start job. Job Group is inactive.”
  • An empty Apex Class dropdown means no class is available. Ask a developer to deploy a global class that implements FCORE_BASE.JobExecutor.
  • Change schedules here, not in Setup. Job Group schedules also appear in Setup under Scheduled Jobs, but the Job Group Manager owns them.

Async Job Coordinator Overview

How runs, stages, and retries work.

Monitoring Job Runs

Read the results of a run.