Skip to main content
The Object Mapper command (Command Type: 1016) builds a new object from the command result’s data by applying mapping rules, and replaces data with that object. It uses the object-mapper path syntax.

Command Type

Command Type ID: 1016

Parameters

Mapping Syntax

If data is empty, the command returns the result unchanged.

Usage Examples

Rename and Flatten Fields

Given data:
the command result’s 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 data is 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

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