应用设置 · 集成与开放
这是某个业务应用设置里的「集成与开放」,不是应用中心菜单里的 集成中心(入口登记页 /app-center/integration)。
编排实现在 forge-admin-server 的 ApplicationIntegrationController,前缀:
/ai/business/application/{appId}/integrations只保存企业连接的 引用(connectionId + revision),不会把平台凭据复制进应用。
功能入口
- 打开 应用中心,进入目标应用的 设置(运行时路由形如
/app-center/application/{applicationCode}/runtime?view=settings,也可经/settings重定向)。 - 左侧点 集成与开放(
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 |
| 对象 | 单个业务应用 | 集成入口登记列表 |
| 典型操作 | 绑企业连接、注册能力、授权 | 新增集成入口、打开业务访问入口 |
