企业身份插件列表与操作说明
钉钉、飞书、企业微信使用相同的列表操作。本文按页面说明每列、每个按钮和弹窗的用途。平台特有的动态字段见钉钉、飞书、企业微信；平台权限、同步策略和完整接入顺序见企业身份插件使用指南。
找到对应列表
在 集成 → 应用 打开已安装的插件，左侧菜单包含：
| 菜单 | 内容 |
|---|---|
| 应用信息 | 插件版本、运行状态、权限声明、回调 URL 与单点登录入口；平台凭据通过 编辑应用 修改 |
| 组织映射 → 组织 | 外部根组织及其与已有 Soln 组织的绑定 |
| 组织映射 → 部门 | 外部部门、上级关系及其与已有 Soln 部门的绑定 |
| 组织映射 → 用户 | 外部成员、所属部门及其与已有 Soln 成员的绑定 |
| 消息推送 → 推送配置 | 每个业务应用的推送开关、消息模板范围；钉钉另有 AgentId |
| 消息推送 → 消息日志 | 当前插件来源下的发送记录、接收人、结果和重试入口 |
左侧菜单搜索用于寻找菜单，不是搜索成员或消息。组织映射和消息推送入口需要当前账号具备管理应用安装的权限；停用插件时先启用，再获取通讯录或管理推送。
组织、部门、用户列表
三个列表显示的是外部通讯录快照及绑定信息，不能在单元格中直接编辑外部资料，也没有新增或删除外部成员的行操作。需要改外部姓名、部门等资料时，到对应平台修改后重新获取。
顶部工具
| 控件 | 用法与影响 |
|---|---|
| 搜索 | 输入后按 Enter 或提交搜索，按外部名称、ID、外部上级/部门名称和返回的字段原始值查找；清空恢复全部。不会按绑定的 Soln 对象名称搜索，也不是按界面翻译后的状态文字搜索 |
| 下载图标 | 下载当前类型、当前已提交搜索条件下的全部数据，不限当前页；Excel 包含固定列、动态字段及绑定信息，不含操作按钮 |
| 同步组织架构 | 打开整个插件的组织、部门、成员字段映射；从任一列表进入，编辑的是同一份同步配置 |
| 自动绑定 | 为当前类型配置匹配规则。组织列表的规则不会自动作为部门或用户规则 |
| 获取通讯录 | 请求平台最新通讯录，更新这个插件的组织、部门和用户快照；成功后执行已保存的自动绑定规则，已启用组织同步时也会执行同步 |
| 刷新图标 | 重读已保存的当前列表，不主动请求外部平台；后台已更新数据时，用它查看最新快照 |
将鼠标移到 获取通讯录 上可查看最近获取时间；它不是每个成员资料的更新时间。首次未成功获取时会提示先获取通讯录，自动绑定与同步组织架构按钮不可用。没有结果、正在处理或插件停用时，相关按钮可能禁用。
列表默认每页 20 条，可选 50、100 条，使用分页切换。搜索覆盖快照中的全部记录，不限当前页。下载期间如果后台更新导致快照变化，导出会失败，刷新后重新下载。
固定列
| 列 | 出现位置 | 如何理解 |
|---|---|---|
| 序号 | 三个列表 | 当前查询结果中的行序号，不是平台 ID |
| 外部名称 | 三个列表 | 平台返回的组织、部门或成员名称 |
| 外部 ID | 三个列表 | 本插件识别对象的稳定标识；与 Soln 内部 UUID 不同 |
| 上级部门 | 部门列表 | 平台上级部门名称；快照没有对应名称时可能显示 ID |
| 所属部门 | 用户列表 | 平台返回的成员部门，可包含多个；不代表成员已经属于这些 Soln 部门 |
| 绑定状态 | 三个列表 | 未绑定、已绑定、绑定对象不可用，见下表 |
| Soln 组织 / Soln 部门 / Soln 成员 | 对应列表 | 当前绑定的内部对象；成员有邮箱时也会展示邮箱 |
| 绑定方式 | 三个列表 | 手动绑定或自动匹配；企业微信授权登录补充的绑定也归为自动匹配 |
| 绑定状态 | 含义与下一步 |
|---|---|
| 未绑定 | 没有内部对应关系；点击 绑定，或配置当前类型的自动绑定 |
| 已绑定 | 已有绑定，内部对象当前有效；只表示标识对应关系，不表示已同步资料、已发送消息或已经登录 |
| 绑定对象不可用 | 绑定仍保留，但内部对象不再有效，例如停用或已删除；核对内部对象状态，必要时调整绑定，不能当作有效消息接收人 |
动态字段与详情抽屉
固定列后是平台返回的属性，例如邮箱、工号、头像地址、激活状态和自定义属性。没有拿到的字段不会凭空补值：可能整列未出现，也可能只在个别行为空。先检查平台权限、字段资料、可见范围或成员授权。
已识别的平台字段会翻译名称、布尔值和状态；已知时间戳会格式化为时间。没有识别的自定义字段保留字段路径和值。数组和对象以结构化文本显示，点击 查看，在右侧抽屉中阅读较长内容；空值显示 -。抽屉展示当前记录的固定列及动态字段，只读，没有保存或复制按钮。
例如外部“是否激活”为“已激活”，并不代表 Soln 成员已启用；“是否管理员”也不会为绑定成员授予 Soln 管理权限。
行操作：查看、绑定、解绑
| 操作 | 具体步骤 | 保存后的结果 |
|---|---|---|
| 查看 | 点击当前行 查看，检查外部 ID、归属、绑定和动态属性，关闭抽屉返回 | 不修改数据 |
| 绑定 | 核对弹窗只读的外部名称和 ID，再用 Soln 组织、部门或成员选择器选择目标，点击 保存绑定 | 建立或调整对应关系；已绑定行打开时会带出当前目标 |
| 解绑 | 仅已有绑定时可用；确认弹窗中的两边对象后执行 | 移除对应关系，保留两边对象及其资料 |
选择目标使用与业务表单相同的组织、部门、成员字段控件。组织选组织，部门选部门，用户选成员；绑定本身不会移动成员到另一个部门。目标已被同类型的另一个外部对象绑定时会提示冲突，不会自动抢占。
解绑之后，如果自动匹配规则仍能唯一匹配，该关系可能在下次成功获取通讯录后重新建立。已启用组织同步时，未绑定对象也可能在后续同步中走新增，因此不要把解绑当作“永久排除此对象同步”的开关。
自动绑定弹窗
| 字段或操作 | 说明 |
|---|---|
| 外部组织 / 部门 / 用户字段 | 从当前快照实际返回的字段选择，选项展示字段名称及原始路径，例如邮箱 email |
| Soln 组织 / 部门 / 成员字段 | 选择内部用于比较的字段，选项展示名称及字段编码，例如邮箱 so_email |
| 精确匹配 | 去除两边首尾空格后比较，仍区分大小写 |
| 忽略大小写 | 去除首尾空格并忽略大小写，适合邮箱等场景 |
| 保存自动匹配 | 保存规则并立即执行一次；保持弹窗可查看本次统计 |
| 关闭 | 关闭弹窗；未点击保存的修改不会生效 |
| 标题右侧提示图标 | 查看后台更新频率、仅补未绑定项和已有绑定保留规则 |
结果按当前类型的全部外部快照统计，不受列表搜索或当前页限制；内部候选只匹配有效、启用的对象。
| 统计项 | 含义 |
|---|---|
| 共 | 本次扫描的外部对象数 |
| 新绑定 | 本次新建立的对应关系数 |
| 保留 | 已有绑定的外部对象数，即使字段后来改变也不覆盖 |
| 空值 | 尚未绑定且外部比较字段为空或不能用于比较的对象数 |
| 未匹配 | 外部字段有值，但找不到对应的有效内部候选；内部字段为空、对象停用等也可能导致此结果 |
| 冲突 | 外部比较值重复、内部候选不唯一，或匹配到的内部对象已被其他外部对象绑定 |
多条外部或内部对象共享同一个比较值时不能自动判断；先处理重复资料或手动绑定。
示例：在 用户 列表选择外部邮箱 email → 内部邮箱 so_email → 忽略大小写。Alice@example.com 与 alice@example.com 唯一对应时可以绑定；两位内部成员都使用同一比较值时，不会任选一位。组织或部门按名称匹配时，同名部门也存在同样限制。
同步组织架构弹窗
此处配置“哪个外部字段写入哪个内部字段”，不是再次选择组织或部门对象。弹窗统一配置组织、部门、成员三类字段。
| 控件 | 用法 |
|---|---|
| 新增映射 | 新增一行，先在左侧选择外部字段，再在右侧选择相同类型的内部目标字段 |
| 左侧外部字段 | 以组织、部门、用户分组，可搜索名称；切换对象类型后要重新核对右侧 |
| 右侧内部字段 | 例如 [部门] 名称（so_name）；未选择左侧时不可选，不同对象类型、不允许写入或已占用的目标不可选 |
| 自动映射 → 按名称 | 按字段名称生成候选，仍需人工核对 |
| 自动映射 → 按编码 | 按字段编码匹配，处理内部 so_ 前缀；匹配不唯一的目标会跳过 |
| 行末删除图标 | 移除这一条字段映射，不删除部门、成员或它们的对象绑定 |
| 底部外部部门删除后 | 选择保留、停用或删除；查看旁边提示了解完整读取范围和内部依赖限制 |
| 保存映射 | 保存字段与删除策略，并保持原有同步开关状态。首次未启用时仅保存配置；已启用时保存的规则会用于后续同步 |
| 启用自动同步 | 校验后保存当前规则并启用，无需先另点保存；如果另一个有效来源已启用，会提示冲突 |
| 禁用自动同步 | 按已保存的配置停用，不保存弹窗中尚未提交的字段或删除策略修改 |
| 取消 / 关闭 | 放弃未保存的修改，不改变后台已有同步状态 |
最近同步结果显示在弹窗内，展开 查看同步失败记录 可看对象类型、外部名称、外部 ID 和错误码，最多显示 100 条失败。待激活是尚需管理员启用的新成员；删除待确认表示没有满足确认外部部门缺失的条件。同步使用内部校验，修正必填字段、邮箱、上级绑定或引用后等待下一轮。
字段映射不完整或同一类型内部目标重复时不能保存。仅配置了某一类型的映射，只同步该类型；层级与归属仍依赖相关组织和部门绑定，不能因为用户字段配好了就跳过上级依赖。详细规则见组织架构同步。
消息推送：推送配置列表
此列表每行表示“当前平台插件向一个业务应用提供推送”。例如钉钉插件下的审批配置与飞书插件下的审批配置各自独立，需要分别设置；开通一家的消息权限不会开通另外两家。
列、筛选和行操作
| 控件或列 | 说明 |
|---|---|
左侧推送配置菜单旁的 + | 先选中 推送配置，再点击旁边新增图标；不是组织列表的新增按钮 |
| 时间范围 | 按配置创建时间筛选，默认不限制；编辑旧配置不会改变其创建时间 |
| 搜索 | 按业务应用名称、编码、消息模板名称或编码查找，提交后生效 |
| 刷新图标 | 重新加载配置与可选应用、模板 |
| 业务应用 / 应用编码 | 被转发的消息所属业务应用及其稳定编码，不是平台 App ID 或 AgentId |
| 状态 | 这条业务应用配置已启用或已停用；不是插件容器的状态 |
| 消息模板 | 允许转发的模板，空选择显示 全部消息 |
| 钉钉 AgentId | 仅钉钉显示，应属于插件 Client ID 对应的企业内部应用 |
| 创建时间 / 更新时间 | 本条配置建立和最近保存的时间 |
| 编辑 | 修改模板范围、钉钉 AgentId；已有配置的业务应用不可改 |
| 启用 / 停用 | 直接切换该行推送开关；编辑弹窗中没有启用开关 |
| 删除 | 二次确认后移除配置，排队通知停止发送，已有日志保留；需要恢复时重新新增 |
列表可分页，不提供批量启停、批量删除或 Excel 下载按钮。
新增与编辑弹窗
- 选择 业务应用：只列出已启用且有启用的消息收件箱来源的业务应用，不包含消息中心和 Luna；已配置的应用在新增选项中不可重复选择
- 钉钉填写 AgentId；飞书和企业微信没有此字段，企业微信使用插件安装配置中的 AgentId
- 在 消息模板 中搜索、多选或清空。可选项来自当前启用且支持站内消息的内置及自定义模板，最多选 100 个
- 悬停业务应用、AgentId 或弹窗标题旁的提示图标，查看推送范围及平台权限要求
- 点击 保存。新配置默认停用，需回列表点 启用；编辑保存会保留原来的启用状态
空选择表示该业务应用的全部消息，包含没有模板的自定义消息。选择一个或多个模板后，只有对应模板消息允许推送；这时不带模板的消息不会匹配。模板范围控制的是后续推送，不会补发以前的提醒。
模板下拉是租户可用模板列表，不会因为选了业务应用而只展示该应用的模板。应选择该应用实际产生的消息所用模板；选了另一业务才使用的模板，不会把另一应用的消息转进本条配置。
消息推送：消息日志列表
查找记录
页面默认显示最近 7 天，按日志创建时间筛选。找不到较早记录时，先扩大或清空时间范围；随后选择业务应用、状态，并提交搜索。条件叠加生效，修改条件会回到第一页。
搜索支持消息标题、内容摘要、Soln 成员 ID、外部用户 ID、主题或错误码，不按成员显示名称搜索。可用 ID 从用户绑定详情核对。列表每页可选 20、50、100 条。
页面打开期间约每 5 秒重读日志，刷新图标可以立即重读；这个频率与后台约每 5 分钟更新通讯录是两件事。刷新日志不会重新发消息，也不会重新获取通讯录。
每列的含义
| 列 | 说明 |
|---|---|
| 创建时间 | 该推送记录进入日志的时间，用于日期筛选，不是已读时间 |
| 标题 | 本条提醒的标题 |
| 应用 | 消息所属业务应用 |
| 状态 | 排队中、发送中、平台已接受、等待重试、失败、已跳过、结果不确定 |
| Soln 成员 ID | 本次站内提醒接收成员的 ID；同一提醒的不同接收人需要分别排查 |
| 主题 | 消息系统的业务主题标识，用于定位来源；不是需要用户手工填写的模板筛选条件 |
| 尝试次数 | 当前记录的发送尝试次数，不是成员查看次数 |
| 结果说明 | 根据状态或错误码显示说明；没有错误码时也会显示如“平台已接受推送请求”的状态说明 |
| 查看 | 打开此条消息的详情抽屉 |
同一业务事件可能向多个成员或多个平台发送消息，应在相应插件中按接收成员逐条核对；一条成功记录不能证明其他接收人也成功。
详情抽屉与重试
| 分组 | 字段和用途 |
|---|---|
| 基本信息 | 日志 ID、创建与更新时间、状态、尝试次数，用于定位这一次发送 |
| 消息内容 | 业务应用及编码、主题、消息中心记录 ID、标题、正文摘要，核对来源消息 |
| 接收人 | Soln 成员 ID 与外部用户 ID，核对发给了谁；外部用户 ID 尚未确定时可能显示 - |
| 推送结果 | 平台消息/任务 ID、结果说明、原始错误码，区分平台返回、权限问题和本地跳过 |
右上角 重试 只在失败或跳过的记录出现。记录不足 24 小时、当前应用推送已启用且模板仍在允许范围内时才可操作；不符合条件时按钮禁用，可查看悬停提示。点击后是重新入队，不保证立刻收到，也不重新执行原审批或业务操作。结果不确定的记录不提供此重试入口。
没有日志与已有失败日志的区别
| 情况 | 排查顺序 |
|---|---|
| 新提醒没有日志 | 先确认消息已进入正确业务应用的消息中心，再检查当前插件的业务应用配置、启用时间、模板范围、日期与搜索条件。没有命中推送配置的消息可能根本不会创建日志 |
| 有日志，提示成员未绑定或不可用 | 到 组织映射 → 用户 查看绑定状态和外部 ID，检查内部成员是否启用、是否仍在外部通讯录中 |
| 有日志，提示平台拒绝 | 查看抽屉的原始错误码，按平台指南检查凭据、权限、可见范围；企业微信还需核对实际出口 IP |
| 平台已接受但成员没看到 | 核对外部接收 ID 和平台应用入口；平台接受不等于送达或已读，钉钉还可能在异步发送任务中处理 |
| 结果不确定 | 先核对平台实际消息或可用发送结果，避免通过重复发起业务事件产生重复通知 |
完整操作示例
仅向一位已有成员推送审批提醒时：
- 在平台批准通讯录及个人消息权限，在 Soln 用户 列表点击 获取通讯录
- 搜索这位成员的外部邮箱或 ID，点击 查看 核对身份，再点 绑定 选择已有 Soln 成员
- 确认列表为 已绑定，无需启用组织架构同步
- 打开 推送配置，点击左侧
+，选择审批消息所属业务应用和所需审批模板；钉钉填写 AgentId - 保存后在列表点 启用，产生一条新的审批提醒
- 打开 消息日志，按业务应用和时间筛选，用接收成员 ID 找记录，查看状态、正文和外部接收 ID，再到平台确认实际消息
需要几百位成员时，先设置用户自动绑定规则，确认冲突与空值；企业微信邮箱受限时可用授权登录补充绑定。只有需要把外部组织架构写入内部时，再配置并启用组织同步。