问

【反馈】多维表格自动化流程接口 28 项实测问题

【反馈】多维表格自动化接口多项实测问题 我们用多维表格搭建进销存系统(24条流程、34个通知节点、20个表单、22个自定义编号字段),以下均基于开放接口实测、可复现,分三档:求助、缺陷、文档缺失。 一、求助,请官方指路 A1、消息卡片如何跳转到对应记录(最想解决) 官方说可引用前置步骤输出的记录链接,点击卡片直接定位到对应记录。但消息操作 notify_v4 的 link 参数 value_sources 虽含 db_record,变量语法无任何文档;固定文档短链只能进文档、定位不到记录;button_type 枚举未公开(当前值为 no)。 想问:1、link 引用记录链接的写法是什么?2、button_type 有哪些取值? 线索:官方教程《多维表格做审批流程》提到记录链接默认取自第一步记录的链接,说明平台内部确有此取值,只是接口层没暴露。 A2、接收人如何用触发人或记录字段而非写死用户ID 官方文档提到发送给个人时可选择项目负责人对应字段,但接口层 receiver 的变量写法没给。 A3、新增记录时的非空守卫接口层是否强制 接口传空 field_ids 保存启用均不报错,表格底部点加号新增空行就会被误触发。有接口层校验可开吗? 二、平台缺陷 B1、分支流程子节点无法接口改写(影响最大) 只改分支内一个节点即报 400001,须整树原样回传,带 opaque_steps、step_count 均无效。我们32个通知节点嵌在分支下,改一个链接就得整条重建。建议开放节点级更新或允许整树替换。 B2、create 不重映射 flow 开头的内部节点引用,流程无法重建 报错:参数引用了不存在的节点。复制文档时平台会重映射82处此类引用,接口 create 却不重映射,含内部引用的流程(3条核心流程)永久无法接口维护。 B3、validate-flow 与 dry_run 校验不一致(假绿) validate 返回有效且无警告,紧接着 dry_run 就报 400001 Contains 不支持。 B4、Link字段不支持 Contains,但界面能配出并长期存住 历史保存运行正常,某次重新保存才报 400001。官方更新说明(26年8月)确认界面侧关联字段筛选支持包含,前后端规则不一致。建议界面拦截或报错提示改用 Intersected。 B5、表达式缺终止符 U+2005,保存回读正常,重新开启才报错 平台提示:保存回读都正常,但开启时会报错。建议校验前置到保存。 B6、form-update-field 接口无实际效果 传 required true 或带 field_id 都返回成功但服务端零变化,返回的字段ID为乱码。20个表单必填只能界面手工点。 B7、set-share-permission 不能改角色档位 报 400100 请求参数不支持,只能改 scope,降档位只能网页端操作。 B8、share-open-view 的 view_type 传错报误导性错误码 必须传 G0、F0、D0,传 form 恒报 500000 服务暂时不可用,曾误判为平台故障。建议错误信息点明参数要求。 B9、复制多维表格产生僵尸分享且流程全停(数据安全级) 复制后20个分享ID原样保留,查状态显示已启用,查链接信息却全部报不存在;同时全部流程被静默停用。副本按钮按旧分享ID会写到正本表单(静默数据串写)。建议复制后重建分享或警告,并提示流程已停用。 B10、自定义编号位数有两层配置,生效内层、界面显示外层 顶层格式被忽略,配置段内格式生效;界面编辑编号会静默改变实际位数,22个字段全部两层不一致。建议文档说明优先级。 B11、create-records 的 Link 值格式错误被静默忽略 传对象格式返回成功但字段为空;正确写法是记录ID字符串数组(官方文档已确认)。建议非法格式报错。 B12、set-trigger-status 的 check_only 返回当前状态而非目标状态 停用流程时预检仍返回已启用,易误判为关闭失败。 B13、界面与接口两套校验规则 含分支的流程界面拒绝关闭但接口直接成功;界面点仅保存会静默把流程置为停用。 B14、on_not_found 为 exit 时静默终止,失败通知收不到 exit 算正常退出,勾了运行失败通知也收不到。我们41处exit,漏填字段后静默不生成应收应付、无告警。建议补静默退出也通知的开关。 B15、AirScript 并发限制过紧 单文件同时只跑1个脚本,等待超20秒即失败,批量录明细必然失败。官方社区已有帖子复现。建议提供官方排队或重试机制。 三、文档缺失 C1、notify_v4 的 button_type 枚举值 C2、notify_v4 的 link 引用记录链接的变量语法(见A1) C3、notify_v4 的 receiver 用记录字段的写法(见A2) C4、流程名最长30字符,报错时才知 C5、Link字段支持的运算符白名单(只知 Empty、Intersected、NotEmpty) C6、表达式终止符 U+2005 的规则 C7、permission-list-roles 实际返回键是 permissions 不是 roles C8、permission-list-subjects 返回结构不稳定 C9、share-view-status 的 is_enable 在顶层 C10、get-flow 的 opaque_steps 是键名数组不是节点内容 优先级建议:优先处理 A1、B1、B2(决定能否维护自动化,已被迫重建15条流程);其次 B3、B5、B9、B10(静默失败);再次 B6、B11、B12、B13(返回成功但没生效);最后 B14、B15 及其余。 以上均实测可复现,如需复现步骤、报文或录屏,回复告知即提供。感谢官方团队!
河北省
浏览 55
收藏
2
分享
2 +1
+1
全部评论