Mapper Node

Mapper Node

Module ID: ion.action.mapper

The Mapper node transforms input data into a new structure using the visual mapping component.

---

Overview

Use the Mapper node when you need to transform data between different formats, extract specific fields, or restructure payloads for downstream nodes or API calls.

The Mapper uses a visual interface (see Mapper Component) to define transformations.

---

Handles

Input

Handle	Description
input	Source data to transform

Outputs

Handle	Description
output	Transformed data
error	Invalid configuration or mapping error

---

Configuration

The Mapper node stores its configuration as a map with pre-computed transformation result:

// node.data structure
{
  params: any  // The resulting mapped data
}

Note

The actual mapping logic is computed at design time in the visual mapper. The node simply outputs the params field.

---

Behavior

1. Receives input data
2. Parses node.data configuration
3. Extracts the params field
4. Outputs the params to output handle

The visual Mapper component handles the complex transformation logic, producing a params object that this node outputs.

---

Example

Input Data

{
  "shopify_order": {
    "id": 12345,
    "customer": {
      "name": "John Doe",
      "email": "[email protected]"
    },
    "line_items": [...]
  }
}

Mapped Output (params)

{
  "order_id": "12345",
  "customer_name": "John Doe",
  "customer_email": "[email protected]"
}

---

Common Patterns

API Payload Transformation

[Get Order] → [Mapper] → [Create Shipment]

Data Extraction

[Webhook] → [Mapper: extract relevant fields] → [Process]

---

Error Cases

Error	Cause
”Invalid Form File”	node.data format incorrect
”Mapper not configured”	Missing params field in configuration

---

See Also

• Mapper Component - Visual mapping interface
• Flow Nodes Overview