管理指南

连接器管理

链盒内置大量连接器(覆盖钉钉、飞书、金蝶、用友等企业系统)。管理员可在平台或项目 层面控制哪些连接器对用户可用,避免误用或满足合规要求。

连接器可用性控制

企业版支持两级过滤:

  • 平台级(Pieces Filter):平台管理员设置全平台允许/禁止的连接器, 适用于所有项目。
  • 项目级(PiecesFilterType):每个项目可独立配置:
    • NONE:不限制,所有连接器可用
    • ALLOWED:仅允许列表中的连接器(白名单)

项目级过滤在平台级基础上进一步收紧,最终可用 = 平台允许 ∩ 项目允许。

典型场景

  • 合规:禁用未审批的第三方连接器,仅开放经安全评估的
  • 隔离:财务项目只允许财务相关连接器(金蝶、用友),不允许社交类
  • 试用控制:新员工项目先开放少量连接器,熟悉后再扩展
  • 成本:禁用昂贵的外部 API 连接器,避免误用产生费用

连接器同步

连接器以 npm 包形式管理(@linkoo/* 命名空间)。AP_PIECES_SYNC_MODE 控制连接器的同步行为——决定了平台如何发现和加载 可用的连接器。社区版用内置连接器;企业版的 managePiecesEnabled 标志 开启后可动态管理连接器。

自定义连接器

对于内部系统或私有 API,可开发自定义连接器(TypeScript 编写,npm 包形式)。 自定义连接器可仅在本平台使用,不上架公开市场。这让链盒能对接任何系统, 不局限于内置清单。

内置连接器概览(中国相关)

连接器能力
钉钉审批、OA 表单、通讯录、考勤、工作通知、群机器人
飞书消息、通讯录、审批、日历、文档、多维表格
企业微信消息推送、通讯录、审批
金蝶云星空单据查看/保存/查询/提交/审核/删除
用友 U8基础档案、凭证操作、SQL 查询
宜搭表单数据增删改查、表单定义管理
简道云表单数据增删改查、批量操作
SAP RFCRFC 调用、读表、BAPI、函数信息

完整连接器清单(45+)可在产品的连接器选择界面浏览。