# UTIL_FormulaContext

**Class** · Group: `Utilities`

Learn it: [Validation guide](/validation-guide)

<div class="apex-member apex-class">

```apex
global inherited sharing class UTIL_FormulaContext
```

Container for pre-built formula evaluation context classes for standard Salesforce objects.

This class provides typed context implementations for Salesforce's `FormulaEval` namespace,
enabling dynamic formula evaluation against standard object records. These contexts can be used
in any scenario requiring formula evaluation, including but not limited to:

    - **Trigger Action Framework** - Entry criteria formulas on `TriggerAction__mdt`

    - **Custom Business Rules** - Configurable filtering or validation logic

    - **Flow Extensions** - Dynamic formula evaluation in Apex-backed Flow actions

    - **Batch Processing** - Record filtering based on formula criteria

**Supported Objects:** Account, Contact, Lead, Opportunity, Case, Campaign, Task, Event, User, ApiCall__c, ApiIssue__c, Foobar__c (test object)

**Formula Variable Names:**

    - `oldRecord` - Record state BEFORE an operation (null when no prior state exists)

    - `newRecord` - Record state AFTER an operation (null when record is being removed)

A formula cannot compare a picklist field with = or <>, so such a formula is refused. Turn the picklist value into text
with TEXT() first, as in TEXT(newRecord.Industry) = "Technology". The examples below do this.

Inner classes are GLOBAL because Salesforce `FormulaEval.FormulaInstance.evaluate()`
requires runtime access to context properties. The `global` visibility ensures
cross-namespace access when the managed package evaluates formulas in your org.

**Why global visibility is required:**

    - Member variables must be accessible by FormulaEval at runtime

    - For managed packages, `global` guarantees visibility across all scenarios

    - Context classes you write in your org must also use `global` for the same reason

**Example**

```apex
// Direct usage with Formula.builder()
FormulaEval.FormulaInstance formula = Formula.builder()
    .withFormula('newRecord.AnnualRevenue > 1000000 && TEXT(newRecord.Industry) = "Technology"')
    .withReturnType(FormulaEval.FormulaReturnType.BOOLEAN)
    .withType(UTIL_FormulaContext.AccountContext.class)
    .build();
UTIL_FormulaContext.AccountContext context = new UTIL_FormulaContext.AccountContext();
context.setContext(null, account);
Boolean matches = (Boolean)formula.evaluate(context);
```

**See Also:** [UTIL_FormulaFilter](/reference/apex/util-formulafilter), [UTIL_FormulaFilter.INT_SObjectFormulaEvaluationContext](/reference/apex/util-formulafilter-int-sobjectformulaevaluationcontext), [FormulaEval.FormulaInstance](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_class_formulaeval_FormulaInstance.htm)

</div>

---

## Inner Classes

| Class | Description |
|-------|-------------|
| [AccountContext](/reference/apex/util-formulacontext-accountcontext) | Formula evaluation context for Account object. |
| [ApiCallContext](/reference/apex/util-formulacontext-apicallcontext) | Formula evaluation context for ApiCall__c records, the records that log each API call. |
| [ApiIssueContext](/reference/apex/util-formulacontext-apiissuecontext) | Formula evaluation context for ApiIssue__c records, the records that log each failed API call. |
| [CampaignContext](/reference/apex/util-formulacontext-campaigncontext) | Formula evaluation context for Campaign object. |
| [CaseContext](/reference/apex/util-formulacontext-casecontext) | Formula evaluation context for Case object. |
| [ContactContext](/reference/apex/util-formulacontext-contactcontext) | Formula evaluation context for Contact object. |
| [EventContext](/reference/apex/util-formulacontext-eventcontext) | Formula evaluation context for Event object. |
| FoobarBulkContext | For testing only. |
| FoobarContext | Formula evaluation context for Foobar__c test object. |
| [LeadContext](/reference/apex/util-formulacontext-leadcontext) | Formula evaluation context for Lead object. |
| [OpportunityContext](/reference/apex/util-formulacontext-opportunitycontext) | Formula evaluation context for Opportunity object. |
| [TaskContext](/reference/apex/util-formulacontext-taskcontext) | Formula evaluation context for Task object. |
| [UserContext](/reference/apex/util-formulacontext-usercontext) | Formula evaluation context for User object. |
