Example NodeInstall

Overview

This node, named "Example Node," is a basic transformation tool designed to add or modify a string property in each input item. It takes an input data array and for each item, it sets the myString field in the JSON output to a user-defined string value. This node is useful when you want to annotate or tag your data items with a consistent string, such as adding a label, note, or identifier.

Practical examples:

• Adding a custom comment or status message to each data item before further processing.
• Tagging all incoming records with a specific batch name or category.
• Injecting a placeholder or default string into data items for downstream nodes.

Properties

Output

The node outputs an array of items where each item's JSON data includes a new or updated property called myString. This property contains the string value provided by the user through the node's input parameter.

Output structure example:

[
  {
    "json": {
      "myString": "User provided string"
      // ... other original properties
    }
  },
  ...
]

No binary data is produced by this node.

Dependencies

• No external services or APIs are required.
• No special credentials or environment variables are needed.
• The node relies solely on the input data and the user-provided string parameter.

Troubleshooting

• Common issues:

  • If the input data is empty or not properly formatted, the node will simply pass through without modification.
  • Errors may occur if the input data is not an array or if the node parameter is missing or invalid.

• Error messages:

  • If an error occurs during execution for a particular item, and the node is configured to continue on failure, the error details will be attached to that item’s output under an error property.
  • Otherwise, the node throws an operation error indicating which item caused the failure.

• Resolution tips:

  • Ensure input data is correctly structured as an array of JSON objects.
  • Provide a valid string value for the "My String" property.
  • Enable "Continue On Fail" if partial processing is acceptable.

Links and References

• n8n Documentation - Creating Custom Nodes
• JavaScript Error Handling Best Practices