UTIL_AsyncChain.ChainStep

Class

global inherited sharing abstract class UTIL_AsyncChain.ChainStep implements IF_Chain.Step

Implements: IF_Chain.Step

Known Derived Types: UTIL_AsyncChain.ApiStep, IF_Chain.Step.work(UTIL_AsyncChain.ChainContext)

Abstract base class for individual steps in an async chain. Each step runs in its own Queueable transaction, providing governor limit isolation.

Example

public class LoadDataStep extends UTIL_AsyncChain.ChainStep
{
    public override UTIL_AsyncChain.StepResult work(UTIL_AsyncChain.ChainContext context)
    {
        List<Account> accounts = new SEL_Account().toList();
        context.put('accountCount', accounts.size());
        return UTIL_AsyncChain.succeeded('Loaded ' + accounts.size() + ' accounts');
    }
}

---

Methods

Method	Description
global virtual UTIL_Retry.Strategy createRetryStrategy()	Optional per-step retry strategy.
global abstract UTIL_AsyncChain.StepResult work(UTIL_AsyncChain.ChainContext context)	Execute the step's business logic.

createRetryStrategy

global virtual UTIL_Retry.Strategy createRetryStrategy()

Optional per-step retry strategy. Return null (the default) for no retry — a failure is final on the first attempt, exactly as before this member existed. Retry TRANSIENT failures only (locks, timeouts, 5xx-shaped results): compose UTIL_Retry.retryOnlyOnException(...) / dontRetryOnException(...) so deterministic failures are never re-burned; a validation error retried N times across a storm of trigger-spawned chains costs async budget with zero chance of success. Steps that retry MUST be idempotent — pair with ChainContext.idempotencyKey(). Exception filters apply only when the step failed by THROWING; a failed StepResult carries no exception, so only the attempt budget gates it.

A chain retrying enough to exhaust queueable stack depth degrades to Stalled and is recovered by the watchdog from a fresh root. Backoff has whole-minute granularity — the platform's delayed enqueue is minute-based, so any computed backoff over 0 seconds rounds UP to the next full minute (a 2-second backoff waits ~1 minute; only withBaseBackoff(0) re-enqueues immediately); do not expect sub-minute retry precision.

The backoff delay applies only to the retried attempt's enqueue: it fires exactly once, on the retry itself, and the steps after a recovered retry run without any added delay. A chain that has retried also carries increased queueable stack-depth headroom for the remainder of its run — each retry link genuinely deepens the chain, so the extra depth stays available to the hops that follow.

Returns UTIL_Retry.Strategy — The retry strategy for this step, or null (the default) for no retry.

work

global abstract UTIL_AsyncChain.StepResult work(UTIL_AsyncChain.ChainContext context)

Execute the step's business logic. Each step runs in its own Queueable transaction, so callouts and DML are both permitted. However, standard Apex ordering rules still apply WITHIN a step: perform all callouts before any DML. A step that does DML then a callout will throw CalloutException.

Do not call UTIL_AsyncChain.newChain(...).execute() from inside this method. Async chains do not support nested execution. The inner chain consumes Queueable stack-depth budget against the outer chain (capped by AsyncOptions.maximumQueueableStackDepth, default 50), and ChainContext writes happen on the OUTER chain's AsyncChainExecution__c row only — the inner chain has its own row, totally disconnected. Either add the inner steps to the parent chain via .then(...) or enqueue a separate Queueable from outside the chain (e.g. from onComplete's handler step) that targets a fresh chain.

Parameters

Parameter	Type	Description
context	UTIL_AsyncChain.ChainContext	Shared chain context for reading/writing state between steps.

Returns UTIL_AsyncChain.StepResult — StepResult indicating success or failure.

Example

public override UTIL_AsyncChain.StepResult work(UTIL_AsyncChain.ChainContext context)
{
    String previousValue = (String)context.get('inputKey');
    context.put('outputKey', 'processed');
    return UTIL_AsyncChain.succeeded('Done');
}

Fields

Field	Description
global String stepName	Optional step name for identification in logs and status.

stepName

global String stepName

Type: String

Optional step name for identification in logs and status.