TritonFlow
Documentation for the TritonFlow Apex class that provides core logging functionality for Flow Builder and Process Builder.
Overview
The TritonFlow class provides the server-side implementation for Flow and Process Builder logging. It handles automatic transaction management, Flow context capture, and validation of logging parameters.
Flow Logging Methods
log
Creates logs from Flow or Process Builder. This method will:
Create logs with default INFO level if not specified
Handle automatic transaction management (create new or resume existing)
Capture Flow context (Interview GUID, Flow API Name)
Process custom field mapping through JSON
Validate category and log level enums
Return stacktrace information for error handling
Returns:
List containing stacktrace information for each log
Field Mapping Reference
Core Fields
category()
flowLog.category
No
type()
flowLog.type
No
area()
flowLog.area
Yes
level()
flowLog.level
No
summary()
flowLog.summary
Yes
-
details()
flowLog.details
No
-
operation()
flowLog.operation
No
-
Context Fields
🔍 Flow Context The system automatically captures and sets critical Flow execution context:
Interview GUID for tracking specific Flow runs
Flow API Name for identifying the Flow definition
Transaction ID for cross-context correlation
Additional Fields
Custom fields can be passed through the additionalFields
JSON string:
Automatic Behaviors
⚡ Smart Defaults The system provides intelligent default behaviors to ensure robust logging:
Transaction Management
Creates new transaction if none exists
Maintains transaction context across Flow elements
Issue Creation
Automatically creates issues for ERROR level logs
Links related records for context
Batch Processing
Buffers logs for efficient processing
Flushes logs after batch completion
Validation Rules
Required Fields
area
- Functional area identifiersummary
- Log message summaryinterviewGUID
- Flow interview identifier
Enum Validation
The system validates and provides fallbacks for:
Log Level
Defaults to INFO with warning
Category
Defaults to Flow with warning
Error Handling
📝 Validation Messages When validation issues occur, the system:
Applies appropriate defaults
Appends warning messages to the details field
Continues processing without interruption
Related Classes
The TritonFlow class works with:
Transaction Management
The system provides two modes of transaction handling:
Auto-Create: If no transaction exists and no ID is provided, creates new
Resume: If transaction ID is provided, resumes existing transaction
This enables correlation of logs across different Flow elements and contexts.
Stacktrace Handling
This functionality is facilitated by the X-Ray machine only. If logging manually, disregard these values.
Current Trace: Captured in
stacktrace
fieldFull Trace: Combines previous traces with current in
fullStacktrace
Automatic Chaining: Each FlowLogOutput contains the combined trace
This is used by the X-Ray machine for tracking error propagation through multiple Flow elements.
Last updated