添加钉钉账号为组织用户
一、功能概述
在 Quick BI 中，添加钉钉账号为组织用户是一项便捷的用户管理功能，允许组织管理员将企业钉钉中的成员快速同步至 Quick BI 系统中。该功能特别适用于已深度使用钉钉进行内部沟通与协作的企业，能够实现组织用户的统一管理和权限配置。
核心优势：
高效同步：支持一次性添加单个或多个钉钉账号，提升用户管理效率。
角色灵活配置：可为每个同步的用户指定用户类型（开发者、分析师、访问者）及组织角色（如组织管理员、权限管理员等），便于精细化权限控制。
自动识别重复用户：当同一钉钉用户属于多个企业时，系统自动识别并合并为一个用户，避免重复注册问题。
补充说明: 钉钉账号同步后，若用户需要加入工作空间，请确保其用户类型不是“访问者”。访问者不支持被添加到任何工作空间中。建议将其更改为“分析师”或“开发者”以获得相应权限。
典型应用场景：
企业希望将钉钉通讯录中的员工批量导入 Quick BI，并按岗位职责分配不同权限，例如将销售经理设置为“分析师”，仅能查看销售数据仪表板；将IT管理员设置为“组织管理员”，具备全局管理权限。
在大型组织中，需定期更新人员变动信息（如员工入职、离职或部门调动），通过同步钉钉组织架构，Quick BI 可快速反映这些变化。
二、使用限制
仅组织管理员支持添加钉钉账号为组织用户。
仅支持添加开通 Quick BI 专业版的用户。
钉钉账号来源受限于钉钉接口授权时所接入的企业范围，若未完成钉钉接口授权或授权范围不完整，可能导致部分成员无法同步。
补充限制: 同步的钉钉成员数量 + 已有 Quick BI 用户数不能超过许可证允许的最大用户数。否则会提示“超过用户数”，导致同步失败。
三、操作步骤
登录Quick BI 控制台。
在首页点击右上角用户头像，进入用户管理页面。
在成员管理页签右上角，点击添加用户 > 从办公软件同步。
在弹出的同步组织架构对话框中：
设置账号类型为钉钉账号。
若已接入多个钉钉组织，选择所需的账号来源。
设置昵称后缀（可选自定义，如工号、邮箱等）。
选择昵称同步规则（保留或覆盖原有昵称）。
勾选需要同步的钉钉成员，点击更新到右侧。
指定每个用户的用户类型和用户角色。
确认无误后，点击开始同步。
同步完成后，可在同步记录查看同步详情。
说明：建议在钉钉组织架构变动后，先执行“更新架构”再同步，以确保数据一致性。
操作提示: 同步过程中如果出现“用户名或昵称重复”的错误提示，建议检查导入模板中是否存在与系统中已有用户冲突的字段。若确认无误仍报错，可尝试手工逐个添加用户以绕过该问题。
四、常见问题 (FAQ)
功能使用类
Q: 同步钉钉账号后，部分成员未出现在 Quick BI 中？
A: 可能原因如下：
钉钉微应用的可见范围设置不完整，请登录钉钉后台检查该应用是否对目标成员开放。
成员未在 Quick BI 授权范围内所属的企业中，请确认钉钉接口授权时所接入的企业是否包含目标成员。
若上述设置均正确仍无法同步，请联系 Quick BI 客服进一步排查。
Q: 账号同步后无法加入工作空间？
A: 如果是通过钉钉同步的账号，且用户类型为“访问者”，则默认不具备加入空间的权限。请修改用户类型为“分析师”或“开发者”后再尝试添加。
Q: 同步后用户信息发生变化（如姓名、部门），如何更新？
A: 系统支持更新架构功能：
当用户名称变更时，会在用户列表中标注“名称变更”，可手动删除旧记录重新同步。
当用户不再属于当前组织时，会标注“待删除”，同样可手动删除或点击“更新架构”自动修正异常节点。
技术限制类
Q: 邮箱是否支持批量更新？
A: 邮箱字段不支持批量更新操作，因绑定邮箱需通过验证码验证。
Q: 是否可以通过固定角色控制开放平台模块的访问权限？
A: 系统默认角色中除“访问者”外均可访问开放平台模块；自定义角色目前仅支持按功能粒度控制权限，暂不支持整体模块控制。
Q: 是否可以只设置用户管理权限，而屏蔽其他功能？
A: 目前不支持仅赋予用户管理权限而不开放其他功能。只有“权限管理员”和“组织管理员”拥有用户管理模块的访问权限。