TotalApp Docs

Logic & Transform

Conditions, loops, switches, filters, aggregation, and a JavaScript sandbox for custom logic.

Overview

The Logic & Transform group is the workhorse of a pipeline — it holds nodes for branching, looping, reshaping, and scripting data as it flows from a source toward an output. This group spans four underlying node categories: Logic, Transformer, Transform, and Script.

Nodes in This Group

Logic

NodeDescription
ConditionBranches the pipeline based on a true/false expression evaluated against the upstream value.
TransformApplies a simple field-level transformation to the upstream value.
Loop / IteratorRepeats a downstream branch once per item in an upstream array.
Switch / MatchRoutes the pipeline down one of several branches based on matching a value against a set of cases.
Math / CalculationEvaluates a numeric expression using upstream values as variables.
State / CacheStores or retrieves a value across workflow runs.
Manual ApprovalPauses the workflow until a user approves or rejects continuation.

Transformer

NodeDescription
GitIngestConverts a Git repository's contents into a single text blob for downstream AI processing.
SummarizerProduces a shorter summary of the upstream text.
TranslatorTranslates the upstream text into a target language.

Transform

NodeDescription
FilterKeeps only the items in an upstream array that match a condition.
TransformReshapes upstream data into a different structure.
AggregateReduces an upstream array into a single summary value (sum, count, average, etc.).
SortReorders an upstream array by a chosen field.
DedupRemoves duplicate items from an upstream array.
Template RendererFills a text template with upstream values.
Data AnonymizerMasks or removes sensitive fields from upstream data.
CompressionCompresses or decompresses upstream data.

Script

NodeDescription
Script EngineRuns custom JavaScript against the upstream value, available as the input variable.
JSON EditorEdits upstream data as JSON directly in the node's panel.
Plain TextPasses through or edits upstream data as plain text.

Usage Tips

Reach for Script Engine last

Try Filter, Transform, Aggregate, and Sort first — they cover most reshaping needs without code. Drop into Script Engine only when the logic can't be expressed with the built-in nodes.

Manual Approval pauses execution

A workflow with a Manual Approval node will sit paused, waiting for a user to approve or reject it, before continuing to downstream nodes. Use this for workflows that touch production data or send external communications.

Frequently Asked Questions

What variable holds the upstream value inside Script Engine?
The input variable holds whatever value the connected upstream node produced — a string, number, array, or JSON object depending on that node's output.
Does Loop / Iterator run its branch in parallel or one at a time?
Items are processed sequentially, one at a time, in the order they appear in the upstream array.