UTIL_FormulaContext
Class · Group: Utilities
Learn it: Validation guide
global inherited sharing class UTIL_FormulaContextContainer 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
// 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, UTIL_FormulaFilter.INT_SObjectFormulaEvaluationContext, FormulaEval.FormulaInstance
Inner Classes
| Class | Description |
|---|---|
| AccountContext | Formula evaluation context for Account object. |
| ApiCallContext | Formula evaluation context for ApiCall__c records, the records that log each API call. |
| ApiIssueContext | Formula evaluation context for ApiIssue__c records, the records that log each failed API call. |
| CampaignContext | Formula evaluation context for Campaign object. |
| CaseContext | Formula evaluation context for Case object. |
| ContactContext | Formula evaluation context for Contact object. |
| EventContext | Formula evaluation context for Event object. |
| FoobarBulkContext | For testing only. |
| FoobarContext | Formula evaluation context for Foobar__c test object. |
| LeadContext | Formula evaluation context for Lead object. |
| OpportunityContext | Formula evaluation context for Opportunity object. |
| TaskContext | Formula evaluation context for Task object. |
| UserContext | Formula evaluation context for User object. |