Skip to content

应用设置 · 集成与开放 ​

这是某个业务应用设置里的「集成与开放」,不是应用中心菜单里的 集成中心(入口登记页 /app-center/integration)。

编排实现在 forge-admin-server 的 ApplicationIntegrationController,前缀:

text
/ai/business/application/{appId}/integrations

只保存企业连接的 引用(connectionId + revision),不会把平台凭据复制进应用。

功能入口 ​

  1. 打开 应用中心,进入目标应用的 设置(运行时路由形如 /app-center/application/{applicationCode}/runtime?view=settings,也可经 /settings 重定向)。
  2. 左侧点 集成与开放(settingsSection=integrations)。

应用集成与开放

2026-10-11 演示站实拍(应用「人事」,已发布 v41)。页头:「企业连接、对外能力与接入授权,在当前应用内集中管理。」页签:企业协同 / 对外能力 / 接入授权 / 调用记录。企业协同页可见:连接配置「已保存」、企业连接下拉(演示绑定「企业微信」)、重新应用配置、平台连接管理;工作台免登「配置齐全」可复制主页地址;业务消息通知「发送连接已配置」及发给谁 / 何时发送 / 发送什么说明。页底注明:本应用集成暂不包含钉钉、飞书及原生待办同步;配置齐全不代表外部平台连通性已验证。

四个页签:

页签作用
企业协同绑定平台已有企业连接;工作台免登与消息通道就绪状态
对外能力本应用已归属的能力列表;注册 / 同步 / 调用指南
接入授权把能力授给接入系统(开放平台客户端)
调用记录按能力查看调用审计

企业协同 ​

权限:需 system:collaboration:connection:list(仅有应用编辑权限不够)。

区块界面要点
企业连接下拉「选择平台中已有的连接」;保存绑定 / 重新应用配置;链到「平台连接管理」
工作台免登就绪标签「配置齐全 / 待配置」;齐全时可复制「企业微信工作台应用主页」地址(应用须已发布才适合分发)
业务消息通知「发送连接已配置 / 待配置」;说明发给谁、何时发、发什么;可跳转业务流程;技术详情里是系统生成的通道编码

接口:

方法路径说明
GET.../collaboration当前绑定
GET.../connections可选连接列表
PUT.../collaboration保存 { connectionId, revision }

保存后立即生效,不必为此再发一版应用。取消绑定会停用本应用消息通道。

对外能力 ​

权限:ai:capability:query 等。工具栏:搜索本应用能力、刷新、注册能力(应用未发布或无可注册类型时禁用)。

能力卡片展示:名称、发布状态、编码、说明、来源类型、版本;操作含 接入授权、调用指南、更多(调用记录 / 发布新版本)。

空状态提示:可从已发布页面注册表单填报,或开放送审、审批、撤回等流程操作。

发布类接口(应用内):

方法路径说明
GET.../capabilities分页列表
POST.../capabilities/sync同步归属
POST.../publish/flow发布流程能力
POST.../publish/action发布业务动作能力
POST.../publish/system发布表单或纳管 REST 能力

系统服务侧限制(源码校验):应用内仅支持应用表单或显式纳管 REST;审批请选应用业务流程。

接入授权 / 调用记录 ​

方法路径说明
GET.../clients可授权客户端选项
GET/POST.../grants查询 / 授权
POST.../grants/{grantId}/revoke撤销
GET.../invocations调用记录(需 capabilityId)

与一级菜单 开放平台 的能力目录 / 接入系统是同一套能力模型;这里按当前应用收敛操作入口。

和「集成中心」的区别 ​

应用设置 · 集成与开放应用中心 · 集成中心
路由应用 runtime view=settings + integrations/app-center/integration
对象单个业务应用集成入口登记列表
典型操作绑企业连接、注册能力、授权新增集成入口、打开业务访问入口

相关文档 ​