datai-vue/doc/salesforce/integration/RealtimeServiceController/0014-start-all.md
Kris 1177dbde35 feat: 添加元数据变更中心和实时同步统计页面
- 新增元数据变更中心页面 (metadatachange/index.vue)
  - 集成统计卡片显示变更数据
  - 支持按变更类型、操作类型、同步状态分组统计
  - 支持趋势统计图表展示
  - 优化查询条件布局,移至页面顶部

- 新增实时同步统计页面 (statistics/realtime/index.vue)
  - 显示实时同步服务状态和控制按钮
  - 统计启用实时同步的对象数量
  - 自动刷新统计数据(30秒间隔)

- 优化数据同步页面 (datasync/index.vue)
  - 修正字段映射以匹配API响应
  - 更新统计卡片显示实际数据

- 优化同步日志统计页面 (statistics/synclog/index.vue)
  - 更新表格列以匹配API响应结构
  - 更新查询参数和映射函数

- 更新导航栏菜单 (Navbar/index.vue)
  - 添加元数据变更中心菜单项

- 新增API接口 (realtimeservice.js)
  - 添加getStatistics函数获取实时同步统计数据

- 新增接口文档
  - DataiIntegrationRealtimeSyncController 接口文档
  - DataiIntegrationRealtimeSyncLogController 接口文档
2026-01-13 13:50:07 +08:00

3.4 KiB
Raw Permalink Blame History

一键启动所有实时服务

接口概述

一键启动所有 Salesforce 实时服务,包括对象注册表初始化、事件订阅服务和实时同步服务,按顺序依次启动。

接口详情

  • 接口名称: 一键启动所有实时服务
  • 接口路径: /integration/realtime/service/start/all
  • 请求方法: POST
  • 权限标识: integration:realtime:start:all
  • 接口标签: 【实时服务管理】统一管理

请求参数

Headers

参数名 类型 必填 描述
Authorization String 认证令牌格式Bearer {token}
Content-Type String 请求内容类型固定值application/json

Query Parameters

Body Parameters

响应参数

响应结构

{
  "success": boolean,
  "message": String,
  "details": {
    "objectRegistry": String,
    "eventSubscriber": String,
    "realtimeSyncService": String
  }
}

字段说明

字段名 类型 描述
success Boolean 请求是否成功true-成功false-失败
message String 响应消息,描述操作结果
details Object 各服务启动详情
details.objectRegistry String 对象注册表初始化详情
details.eventSubscriber String 事件订阅服务启动详情
details.realtimeSyncService String 实时同步服务启动详情

响应示例

成功响应

{
  "success": true,
  "message": "所有实时服务启动成功",
  "details": {
    "objectRegistry": "初始化成功,注册对象数: 15",
    "eventSubscriber": "启动成功,订阅状态: true",
    "realtimeSyncService": "启动成功,运行状态: true"
  }
}

失败响应

{
  "success": false,
  "message": "启动所有实时服务失败: 认证失败",
  "details": {
    "objectRegistry": "初始化成功,注册对象数: 15",
    "eventSubscriber": "启动失败",
    "realtimeSyncService": "未启动"
  }
}

错误码说明

错误码 描述 解决方案
401 未授权token 无效或已过期 重新登录获取有效 token
403 无权限访问该接口 联系管理员分配相应权限
500 服务器内部错误 检查服务器日志,联系技术支持

注意事项

  1. 启动顺序为:对象注册表 → 事件订阅服务 → 实时同步服务
  2. 如果某个服务启动失败,后续服务将不会启动
  3. 启动前请确保以下配置正确:
    • Salesforce Consumer Key 和 Consumer Secret 已配置
    • Access Token 有效
    • Pub/Sub API 连接配置正确
    • 数据库连接正常
  4. 如果服务已在运行,再次调用此接口会重新初始化并启动所有服务
  5. 启动成功后,系统将开始接收和处理来自 Salesforce 的实时变更事件
  6. 建议在以下场景使用一键启动:
    • 系统首次启动
    • 系统维护后重新启动
    • 配置更新后需要重新加载
    • 所有服务停止后需要重新启动
  7. 一键启动操作是幂等的,可以安全地重复执行
  8. 启动过程中会返回每个服务的详细状态,便于排查问题

相关接口