Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypha-docs.plinqx.app/llms.txt

Use this file to discover all available pages before exploring further.

The TRANSFORM node transforms data using expressions and mappings, allowing you to reshape data between flow steps.

​
Overview

TRANSFORM nodes enable:
  • Data Transformation: Reshape data structures
  • Field Mapping: Map input fields to output fields
  • Expression Evaluation: Use expressions for calculations
  • Data Preparation: Prepare data for subsequent nodes

​
How It Works

1

Define Transformations

Map output fields to input expressions.
2

Evaluate Expressions

Transform node evaluates all expressions.
3

Build Output

Constructs output object from evaluated expressions.
4

Store Output

Output available to subsequent nodes.

​
Configuration

​
Field Mappings

Map output fields to input expressions: 
{
  "userId": "{{START.userId}}",
  "fullName": "{{START.firstName}} {{START.lastName}}",
  "timestamp": "{{$now}}",
  "count": "{{action.response.items.length}}"
}

​
Expression Support

Expressions support:
  • Variable Access: {{node.field}}
  • Nested Access: {{node.response.data.id}}
  • Functions: String, number, date functions
  • Calculations: Mathematical operations
  • Conditionals: Ternary operators

​
Example Transformations

String Concatenation: 
"fullName": "{{START.firstName}} {{START.lastName}}"
Array Length: 
"itemCount": "{{action.response.items.length}}"
Conditional: 
"status": "{{START.count > 0 ? 'active' : 'inactive'}}"
Date Formatting: 
"formattedDate": "{{$formatDate($now, 'YYYY-MM-DD')}}"

​
Use Cases

  • Data Normalization: Normalize data from different sources
  • Field Renaming: Rename fields for consistency
  • Data Enrichment: Add computed fields
  • Format Conversion: Convert between data formats

​
Best Practices

Clear Mappings

Use descriptive output field names

Validate Expressions

Test expressions before using in production

Handle Nulls

Account for null/undefined values

Document Logic

Document complex transformations

​
Next Steps

JSON Builder Node

Build complex JSON structures

Validate Node

Validate transformed data