数字组织与数据
理解 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。