切换主题
连接器
连接器页面统一管理外部系统连接、同步参数、字段映射、Webhook 和客户侧 Connector Agent。只有组织管理员可以访问和修改。
非管理员访问时会看到权限不足提示：
支持的连接器
| 连接器 | 用途 |
|---|---|
| PTC Windchill | PLM 变更和流程数据 |
| Siemens Teamcenter | Teamcenter REST 数据源 |
| REST API | 通用 REST 接口 |
| SAP ERP | SAP OData 数据 |
| 金蝶 ERP | K3 Cloud / KIS 数据 |
| Microsoft Dynamics 365 Business Central | Business Central API v2.0 |
实际可选类型还取决于后端返回的连接器定义。
添加连接器
- 点击“添加连接器”。
- 选择类型，填写名称、基础地址和认证凭据。
- 需要 Webhook 时先绑定默认项目。
- 配置数据获取端点、分页、同步模式和字段映射。
- 点击“测试连接”。
- 保存并启用。
“测试连接”只验证当前弹窗中的草稿配置，不会提前创建连接器。
同步和数据集
连接器支持：
- 全量同步：每次同步全部历史数据；
- 增量同步：只同步上次同步后的新增数据；
- 手动选择项目并启动同步；
- 设置同步间隔和单次最大事件数；
- 从连接器卡片跳转到项目“数据接入”查看结果。
运行摘要会展示去重、接入、隔离和待确认映射等状态。低置信度映射只有审核通过后才进入正式流程归并。
Webhook
启用 Webhook 前必须绑定默认项目。保存后平台生成：
- Webhook URL；
- API Key；
- Bearer Token。
凭据仅在需要时复制给发送方。Webhook 日志记录接收和后台处理状态。
IMPORTANT
日志显示“已接收”只表示请求通过认证并已记录，数据此时可能尚不可分析；请等待后台处理完成后再到项目数据接入页确认。
API Keys
连接器卡片可打开 API Key 管理，执行创建、轮换和撤销。
新密钥创建后应立即保存。轮换完成后及时更新调用方；撤销操作不可恢复。
Connector Agent
“客户侧运维”用于在客户内网或边缘主机运行连接器：
- 下载 Linux x64、Linux ARM64、Windows x64 或 macOS Apple Silicon 离线包；
- 创建 Agent 并至少绑定一个已激活连接器；
- 查看最近心跳、声明连接器和运行数量；
- 发布配置或回滚上一版；
- 启用、停用和轮换 agent_token；
- 生成首次注册使用的 bootstrap token。
bootstrap token 只用于 register 模式首次接入；注册成功后 Runtime 获取正式 agent_token，二者不能混用。
完整部署步骤见 Connector Agent 部署。
Agent 状态
| 状态 | 建议 |
|---|---|
| 运行中 | 无需操作，持续观察心跳 |
| 降级 | 检查配置、网络和连接器执行结果 |
| 离线 | 检查客户侧进程和到 PM7 的网络 |
| 已停用 | 需要恢复时在“更多操作”中启用 |
停用后，Agent 不能注册、拉取配置或上报心跳，配置发布和凭据操作也会被阻断。
删除前检查
删除连接器前确认：
- 不再有计划同步；
- Webhook 发送方已停止；
- 相关 Agent 已调整绑定范围；
- 数据集和映射是否仍需保留；
- API Key 已从调用方撤除。