Agent Skills
返回列表
泛微E10ESB动作流触发接口

泛微E10ESB动作流触发接口

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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(唯一值触发)。

典型顺序:

  1. 可选步骤 0:先取入参模板,避免凭记忆拼字段。
  2. 确定触发标识与 employeeId。唯一值触发需先查 esb_setting 库拿到 primary_key,这条 SELECT 是 Agent 内部前置步骤,不是 HTTP 接口,需要数据库访问权限。
  3. 按目标动作流的主表结构组装 customParams.mainTable,二开场景在 moduleSource 填 ecode,标准使用可不传。
  4. 调用触发接口,解析 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实施顾问,需要验证动作流入参格式与唯一值触发语义,排查调用失败原因。