Duaer

流程、账号与托管

让 Duaer 卡片上的决定回到原来的系统

员工在 Duaer 卡片上同意或驳回,结果回到飞书审批、钉钉审批、泛微 e-cology、金蝶云星空或你们自己的系统;事项在原来的系统里处理了,卡片自己关掉。

在 Duaer 里做决定,结果回到原来的系统

事项来自飞书审批、OA、ERP 这些系统时,员工在 Duaer 卡片上选了「同意」或「驳回」,这个决定可以回到原来的系统,不用再去那边点一次。

Duaer 不会直接改对方系统的数据库:只通过对方系统的接口,或者你们自己接收的 Webhook。回写默认是关的,所有者或管理员按卡片规则一条一条打开。

事项在原来的系统里处理了,卡片会自己关掉

这一项不用设置。卡片规则每次运行时,事项的状态不再是待处理、不再超期,或者换了负责人,这张卡片就会关掉,员工端「已决定」里写着「已在源系统处理」;换了负责人时,新负责人会收到一张新卡片。

事项从 Duaer cases 表里删掉时,卡片不动,这样重新写入事项表时不会把大家的卡片一下子全关掉。

打开回写设置

  1. 所有者或管理员打开 Duaer 设置 ›「回写」(在「连接」下面)。
  2. 在「回写目标」里点「添加 Webhook」「添加飞书审批」「添加钉钉审批」「添加泛微 e-cology」或「添加金蝶云星空」,填好后点「保存」。
  3. 在「卡片规则」里,给一条规则选「回写到」哪个目标,再选哪些选项要回写,点「保存」。「保存」在改动之后才出现。
  4. 目标需要成员在那个系统里的账号时,在「成员账号」里填好。

飞书审批

来自飞书审批数据源的卡片,事项编号就是飞书审批的实例编号。员工选定后,Duaer 用组织连接的飞书应用,找到这个人在这条审批里的待办,以他本人的身份同意或拒绝,并带上卡片上写的意见;飞书里记下的审批人是他本人。

  • 先在知识来源里连接飞书;没有连接时,添加飞书审批会提示「飞书还没有连接」。
  • 飞书应用要开通审批的读写权限,在飞书开放平台的应用权限里申请。
  • 在卡片规则里给每个选项选「同意」「拒绝」或「不回写」;「不回写」的选项只在 Duaer 里生效。
  • 成员的飞书账号:在飞书里绑定过的成员直接用;没有绑定的,第一次选定时 Duaer 按这个人在 Duaer 的邮箱去飞书查,查到就记下来。还对不上的,在「成员账号」里选「邮箱」或「手机号」,填这个人在飞书里的邮箱或手机号,Duaer 查出账号存好;也可以选「账号 ID」直接填 open_id。没有飞书账号的人选定时会被拦下,提示请管理员添加。
  • 审批在飞书里已经结束、这个人在这条审批里没有待办,或者飞书返回错误时,卡片回到待处理,写着原因。

钉钉审批

卡片的事项编号要是钉钉审批的实例 ID。员工选定后,Duaer 用组织连接的钉钉应用,找到这个人在这条审批里正在处理的任务,以本人的身份同意或拒绝,并把卡片上写的意见作为审批意见;也可以只把意见作为评论加到这条审批上。

  • 先在知识来源里连接钉钉;没有连接时,添加钉钉审批会提示「钉钉还没有连接」。
  • 钉钉应用要开通审批的读写权限,在钉钉开放平台的应用权限里申请。
  • 在卡片规则里给每个选项选「同意」「拒绝」「评论」或「不回写」。「评论」只加评论,不改变审批结果;卡片上没写意见时不会发出。
  • 成员的钉钉账号:读过钉钉通讯录、按邮箱对上的成员直接用;对不上的,在「成员账号」里选「手机号」填这个人在钉钉的手机号,Duaer 查出 userId 存好,也可以选「账号 ID」直接填 userId;填了的优先。钉钉不能按邮箱查人。没有钉钉账号的人选定时会被拦下,Duaer 不会去调用钉钉。
  • 审批在钉钉里已经结束、这个人在这条审批里没有正在处理的任务,或者钉钉拒绝时,卡片回到待处理,写着原因。

泛微 e-cology

来自泛微 e-cology 数据源的卡片,事项编号就是流程的请求 ID。员工选定后,Duaer 通过 e-cology 9 的接口,以本人身份提交或退回这条流程,并把卡片上写的意见作为签字意见。

  • 先请泛微为 Duaer 发一个 appid(在 ECOLOGY_BIZ_EC 里加一行),并在 weaver_session_filter.properties 的 unchecksessionurl 里放开 /api/ec/dev/auth/regist 和 /api/ec/dev/auth/applytoken。
  • 点「添加泛微 e-cology」,填 e-cology 地址和 appid 后保存;Duaer 这时去 e-cology 注册,失败会说明原因。
  • 在卡片规则里给每个选项选「同意」(提交)「拒绝」(退回)或「不回写」。
  • 在「成员账号」里填各人在 e-cology 里的人员 ID。没有账号的人选定时会被拦下,Duaer 不会去调用 e-cology。
  • e-cology 不接受时(比如没有权限、流程已经不在这个人手里),卡片回到待处理,写着 e-cology 返回的原因。一次没有回应、重试时又被拒绝的,卡片会提示第一次可能已经成功,请在 e-cology 里看一下。

金蝶云星空

卡片的事项编号是所选表单里的单据编号;来自金蝶云星空数据源的卡片,就是采购订单或销售订单的编号。员工选定后,Duaer 通过凭证里的第三方应用,以这个人的金蝶用户名登录,提交、审核或反审核这张单据,金蝶里记下的操作人是本人。

  • 先在凭证里添加金蝶云星空凭证,它的第三方应用要允许以其他用户登录。
  • 点「添加金蝶云星空」,选凭证,填表单 ID(默认 PUR_PurchaseOrder,销售订单是 SAL_SaleOrder)。
  • 在卡片规则里给每个选项选「提交」「审核」「反审核」或「不回写」。这几个操作不带意见,卡片上写的意见只留在 Duaer。
  • 在「成员账号」里填各人的金蝶用户名。没有账号的人选定时会被拦下,Duaer 不会去调用金蝶。
  • Duaer 先看单据状态:已经是要的状态就算同步了,不会再做一遍;状态不允许(比如还没提交就审核)、金蝶拒绝或登录失败时,卡片回到待处理,写着原因。

Webhook

要接其他系统,或者交给你们自己的中间件处理,用 Webhook:Duaer 把每个决定用 POST 发到你填的「地址」。

  • 内容是 JSON:event(card.decided;测试时是 ping)、key、attempt、decidedAt、card(projectId、id、ruleId、caseId 事项编号、title、link)、decision(choice、label、comment、values)、person(email、account)。
  • 签名:请求头 X-Duaer-Signature 的值是 sha256= 加上用「签名密钥」对原始请求体做 HMAC SHA-256 得到的十六进制串,收到后先验签。签名密钥至少 16 个字符,保存后不再显示,编辑时留空就保持不变。
  • 同一张卡片每次重试的 key 都一样(请求头 X-Duaer-Delivery 也是它),收到重复的可以直接忽略。
  • 返回 2xx 算已同步;返回 4xx 算不接受,卡片退回并写明原因,原因取返回 JSON 里的 message 或 error;返回 5xx、408、429,或 10 秒内没有响应,会重试。
  • 「账号所在系统」可以不填;填了(例如 weaverApproval),每次会带上这个人在该系统里的账号,没有账号的人选定时会被拦下。
  • 点「测试」会发一次 event 为 ping 的请求,页面上显示「测试通过」或没有通过的原因。

先回写,再改 Duaer

回写的卡片,员工选定后先显示「正在同步到」目标名。对方系统接受了,Duaer 才改自己的事项状态、做后续的事;不接受时卡片回到待处理,事项状态不变。

没有响应时,1 分钟后、5 分钟后各再发一次,一共 3 次,都失败就退回卡片。

常见问题

工作流程推的卡片能回写吗?

回写按卡片规则设置。工作流程推的卡片,员工选定后工作流程会收到选项和意见,在后面接一个节点调用对方系统就行。

回写没有成功的卡片怎么办?

卡片回到员工的待处理里,写着原因。把原因处理好(例如给飞书应用开通审批权限、给成员填上账号)后,员工重新选一次。

Duaer 会直接改我们 ERP 的数据库吗?

不会。Duaer 读取有些系统时直接读数据库,回写只通过对方系统的接口或你们的 Webhook,不写对方的数据库。

同组

员工端

让员工在 Duaer 员工端处理自己的事

Duaer 员工端是每个组织独立的登录地址。员工每天在这里看工作流程推给自己的任务和要拍板的事、自己关注的指标,也可以问 Duaer,不用进流程设计后台。

数据

在 Duaer 里用任务表给员工派活

在 Duaer 里,每个项目都自带一张名为 Duaer tasks 的数据表。工作流程往里插一行,就是派一个任务、推一张要拍板的卡片或写一条笔记。员工在 Duaer 员工端点完成或选一个选项后,结果写回这一行,等待中的工作流程接着往下跑。

流程

在 Duaer 里看流程发现和 SOP 符合度

流程发现列出事项在哪一步等得太久、哪一步反复返工,并指出多发生在哪类事项上;可以一键提议成卡片规则,采用后对比前后 30 天的效果。SOP 符合度把知识库里的 SOP 和事项实际走过的步骤对照。

流程

在 Duaer 里添加流程数据来源

流程数据来源告诉 Duaer 去哪里读事项的步骤:CSV 或 XLSX 文件、S3 或 SharePoint 文件夹里陆续放进来的文件、PostgreSQL、MySQL、Microsoft SQL、Oracle、TiDB、OceanBase、人大金仓 KingbaseES、SAP HANA、IBM Db2、达梦数据库 DM8、Teradata、Vertica、Snowflake、BigQuery、Databricks、Microsoft Fabric、Amazon Redshift、Azure Synapse Analytics、ClickHouse、Trino、飞书多维表格,或飞书、钉钉、企业微信的审批。按向导选列、对照步骤、预览问题、设好频率,确认后 Duaer 按时读取新数据。