跳到主要内容

使用 OpenLink

OpenLink 用于管理 Soln 在集成中需要连接的外部业务系统。管理员可以创建 OpenLink 记录、控制 OpenLink 是否启用、配置安全策略,并进入外部表单、集成流配置和组织映射等相关页面。

OpenLink 配置属于租户侧数据。每个客户工作区维护自己的 OpenLink 记录、安全配置、外部对象、集成流定义和映射关系。

从 集成 菜单打开 OpenLink

左侧面板展示当前工作区的 OpenLink。你可以按关键字搜索,并选择一个 OpenLink 查看详情。

区域说明
搜索 OpenLink 系统按关键字筛选 OpenLink 列表
新建 OpenLink打开新建窗口
OpenLink 列表展示名称、系统编码、头像和启用状态,每项带编辑图标
编辑 OpenLink点击编辑图标或双击列表项,打开选中 OpenLink 的编辑窗口

点击列表中的 OpenLink 后,右侧会显示详情。

选择 OpenLink 后,详情面板会显示名称、系统编码、说明、头像、创建时间和更新时间。

右上角操作提供 OpenLink 配置入口:

操作说明
外部表单管理当前 OpenLink 下的外部表单
集成流配置管理当前 OpenLink 下的集成流
组织映射管理外部主体与 Soln 主体之间的映射关系
更多启用系统、停用系统或删除系统

进入关联页面前需要先选择 OpenLink。Soln 会保留当前选中的上下文,让子页面加载对应的外部表单、字段、集成流和映射。

安全配置​

详情面板包含当前 OpenLink 的安全配置页签。

页签用途
出站鉴权配置 Soln 调用外部系统时使用的凭证
入站鉴权配置外部系统请求 Soln 时的鉴权方式
白名单通过 IP、CIDR、域名或 URL 前缀限制可信入站来源

启用调用外部系统或接收外部请求的集成流之前,应先完成对应安全配置。

  1. 点击 新建 OpenLink
  2. 按需上传 头像
  3. 输入 系统名称
  4. 按需填写 描述
  5. 点击 创建
字段必填说明
头像否显示在列表和详情面板中的图片
系统名称是在 OpenLink 列表和详情面板中显示的名称
描述否说明这个对接系统的用途和归属,创建后显示在详情面板的说明区域

Soln 会按系统名称自动生成系统编码,创建后不能修改。系统名称应保持清晰,因为相关外部表单、字段、集成流和映射都会归属到选中的 OpenLink 下。

  1. 在列表中选择一个 OpenLink
  2. 点击列表项上的编辑图标
  3. 修改头像、系统名称或描述
  4. 点击 保存

编辑 OpenLink 只修改展示信息,不会影响已有的外部表单、字段、集成流和映射。安全配置需要从详情面板的页签中维护。

在选中 OpenLink 后,通过 更多 菜单选择 启用系统 或 停用系统。

状态影响
启用当前 OpenLink 可被相关配置使用
停用当前 OpenLink 仍可管理,但不应作为启用中的集成目标使用

启用前,建议检查安全配置,以及关联表单、字段、集成流和映射。

  1. 选择一个已停用的 OpenLink
  2. 打开 更多
  3. 点击 删除系统
  4. 确认删除

启用中的 OpenLink 需要先停用后才能删除。只有当这个 OpenLink 及其相关配置都不再需要时,才删除。

进入关联页面​

OpenLink 是相关集成页面的起点

页面用途
外部表单定义当前 OpenLink 下的外部业务对象
外部字段为外部表单定义字段和标识字段
集成流配置创建、配置、发布和查看 OpenLink 集成流
组织映射将外部用户、部门或组织匹配到 Soln 主体

先选择 OpenLink,再点击详情面板中的对应操作进入页面。

推荐配置流程​

新建 OpenLink 时,建议按这个顺序处理:

  1. 创建 OpenLink
  2. 如果 Soln 需要调用外部 API,配置出站鉴权
  3. 如果外部系统会请求 Soln,配置入站鉴权和白名单规则
  4. 在 OpenLink 下创建外部表单
  5. 配置外部字段和标识字段
  6. 配置集成流
  7. 当外部主体需要匹配 Soln 用户、部门或组织时,配置组织映射
  8. 必要配置检查完成后启用 OpenLink