使用 OpenLink
OpenLink 用于管理 Soln 在集成中需要连接的外部业务系统。管理员可以创建 OpenLink 记录、控制 OpenLink 是否启用、配置安全策略,并进入外部表单、集成流配置和组织映射等相关页面。
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 前缀限制可信入站来源 |
启用调用外部系统或接收外部请求的集成流之前,应先完成对应安全配置。
新建 OpenLink
- 点击 新建 OpenLink
- 按需上传 头像
- 输入 系统名称
- 按需填写 描述
- 点击 创建
| 字段 | 必填 | 说明 |
|---|---|---|
| 头像 | 否 | 显示在列表和详情面板中的图片 |
| 系统名称 | 是 | 在 OpenLink 列表和详情面板中显示的名称 |
| 描述 | 否 | 说明这个对接系统的用途和归属,创建后显示在详情面板的说明区域 |
Soln 会按系统名称自动生成系统编码,创建后不能修改。系统名称应保持清晰,因为相关外部表单、字段、集成流和映射都会归属到选中的 OpenLink 下。
编辑 OpenLink
- 在列表中选择一个 OpenLink
- 点击列表项上的编辑图标
- 修改头像、系统名称或描述
- 点击 保存
编辑 OpenLink 只修改展示信息,不会影响已有的外部表单、字段、集成流和映射。安全配置需要从详情面板的页签中维护。
启用或停用 OpenLink
在选中 OpenLink 后,通过 更多 菜单选择 启用系统 或 停用系统。
| 状态 | 影响 |
|---|---|
| 启用 | 当前 OpenLink 可被相关配置使用 |
| 停用 | 当前 OpenLink 仍可管理,但不应作为启用中的集成目标使用 |
启用前,建议检查安全配置,以及关联表单、字段、集成流和映射。
删除 OpenLink
- 选择一个已停用的 OpenLink
- 打开 更多
- 点击 删除系统
- 确认删除
启用中的 OpenLink 需要先停用后才能删除。只有当这个 OpenLink 及其相关配置都不再需要时,才删除。
进入关联页面
OpenLink 是相关集成页面的起点
| 页面 | 用途 |
|---|---|
| 外部表单 | 定义当前 OpenLink 下的外部业务对象 |
| 外部字段 | 为外部表单定义字段和标识字段 |
| 集成流配置 | 创建、配置、发布和查看 OpenLink 集成流 |
| 组织映射 | 将外部用户、部门或组织匹配到 Soln 主体 |
先选择 OpenLink,再点击详情面板中的对应操作进入页面。
推荐配置流程
新建 OpenLink 时,建议按这个顺序处理:
- 创建 OpenLink
- 如果 Soln 需要调用外部 API,配置出站鉴权
- 如果外部系统会请求 Soln,配置入站鉴权和白名单规则
- 在 OpenLink 下创建外部表单
- 配置外部字段和标识字段
- 配置集成流
- 当外部主体需要匹配 Soln 用户、部门或组织时,配置组织映射
- 必要配置检查完成后启用 OpenLink