Organizations and data
Understand Duaer’s data structure
Understanding how Duaer structures and passes data between nodes is fundamental to building workflows. This guide covers the data structure format and how data flows.
Data structure
In Duaer, all data passed between nodes is an array of objects. It has the following structure:
[
{
"json": {
"apple": "beets",
"carrot": {
"dill": 1
}
},
"binary": {
"apple-picture": {
"data": "....",
"mimeType": "image/png",
"fileExtension": "png",
"fileName": "example.png"
}
}
}
]Put ordinary fields under json. Put files under binary on the same item. In the Code node, Duaer adds a missing json key and wraps a bare object in an array when needed. Custom nodes must still return items that include json.
How data flows within nodes
When you connect nodes, data passes from one node to the next automatically. Nodes process multiple items automatically: when a node receives an array of items, it performs the configured operation for each one.
For example, if you set a node to create a card and build the Name from an incoming field with an expression, the node creates one card per item.
Execute Once in the node settings is the exception: the node runs a single time for the whole input.
Understand what you are mapping with drag and drop
Data mapping maps the field path and loads the field’s value. Dragging fruit from the INPUT pane into a parameter creates {{ $json.fruit }}. When the node iterates over items, the field becomes the fruit value for each item.
Understand nested data
In the table view, a nested object is collapsed under a bold field name. Open it to see the keys inside. In an expression, walk down with dots, for example nested.example-string-field.
Questions
What does one item passed between nodes contain?
In Duaer, a node output is an array of objects. Each item has json for ordinary fields, and binary when a file is attached. Most nodes run once per item.
What does dragging a field from the INPUT pane insert?
In Duaer, an expression that points at the current item, such as {{ $json.customerId }}. It maps the field path; it does not freeze the value at drag time.
In this section
Work with files and images in Duaer
Understand and use binary data in Duaer.
DataUse the UI mapper in Duaer
In Duaer, data mapping means referencing data from previous nodes. It does not include transforming that data.
DataHow items link across Duaer nodes
In Duaer, each output item includes metadata that links it to the input item (or items) that generated it, creating a chain you can follow backward.