> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/build/process-sources.md).

# 在 Duaer 里添加流程数据来源

流程数据来源告诉 Duaer 去哪里读事项的步骤：CSV 或 XLSX 文件、PostgreSQL、MySQL、Microsoft SQL、Oracle、飞书多维表格或飞书审批。按向导选列、对照步骤、预览问题、设好频率，确认后 Duaer 按时读取新数据。
## 打开向导

1. 打开项目 › 数据表 › Duaer cases，点「流程数据来源」。
2. 点「添加数据来源」。向导有六步：连接、列、映射、预览、运行频率与可见范围、确认。点已完成的步骤可以回去修改。只有所有者和管理员能添加。

## 连接：数据在哪里

数据来源名称在选好文件或数据表后会自动填写，也可以自己改，可以用中文、字母、数字、空格、点、短横线或下划线，例如「实验室 样本」。再从列表里选数据中时间所在的时区，默认是浏览器的时区。

- CSV 或 XLSX 文件：上传不超过 20 MB 的文件，XLSX 选一个工作表。
- PostgreSQL、MySQL、Microsoft SQL、Oracle：选项目里已有的这类凭证；还没有时点「新建凭证」，保存后会自动选上。再选表。下一步默认勾选全部列，取消勾选的列 Duaer 不会读取；「关联表」会列出同一个库里和这张表相关的表：优先按数据库里定义的主键和外键判断，没有定义时再看列名（例如两张表都有样本编号）；一行会对应多行的表（例如一个样本的多次复检）不会被建议，以免事项重复，点「添加」就能把它的列一起读进来，例如检测结果、客户所在地区；也可以「添加其他表」手动选两边的列，最多关联 3 张表。「行变化时会更新的列」勾选以后可能变化的列，例如每个步骤的时间列，任一列比上次读取时新，这一行就会重新读，后来补上的步骤也能读到。
- Google 表格、Excel（OneDrive / SharePoint）：选一个 Google Sheets 或 Microsoft Excel 的 OAuth2 凭证（也可以用 Google、Microsoft 的通用 OAuth2 凭证），粘贴表格链接，点「打开」，再选工作表。Google 表格就是浏览器地址栏里的链接，链接里指向的工作表会被自动选上；Excel 在 OneDrive 或 SharePoint 里点「共享」→「复制链接」。第一行是表头；每次读取都会重新读整张表，已经写过的步骤不会重复写入。接着直接进入映射。
- Xero：选一个 Xero OAuth2 凭证，点「加载组织」，再选 Xero 组织和单据：销售发票（订单到收款）或采购账单（采购到付款）。每张单据的开具、历史记录里的步骤（创建、审批、发送、作废等，修改、备注和附件不算）、每笔付款和全部付清都会成为步骤；映射是固定的，不用选列。每次读取上次之后有变化的单据，最多 100 张，并控制调用次数不超过 Xero 的限制（每分钟 60 次、每天 5000 次）；第一次单据很多时会分几次读完。
- QuickBooks Online：选一个 QuickBooks Online OAuth2 凭证，点「加载公司」确认凭证连接的公司，再选单据：销售发票或采购账单。QuickBooks 不提供单据的修改记录，步骤来自单据本身和关联的单据：销售发票有报价单和报价单接受（关联的报价单）、创建、开具、发送（邮件发送时间）、每笔收款和全部收清；采购账单有采购订单、创建、开具、每笔付款和全部付清。映射是固定的，不用选列。每次读取上次之后有变化的单据，最多 100 张。
- HubSpot：选一个 HubSpot OAuth2 凭证或私有应用令牌凭证，点「加载管道」，再选对象：交易或工单（再选一个管道），或联系人生命周期阶段。记录每进入一个阶段就是一个步骤，步骤名用管道里的阶段名称；联系人不读姓名和邮箱。映射是固定的，不用选列。每次读取上次之后有变化的记录，最多 100 条。
- Salesforce：选一个 Salesforce OAuth2 凭证，点「加载组织」确认凭证连接的组织，再选对象：业务机会、个案或潜在客户。业务机会每进入一个阶段是一个步骤（只改金额或日期的记录不算）；个案是创建和每次状态变化；潜在客户是创建、每次状态变化和转化。个案和潜在客户的状态需要在 Salesforce 里开启字段历史跟踪。映射是固定的，不用选列。每次读取上次之后有变化的记录，最多 100 条；当天的 API 调用次数用完时会等到下一次再读。
- 飞书多维表格、飞书审批：选项目里的飞书凭证，再选多维表格或审批定义。审批的每个节点完成时间都会成为一个步骤。

## 映射：每一行是什么

「表的每一行」有两种：

- 每个事项一行，每个步骤一个时间列：例如样本表里有收样时间、开始检测时间、复核时间、出报告时间。选「事项编号列」，再为每个时间列起一个步骤名称。
- 每次状态变化一行：例如订单状态历史，每次状态变化记一行。选「状态列」和「变更时间列」，可以用「值对照」把原始状态改成更好懂的步骤名称；同一状态再出现一次算返工。

Duaer 还会识别这是哪类业务流程：采购到付款、订单到收款、报销审批、实验室检测、生产订单或客服工单，写在「流程类型」里并说明依据，也可以改成别的或不指定。识别出来后，步骤会按这类流程的常用名称和顺序整理；流程发现会用这类流程的常见时限判断是否等太久（例如收样到开始检测一般 5 天内），生成的监控和执行工作流程的卡片也会写明这是常见时限；数据说明里会列出这类流程的关键指标（处理周期、按时完成率、完成率、一次通过率）和数据里还缺的常见步骤。

一个流程常涉及几种对象，例如订单和订单行。每种对象用一个数据来源读取，在「对象层级（可选）」里填「对象类型」（例如 订单行）；下一级在「上级数据来源」选上一级的数据来源，在「上级事项编号列」选存上级编号的列。编号要由两列拼成时，用「编号再加上」，例如订单号加行号得到 SO-1001-10。表里有另一个数据来源的编号列时，Duaer 会建议这样设置，点「使用」即可。同一个编号只能属于一种对象：已被另一种对象用过的编号不会写入，读取结果里会提示有多少个。

设置好上下级后，上一级数据来源的卡片上会多一项「逐层查看」（只有所有者和管理员能看到）：点「查看」列出最近有进展的 50 个事项，每个显示当前步骤、下一级有几个、最久几天没有进展；点开一个事项能看到它的每个下一级事项停在哪一步、几天未动，也可以按事项编号查找。员工门户里打开一个事项的时间线，下方会列出它的下一级事项，点进去能看到这一项的时间线，再点「上级」回到原来的事项；只会列出这个人本来就能看到的事项。

映射这一步顶部有「数据说明」，点「查看」后用业务语言说明这张表：一行是什么、每列存的是什么、填充率和常见取值、哪些列有问题；还会列出这份数据能回答的问题（比如每一步之间等多久、哪一步最容易卡住、谁处理得慢）和还缺什么（比如没有执行人列、没有负责人邮箱）。改了映射里的列，这部分会跟着更新。已启用的数据来源卡片上也能打开数据说明。

Duaer 会先根据列名和内容建议映射：看得懂中文列名、拼音缩写（如 DDH、SHRQ）和 SAP、金蝶、用友的常见字段（如 FBILLNO、FAPPROVEDATE），把时间列命名成可读的步骤；记录「最后更新时间」的列（如 updated_at、更新时间）不会被当成步骤。每个选择下面写着把握高、中或低和一句理由，把握低的会标出来，请逐项检查。组织在「功能」里打开「AI 读取分类取值」后，AI 还能看到状态列、分类列的取值，用来看懂状态并填写值对照；编号、人员、邮箱、金额从不给 AI 看，纯数字的状态代码也不会猜含义，需要自己填写。另外三个可选的列：「执行人」是每一步是谁做的（没有建议时默认用负责人邮箱列），「负责人邮箱」是事项现在归谁（卡片发给他），两者可以是同一列；「用于根因分析的属性」最多选 20 列，例如实验室、产线、优先级，流程发现会用它说明问题多发生在哪类事项上。日期写成 03/04/2026 这类时，在「形如 03/04/2026 的日期」里选日在前或月在前。

## 预览：先看问题

预览显示读取了多少行、多少事项、多少事件，以及前几个事项的步骤。发现的问题会列出来并附例子，例如缺少事项编号的行、读不到时间的步骤、步骤顺序颠倒、未来的时间、大部分时间落在夜里（多半是时区不对）、值对照里没有的状态。每个问题下面有一句怎么处理的提示。标着「阻止」的问题要先解决才能继续。

## 运行频率、可见范围和确认

1. 「读取新数据的频率」选几分钟、几小时或每天一次。Duaer 每次只读上次之后的新行；行很多时会显示「还有数据待读取」，下一次接着读。文件来源不需要选频率。
2. 「可在门户中看到全部事项的人」：勾选「组织内所有人」，组织里每个成员都能看到，之后加入的人也一样；或者按姓名或邮箱搜索，从组织成员里选人。所有者和管理员始终可以看到。
3. 点「确认并开始」。数据来源变成「已启用」，第一次读取马上开始。

之后可以随时「立即读取」「暂停」或「恢复」；「编辑」和「删除」在「⋯」菜单里。改了映射后，Duaer 会按新映射重写这个数据来源的步骤；协同工作流程写回的决定会保留。
## Questions

### 数据库里的数据会被改动吗？

不会。Duaer 只用你选的凭证读你勾选的列，只读有变化的行，从不写回你的数据库。

### 一张表里同时有多个时间列和一个状态列，选哪种？

每个步骤都有自己的时间列时，选「每个事项一行，每个步骤一个时间列」；只有一列状态和一列变更时间、每次变化一行时，选「每次状态变化一行」。

### 负责人邮箱一定要填吗？

流程发现不需要。要生成工作流程发卡片，就要有负责人邮箱：没有负责人的事项不会收到卡片。负责人要是本组织的成员。

## 相关

- [在 Duaer 里从数据看出流程，并生成工作流程](https://doc.duaer.com/zh/build/process.md)
- [在 Duaer 里看流程发现和 SOP 符合度](https://doc.duaer.com/zh/build/process-findings.md)
- [Duaer 从流程生成的三种工作流程：监控、协同、执行](https://doc.duaer.com/zh/build/process-workflows.md)
- [在 Duaer 里用数据表留下结果](https://doc.duaer.com/zh/build/data-tables.md)