data by applying mapping rules, and replaces data with that object. It uses the object-mapper path syntax.
Command Type
Command Type ID: 1016Parameters
Mapping Syntax
If
data is empty, the command returns the result unchanged.
Usage Examples
Rename and Flatten Fields
data:
data becomes:
Map Every Array Element
Best Practices
- Test Mappings: Run the step from the test panel with real sample data
- Parse first: Use JSON Parse when
datais a JSON string - Validate Output: Verify the mapped structure matches what your sink consumers expect
Common Use Cases
- Data Transformation: Transform data structures for downstream processing
- Field Mapping: Map fields between different formats
- Data Normalization: Normalize data from different sources
Related Commands
- Json Path - Extract data before mapping
- JSON Parse - Parse JSON before mapping
- Sink Commands - Send mapped data to destinations
Troubleshooting
- Empty result: Check that the source paths match the actual structure of
data - Unexpected nesting: Destination paths with dots create nested objects; use a flat name for a top-level field