Duaer

数字组织与数据

理解 Duaer 的数据结构

在 Duaer 里,弄清节点之间如何传数据,是搭数字组织的基础。本页说明数据格式,以及数据如何在节点间流动。

数据结构

在 Duaer 里,节点之间传递的都是对象数组,结构如下:

[
	{
		"json": {
			"apple": "beets",
			"carrot": {
				"dill": 1
			}
		},
		"binary": {
			"apple-picture": {
				"data": "....",
				"mimeType": "image/png",
				"fileExtension": "png",
				"fileName": "example.png"
			}
		}
	}
]

普通字段放在 json 里。文件放在同一项的 binary 里。Code 节点若漏写 json 键,运行时会补上,也会在需要时把结果包进数组。自己写的节点必须返回带 json 的项。

数据在节点内如何流动

连上节点后,数据会自动从上游传到下游。节点收到一组数据项时,默认对每一项分别执行配置好的操作。

例如把某个节点设为创建卡片,并用表达式从入站字段取 Name:进来两项就会建两张卡,每张卡用当前项的那个字段。

节点设置里的 Execute Once 是例外:整组输入只跑一次。

拖放映射的是什么

数据映射映射的是字段路径,并在运行时加载该字段的值。从 INPUT 面板把 fruit 拖进参数,会生成表达式 {{ $json.fruit }}。节点按项迭代时,该字段取当前项的 fruit。

理解嵌套数据

表格视图里,嵌套对象会用加粗的字段名收起来。点开才能看到里面的键。表达式里要用点号走到那一层,例如 nested.example-string-field。

常见问题

节点之间传递的一项数据包含什么?

在 Duaer 里,输出是对象数组。每一项有 json(普通字段);有文件时同一项还有 binary。大多数节点按项执行。

从输入面板拖字段会产生什么?

在 Duaer 里,会插入指向当前项的表达式,例如 {{ $json.customerId }}。这是字段路径引用,不是把当时的值抄死。

同组

画布

在 Duaer 里使用节点

在 Duaer 里,节点是取数入口、处理数据的一步,或把数据送出去的出口。

画布

在 Duaer 里把节点连在一起

在 Duaer 里,连线在节点之间建立链接,让数据沿数字组织流动。

画布

在 Duaer 里添加便签与说明

在 Duaer 里,用画布上的便签给数字组织加注解。

画布

在 Duaer 便签里用 Markdown

在 Duaer 里,便签支持 Markdown。标题、强调、列表、链接和代码会按版式显示。

结构

在 Duaer 里转成子数字组织

在 Duaer 里,在数字组织里选中一段节点,把它们收成可复用的子数字组织。

执行

在 Duaer 里自定义执行数据

在 Duaer 里,用 Code 节点或 Execution Data 节点给这次执行加上自定义数据,之后可在执行列表里按这些值筛选。

执行

在 Duaer 里隐藏执行数据

在 Duaer 里,控制执行记录里能否看见节点处理过的数据,用来保护敏感信息并满足合规要求。

数据

在 Duaer 里固定数据

在 Duaer 里,开发数字组织时,把某一步的输出钉住,之后的测试用这份数据,而不反复去拉外部系统。

数据

在 Duaer 里编辑节点输出数据

在 Duaer 里,在 JSON 视图里改节点输出,用来测边界情况,而不必每次都从外部系统重发。

数据

在 Duaer 里使用输入面板映射

在 Duaer 里,数据映射是引用前面节点的数据,不是改写数据本身。

数据

在 Duaer 里处理文件和图片

理解并使用 Duaer 里的二进制数据。

数据

在 Duaer 里数据项如何对应

在 Duaer 里,每个输出项都带着元数据,指向生成它的输入项,形成可回溯的链条。

数据

在 Duaer 里数据项对应错误

在 Duaer 里,用 .item 引用更早的节点时,若对应链条断了,或指向多项,运行会报错。

数据

在 Duaer 的 Code 节点里保留对应

在 Duaer 里,引用前面节点时,需要知道该用哪一项。大多数节点会自动链接;Code 节点在某些情况下要你自己写 pairedItem。