Custom ActionInstall

Overview

This node performs a simple data transformation on input items. Specifically, it takes a specified field from each input item and creates a new field called transformedField that contains the original value prefixed with the string "Transformed: ". This is useful when you want to mark or modify data fields in a straightforward way without complex processing.

Common scenarios include:

• Adding a prefix or label to existing data fields for clarity.
• Preparing data for downstream nodes by tagging or annotating values.
• Simple demonstration or testing of data transformation logic within workflows.

Example: If an input item has a field name with value "John", and you specify name as the input field, the output will include a new field transformedField with value "Transformed: John".

Properties

Output

The node outputs an array of items where each item’s JSON data includes all original fields plus a new field:

• transformedField: A string containing the original value of the specified input field prefixed with "Transformed: ".

No binary data is produced by this node.

Example output JSON structure for one item:

{
  "originalField1": "value1",
  "inputField": "someValue",
  "transformedField": "Transformed: someValue"
}

Dependencies

• No external services or API keys are required.
• The node operates purely on the input data provided to it within the workflow.

Troubleshooting

• Error: The field "X" does not exist in the input!
  This error occurs if the specified input field is missing from any input item. Ensure that the field name is correct and exists in all input data items.

• General errors prefixed with "Error in CustomAction:"
  These indicate issues during execution, often related to missing parameters or unexpected input data formats. Verify that the input data matches expectations and that required properties are set.

Links and References

• n8n Documentation - Creating Custom Nodes
• JavaScript String Template Literals