泛微E10ESB动作流触发接口
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md ,把 @org-vsc9dz4y/weaver-e10-customesb-execute 安装到当前 AI 助手中。
技能介绍
要解决的问题
在泛微 E10 里通过 ESB 中心驱动一条「自定义触发类型动作流」,调用方要同时处理四件事:组装符合 customParams 结构的主表/明细表参数、拿对触发标识、拼上完整域名与认证、再按 resultCode 和 actionData 决定后续页面动作。任何一环靠猜,结果都是一次静默失败的业务写入。
这个 Skill 只解决其中业务参数与触发语义这一层:它明确两种触发参数化方式的互斥关系、参数模板的取法,以及返回体如何解读。完整接口地址拼接与认证一律交给 weaver-e10-login,凭证统一由 E10 命名凭据插件提供,代码里因此不会出现硬编码的 ETEAMSID、token 或签名。
核心能力与关键步骤
收录两个接口,配套使用:
POST /api/bs/esb/setting/customData/application/copyCustomData:只读查询,按applicationId取回customParams模板(含mainTable、detail1/detail2等主表/明细表结构)与esbFlowId,无副作用,无需用户确认。POST /api/esb/server/event/triggerActionFlow:写操作,请求体二选一携带esbFlowId(普通触发)或uniqueIndent(唯一值触发)。
典型顺序:
- 可选步骤 0:先取入参模板,避免凭记忆拼字段。
- 确定触发标识与
employeeId。唯一值触发需先查esb_setting库拿到primary_key,这条SELECT是 Agent 内部前置步骤,不是 HTTP 接口,需要数据库访问权限。 - 按目标动作流的主表结构组装
customParams.mainTable,二开场景在moduleSource填ecode,标准使用可不传。 - 调用触发接口,解析
resultCode:200为成功;按actionData(pageAction/reminder/hasData/responseData)决定后续页面动作、提醒与数据返回。
适用边界与注意点
- 触发是写操作且有业务副作用,调用前必须拿到用户明确确认。
- 同一端点下
esbFlowId与uniqueIndent二选一必填,不能同时传。 - 唯一值触发存在歧义:同一租户下多个动作流可能复用同一唯一值,系统只执行
create_time最新的那条,需要精确控制时优先用esbFlowId。 - 用户只说「触发动作流」而未指明目标时,先询问收窄,不要臆测,也不要自动切换到其他同类型接口兜底。
- 收到
507/508/511这类频率/幂等限流码时提示用户稍后重试,避免高频重试。 - 本模块不实现认证、也不拼接完整地址,缺少
weaver-e10-login或凭据插件时无法工作。
使用场景
- 工程师按动作流ID执行ESB动作流,并解析resultCode与actionData处理后续提醒。
- 用户只给动作流名称时,先查ESB中心解析出esbFlowId,再组装customParams.mainTable调用触发接口。
- 不清楚入参格式时,调用copyCustomData获取customParams模板与esbFlowId,避免字段拼错。
- 需要精确控制流程时优先用esbFlowId触发;若用唯一值触发,需先查esb_setting库获取primary_key。
适合人员
- 泛微E10二开工程师,需要把业务动作流接入Agent对话,替代手写触发脚本。
- 企业IT集成人员,负责打通OA与外部系统的ESB动作流,要求参数模板可查可组装。
- 低代码平台工程师,希望按用户意图动态执行动作流并处理返回的页面动作与提醒。
- E10实施顾问,需要验证动作流入参格式与唯一值触发语义,排查调用失败原因。