从办公软件同步
一、功能概述
“从办公软件同步”是一项用户管理功能，支持将钉钉、飞书、企业微信等办公软件中的组织架构和成员信息快速导入 Quick BI 系统中，实现对用户的统一管理和权限配置。
该功能的核心优势包括：
高效管理：无需手动创建或维护大量用户信息，通过同步即可自动完成用户和部门的导入，节省时间并减少出错率。
结构清晰：保留原有组织架构层级，便于按照部门或团队进行用户组分类管理。
权限统一：结合用户类型（开发者、分析师、访问者）与角色（如管理员），可批量赋予相应权限，提升权限管理效率。
典型应用场景：
企业在使用 Quick BI 搭建数据分析平台时，希望将现有钉钉/飞书/企业微信中的部门与员工信息一键导入，快速构建对应的用户体系。
当组织架构发生变动（如人员离职、调岗、新增部门）时，可通过更新架构功能保持 Quick BI 中用户数据的最新状态，确保权限控制准确无误。
说明：
在实际使用过程中，以下常见问题值得特别关注：
同步操作前需确认当前许可证容量是否足够，否则可能导致同步失败；
同步后的用户无法自动删除，需手动处理异常节点；
若用户账号重建（如 RAM 账号被删除后重新创建），需重新加入 QBI 组织以恢复关联。
二、使用限制
为确保同步操作顺利进行，请注意以下限制条件：
前置条件：必须已创建用户组，才能执行同步操作。
账号绑定：若未绑定钉钉、飞书或企业微信账号，则需先完成办公软件接入操作。
用户识别机制：如果某用户同时属于多个企业，Quick BI 会将其视为单一用户添加，其信息以最后一次同步的企业为准。
不支持自动删除：当办公软件中某个用户被移除后，在 Quick BI 中不会自动删除，需手动操作或点击“更新架构”处理异常节点。
昵称冲突处理：系统会在昵称重复的情况下自动添加随机数尾缀，但无法完全避免重名问题。
补充注意事项：
同步用户数量 + 已有用户数不得超过许可证限制，否则同步将失败；
邮箱字段不支持批量更新，因绑定邮箱需验证码验证；
若用户账号重建（如 RAM 删除后重新创建），需重新加入 QBI 组织以恢复关联；
使用钉钉扫码登录的用户若更换了主账号，原账号中的看板内容仍保留在旧账号下，需确认当前账号权限配置。
三、操作步骤
在 Quick BI 控制台中，按照以下步骤执行从办公软件同步的操作：
登录Quick BI 控制台。
在首页进入用户管理页面（根据界面指引操作）。
在用户组列表顶部点击从办公软件同步图标，弹出同步组织架构页面。
在同步页面中依次配置以下选项：
① 账号类型：选择钉钉、飞书或企业微信。
② 来源账号：选择已接入的企业名称（若接入多个企业则需手动选择）。
③ 昵称后缀（钉钉、飞书）：选择默认或自定义后缀（如工号、电话、邮箱）以区分重名用户。
④ 昵称同步规则（钉钉、飞书）：选择保留或覆盖已有昵称。
⑤ 展示节点类型：可筛选展示全部、已同步或未同步成员。
⑥ 添加成员：勾选需要同步的用户或部门，点击更新到右侧。
⑦ 用户类型：设置为开发者、分析师或访问者。
⑧ 用户角色：仅适用于开发者和分析师，可设为组织管理员或权限管理员。
完成配置后，点击开始同步。
同步完成后，可在右上角查看同步记录。
如需更新组织架构：
若用户名称变更，会显示“名称变更”提示；
若用户不在组织内，会显示“待删除”提示；
可点击图标删除用户或点击更新架构修正异常节点。
操作建议：
若企业微信同步用户时希望指定特定用户组，目前不支持自定义用户组映射；
导入用户后无法直接添加至工作空间，若出现按钮灰色不可用的情况，请检查用户类型是否为“访问者”，该类型不支持加入工作空间；
批量导入用户模板中若存在用户名或昵称重复项，会导致整个导入失败，建议逐个手工添加排查冲突；
新增用户后若无法登录 Quick BI，请确认是否已被正确加入组织。
四、常见问题 (FAQ)
Q: 同步是否会覆盖 Quick BI 中已有的用户信息？
A: 同步操作不会覆盖 Quick BI 中已存在的用户信息。例如，如果一个用户已被手动添加，并且再次通过办公软件同步导入，系统会识别为同一用户，仅更新部分字段（如名称），而不会更改原有的权限设置或角色分配。
Q: 同步后发现某些用户没有正确导入怎么办？
A: 可以点击“更新架构”按钮，系统会重新扫描办公软件中的组织结构，并标记出名称变更或已移除的用户。您可以根据提示手动删除异常用户或更新架构信息，确保数据一致性。
Q: 如何给用户授权？
A: 在用户管理页面中，可设置用户类型（开发者、分析师、访问者）及角色（如组织管理员、权限管理员）来分配权限。
Q: 开发者与分析师权限有何区别？
A: 开发者比分析师拥有更多权限，特别是在数据源和数据集管理方面。一般情况下，给予开发者权限即可满足需求，无需同时开启两个角色。
Q: 为什么最后登录时间显示为空或不准确？
A: 成员管理中的最后登录时间仅反映阿里云账号的登录行为，不包含绑定账号（如飞书）的登录记录。
Q: 企业微信同步账号时能否指定默认用户组？
A: 企业微信账号同步遵循其组织架构，无法指定自定义用户组。