添加飞书账号为组织用户
一、功能概述
在 Quick BI 中，“添加飞书账号为组织用户”是一项用于快速导入外部系统用户的管理功能。该功能允许组织管理员将飞书中的成员账号一键同步至 Quick BI 平台，便于统一管理和权限分配。
主要优势：
高效集成：无需手动逐个创建用户，支持一次性添加单个或多个飞书账号，提升组织用户管理效率。
角色灵活配置：添加用户时可直接指定其在组织和空间中的角色类型（如开发者、分析师、访问者等），实现权限精细化控制。
维护便捷：支持后续更新架构，自动识别组织结构变动（如人员更名、离职等），确保 Quick BI 用户信息与飞书保持一致。
说明: 在实际使用过程中，需要注意许可证限制和用户角色对权限的影响。例如，某些操作（如加入工作空间）仅限特定角色执行，且批量添加用户时可能因超过许可证上限导致失败。
典型应用场景：
企业希望将现有飞书中销售部门的成员批量导入 Quick BI，并设置为“分析师”，以便他们能快速开始制作仪表板。
组织管理员定期同步飞书通讯录，以更新 Quick BI 中的用户列表，确保离职员工被及时移除，避免权限泄露。
二、使用限制
为了确保添加飞书账号功能的稳定性和安全性，请注意以下使用限制：
仅限组织管理员操作：只有具有“组织管理员”角色的用户才能执行添加飞书账号的操作。
仅支持专业版用户：添加的飞书账号必须属于已开通 Quick BI 专业版的用户。
不支持跨平台重复用户合并逻辑以外的自定义处理：如果某用户同时属于多个飞书企业，Quick BI 将自动识别并视为一个用户，以最后一次同步的企业信息为准。
昵称冲突处理机制自动生效：若导入过程中出现用户名重复，系统将自动在昵称后加随机数尾缀以区分。
补充说明: 同步前请确认所选部门下的成员数量未超过许可证限制，否则会导致同步失败。
三、操作步骤
请按照以下步骤将飞书账号添加为 Quick BI 组织用户：
登录 Quick BI 控制台
地址：Quick BI控制台进入用户管理页面
在首页右上角点击菜单，选择用户管理页面。
选择添加方式
在成员管理页签的右上角，点击添加用户>从办公软件同步。
配置同步参数
在弹出的同步组织架构对话框中，进行如下设置：账号类型：选择飞书账号
账号来源：选择对应的飞书组织
昵称后缀：可选择默认或自定义（如工号、邮箱）
昵称同步规则：选择保留原有昵称或覆盖
添加成员：勾选需要同步的成员，点击更新到右侧
用户类型：选择开发者、分析师、访问者
用户角色：根据需求选择组织管理员、权限管理员、普通用户 或 自定义角色（仅限开发者和分析师）
开始同步
点击开始同步按钮完成操作。查看同步记录（可选）
单击右上角的同步记录查看历史同步详情。
常见问题提醒:
访问者角色无法加入工作空间：如需将用户加入工作空间，请将其角色设置为“开发者”或“分析师”。
同步失败提示用户数超限：检查所选部门下成员数量是否加上已有用户总数已超过许可证限制。
四、常见问题 (FAQ)
功能使用类
Q: 新建用户为何无法加入空间？
A: 如果该用户的组织角色为“访问者”，则其默认无法加入任何工作空间。请将用户类型设置为“分析师”或“开发者”后再尝试添加。
Q: 飞书账号同步后看不到某些用户怎么办？
A: 请前往飞书后台检查 Quick BI 应用的可见范围设置，确保应用权限中“通讯录”设为“与可用人员范围保持一致”，并正确设置了“应用可见范围”。
Q: 是否可以通过角色控制开放平台模块的访问权限？
A: 系统默认角色中，除“访问者”外均可访问开放平台；自定义角色目前仅支持按功能粒度控制权限，暂不支持整体模块控制。