泛微E10 ESB动作流执行
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../weaver-e10-shared-connector/SKILL.md,其中包含安装、E10 认证、JSON 输出和高风险写入规则。该文件由连接器随包提供,读取失败时必须停止执行;不要自行安装 CLI 或 Skill。
本技能覆盖 ESB 中心的自定义触发类型动作流:取入参模板(只读)与执行动作流(写操作,需确认)。按动作流名称解析 ID、唯一值对应的 primary_key SQL 查询都不在本技能范围内,见「不在范围」。
命令入口
weaver-work-cli esb --help
weaver-work-cli --profile eteams esb schema
weaver-work-cli --profile eteams --json esb run <operation> --input-json '<json>'
schema 是可用能力的唯一事实来源。禁止把本技能或源接口文档中的接口路径当成可直接调用的地址,也禁止把未出现在 schema 中的能力当作可用 operation。
高优先级语义
- 「执行/触发/跑一下动作流」「按动作流 ID 触发」→
esb.trigger.prepare→ 用户确认 →esb.trigger.apply - 「这条动作流要传哪些参数」「给我入参格式」「触发前先看参数模板」→
esb.input-format - 「用唯一值触发」→
uniqueIndent(值为该动作流在esb_application.primary_key中查得的唯一值),由调用方查好后传入 - 触发标识二选一:
esbFlowId(普通触发)与uniqueIndent(唯一值触发)不能同时传、也不能都缺
Reference 路由表
命中任一条件时,执行下一步前读取对应 reference。
| 触发条件 | Reference |
|---|---|
| 取入参模板、确认主表/明细表字段、看哪些字段是可选 | references/input-format.md |
| 触发/执行动作流、写操作确认链、结果判读与失败处置 | references/trigger.md |
处理链(触发动作流必须按此顺序)
- 确认目标动作流:用户给的是动作流 ID。只给名称时向用户索取 ID(或
primary_key),不要猜测。 - 取模板(推荐):
esb.input-format取回customParams模板,按模板组装业务字段;模板中的#可选占位替换为真实值或删除。 - prepare:
esb.trigger.prepare做只读回查与请求体组装,返回requestPreview与continuation(有效期 10 分钟)。此步不触发动作流。 - 向用户确认:把目标动作流、触发人员、请求体摘要和副作用风险展示给用户,取得明确确认。
- apply:
esb.trigger.apply传continuation与confirm: true执行。confirm必须显式为true。 - 结果判读:
resultCode=200为成功,按followUp与actionData处理页面动作、提醒与返回数据。
写操作失败决策树
| 错误 subtype | 含义 | 处置 |
|---|---|---|
confirm_required |
未显式确认 | 先向用户确认,再传 confirm: true |
continuation_invalid / continuation_expired / continuation_mismatch |
continuation 无效或过期 | 重新执行 esb.trigger.prepare |
continuation_actor_changed |
登录身份与签发时不一致 | 重新 prepare,不要复用旧 continuation |
parameter_invalid |
参数错误(resultCode 100) | 对照 customParams 模板核对必填字段 |
flow_not_bound / flow_not_found |
触发标识未绑定或动作流不存在 | 核对 ID,不重试 |
flow_disabled / flow_in_recycle_bin |
动作流未启用或在回收站 | 先在 ESB 中心处理,不重试 |
permission_denied / tenant_permission_denied / tenant_missing |
权限或租户问题 | 确认登录态与租户权限,不重试 |
license_required |
需要对应 license | 联系管理员开通,不重试 |
throttled |
触发频繁被限流(507/508/511) | 稍后重试,禁止高频轮询 |
flow_running / execute_timeout |
正在执行或执行超时 | 稍后重试或查运行日志 |
write_uncertain |
请求已发出但结果未知 | 立即停止:不重试、不判定失败,先在 ESB 中心查看动作流运行日志 |
安全边界
- 🔴 写操作必须走确认链:
esb.trigger.apply需要confirm: true且 continuation 有效期 10 分钟,禁止跳过 prepare 直接触发。 - 🔴
write_uncertain不重试:触发请求发出后网络中断时结果不可判定,自动重试可能造成重复执行。 - 唯一值触发有歧义:同一租户下存在相同唯一值的多条动作流时,系统只执行
create_time最新的一条;需要精确控制时改用esbFlowId。 - 认证由 CLI 托管:禁止自行拼接 Cookie / ETEAMSID / User-Agent,禁止绕过
weaver-work-cli直接调用 E10 接口。
不在范围
- 按动作流名称解析 ID:源资料未提供 ESB 中心动作流查询接口的路径与字段契约,
esb.actionflow.resolve未实现,请向用户索取动作流 ID。 - 唯一值
primary_key的查询:该步骤需要直接执行SELECT primary_key FROM esb_application WHERE id = ?(esb_setting库),CLI 没有数据库通道,esb.unique-indent.resolve未实现;请由具备库权限的一方查好后通过uniqueIndent传入。 - 附件上传、OCR、文件解析类能力:本模块不涉及。
平台兼容
命令示例同时兼容 Windows 与 macOS/Linux。
Windows PowerShell:
weaver-work-cli --profile eteams --json esb run esb.input-format --input-json '{"applicationId":"900000000000000001"}'
macOS/Linux(bash/zsh):
weaver-work-cli --profile eteams --json esb run esb.input-format --input-json '{"applicationId":"900000000000000001"}'
复杂 JSON(例如带明细表的 customParams)先写入 UTF-8 文件再传 --input <file>。