Duaer

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