Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Dataflow Step entry
How-to guide

How to add a dataflow step to an existing CRM Analytics dataflow

You edit dataflow steps either in the Dataflow Editor's visual canvas or in the JSON editor. The JSON view is faster once you know the action vocabulary; the visual editor catches reference errors before you save.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 20, 2026

You edit dataflow steps either in the Dataflow Editor's visual canvas or in the JSON editor. The JSON view is faster once you know the action vocabulary; the visual editor catches reference errors before you save.

  1. Open the Dataflow Editor

    In CRM Analytics, go to Data Manager, then Dataflows and Recipes, pick your dataflow, then Edit. The canvas opens with each existing step as a node.

  2. Add a new step

    Click the action you need from the left rail (Filter, Augment, Compute Expression, etc.) and drop it onto the canvas. The editor inserts an empty step skeleton with placeholder parameters.

  3. Connect the source

    Drag from the previous step's output port to the new step's input. The editor wires the source parameter for you. For augment, drag two source connections: one for the left stream and one for the right.

  4. Configure parameters

    Open the step and fill in its action-specific parameters. computeExpression needs a column name, a type, and a SAQL expression. filter needs a saqlFilter clause. augment needs the join keys and a prefix for the added columns.

  5. Validate and save

    Click Update Dataflow. The editor validates the JSON, surfaces missing references, and warns about unregistered outputs. Fix any red flags before continuing.

  6. Run on demand to verify

    From the Data Manager, click Run Now next to the dataflow. Watch the Job Monitor for per-step row counts and timing. Confirm your new step's output looks right before relying on it in a dashboard.

Key options
sfdcDigestremember

Pulls rows from a Salesforce object via the Bulk API. Use complete: false for incremental loads on large tables.

augmentremember

Left-outer join of two streams on configurable keys. Adds the right stream's fields to the left with a prefix.

computeExpressionremember

Adds a calculated column whose value is a SAQL expression evaluated per row. Equivalent to a formula field at the dataflow layer.

filterremember

Narrows rows using a saqlFilter clause. Runs after augments and computes, so you can filter on joined or derived fields.

sfdcRegisterremember

Persists the output of a stream as a dataset. Includes optional row-level security predicates and dataset sharing.

Gotchas
  • Dataflows are deprecated for new ingestion since 2023. Build new pipelines in Data Prep Recipes unless you are extending an existing dataflow.
  • sfdcDigest queries count against your Bulk API limits. A nightly full extract on a multi-million-row object can dominate your daily Bulk usage.
  • Incremental sfdcDigest relies on SystemModstamp. Records updated by background jobs that suppress SystemModstamp will be missed by incremental runs.
  • Filtering happens on whatever fields exist at that point in the graph. Place filters after augments and computes if you need to filter on joined or derived columns.

See the full Dataflow Step entry

Dataflow Step includes the definition, worked example, deep dive, related terms, and a quiz.