数字组织与数据

在 Duaer 里处理文件和图片

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

二进制数据是文件类数据，例如图片或文档。文件不放在 json 里，而挂在同一项的 binary 上，用名字区分，例如 invoice。

"binary": {
	"invoice": {
		"data": "<base64>",
		"mimeType": "application/pdf",
		"fileName": "invoice.pdf",
		"fileExtension": "pdf"
	}
}

在数字组织里处理二进制数据

可用节点，也可用代码。常用节点：

Convert to File：把文本、JSON、表格转成文件写入 binary。
Extract From File：从 binary 文件读回表格或文本。
Read/Write Files from Disk：自托管时读写本机磁盘。云端没有你的磁盘。
另有 HTML、XML、Compression、Edit Image、FTP 等，仍走 binary 槽位。

自托管时配置二进制存储

自托管可用环境变量选择二进制数据存哪里。例如 DUAER_DEFAULT_BINARY_DATA_MODE（default 表示内存，filesystem / s3 / azure / database 表示对应存储），以及 DUAER_BINARY_DATA_STORAGE_PATH、DUAER_AVAILABLE_BINARY_DATA_MODES。

换存储不会改变节点里引用的 binary 名字。输出含 binary 时不能固定；隐藏执行数据时 binary 会从记录里拿掉。

常见问题

文件放在数据项的哪里？

在 Duaer 里，不在 json 里，而在同一项的 binary 下，用名字区分。内容在 data（base64），并带 mimeType、fileName、fileExtension。

自托管怎么选二进制存储？含 binary 的输出能固定吗？

在 Duaer 里，用 DUAER_DEFAULT_BINARY_DATA_MODE 等环境变量选择内存、文件系统或外部存储。含 binary 的输出不能固定；隐藏执行数据时 binary 会从记录里拿掉。

同组

在 Duaer 里使用节点

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

在 Duaer 里把节点连在一起

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

在 Duaer 里添加便签与说明

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

在 Duaer 便签里用 Markdown

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

在 Duaer 里转成子数字组织

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

在 Duaer 里自定义执行数据

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

在 Duaer 里隐藏执行数据

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

理解 Duaer 的数据结构

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

在 Duaer 里固定数据

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

在 Duaer 里编辑节点输出数据

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

在 Duaer 里使用输入面板映射

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

在 Duaer 里数据项如何对应

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

在 Duaer 里数据项对应错误

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

在 Duaer 的 Code 节点里保留对应

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