用户集成是系统集成中最常见的要求之一。当有多套系统同时使用时，客户往往希望统一进行用户管理、统一登录认证，也就是说只在一个系统中维护基础用户信息、只登录一次（单点登录）就可以访问不同系统的内容。用户集成包含两个方面内容：

• 用户同步：指多套系统拥有相同的用户信息，当以外部系统作为统一用户管理平台时，常采用如下四种方式实现 Smartbi 用户同步：
  • 方式一：使用存储过程或 ETL 定时将第三方系统中的用户等信息同步到 Smartbi 用户表中。
  • 方式二：在第三方系统中使用 Smartbi 用户管理的远程调用接口实现用户等信息的同步。
  • 方式三：通过EXCEL导入方式实现用户信息同步。
  • 方式四：通过计划任务同步用户信息，建议使用该方案（请参考 通过计划任务自动同步用户机构和角色）。
    
    
• 用户验证：验证用户是否是合法的系统用户，Smartbi 既可以使用自己的验证体系，也支持使用第三方系统的用户验证体系。具体请参考 使用第三方系统的用户验证。

注意事项：Smartbi 还有角色概念，无论哪种集成方式，都要求在 Smartbi “管理 > 用户管理”模块中创建角色，并设置角色的操作权限和数据权限；用户必须被赋予角色，才能登录 Smartbi 并使用相应的功能。

字段类型：

       下文表结构中的字段类型等信息，均是针对 MySQL 5.0 而言，其它数据库类型的对应关系如下表所示：

注意事项：

• 同步组：需要同步表t_group，如果需要给组赋角色，则还需同步表t_group_role；
• 同步用户：需要同步表t_user、t_group_user 、t_user_role；
• 同步角色：需要同步表t_role；
• 同步操作权限：需要同步表t_funclist、t_role_func，在表t_funclist中新增操作权限如funcTest，必须把此权限赋予给角色ADMINS，即在表t_role_func中增加一条funcTest与ADMINS的记录。

t_group（用户组表）

t_group 用户组表，记录用户组的信息。通过字段c_orgid，实现用户与机构的关联。

t_user（用户信息表）

t_user 用户表，记录所有用户信息。

t_group_user（用户组与用户对应表）

t_group_user 用户组与用户对应表。相关字段：t_user.c_userid、t_group. c_groupid。

t_role（角色表）

t_role 角色表，记录系统所有角色的信息。相关字段：t_group. c_groupid。

t_group_role（用户组与角色对应表）

t_group_role 用户组与角色对应表。相关字段：t_role.c_roleid、t_group. c_groupid。

t_user_role（用户与角色对应表）

t_user_role 用户与角色对应表。相关字段：t_role.c_roleid、t_user. c_userid。

t_funclist（操作权限表）

t_funclist 操作权限表。

t_role_func（角色与操作权限关系表）

t_role_func 角色与操作权限关系表。相关字段：t_role.c_roleid、t_funclist. c_funcid。

调用API接口实现用户同步

说明：

        Smartbi 提供 Java 和 JavaScript 两种 API 供外部系统调用实现用户信息同步。

1、服务器端SDK同步用户

2、浏览器端SDK同步用户

实现步骤：

1、当在第三方系统进行增删用户/用户组等操作时，后台程序调用 Smartbi 提供的 API 接口同步将用户信息同步到 Smartbi 系统中。

2、调用方法请参考开发接口中 服务器端SDK 和 浏览器端SDK 中的操作步骤。

3、演示图的源码请参考 服务器端SDK同步用户.rar 和 浏览器端SDK同步用户.rar 

系统方法：

系统提供的用户管理方法示例如下。

通过EXCEL导入用户实现同步

说明：

Smartbi 提供导入EXCEL信息实现用户信息同步功能。

实现步骤：

1、登录Smartbi，参考 导入用户信息。

        下面对模版文件进行详细说明：该文件有三个sheet页，分别为：用户、组、角色，以下分别从用户、组、角色三方面介绍导入信息该如何填写。

（1） 用户，格式如下：

• 用户ID：必填项，内容可随意定义，但必须保证其唯一性。对应t_user表中的c_userid。
• 用户名称：必填项，登录名称，必须保证其唯一性。对应t_user表中的c_username。
• 用户别名：别名，对应t_user表中的c_useralias。
• 用户密码：密码，对应t_user表中的c_userpwd。
• 用户描述：描述。对应t_user表中的c_userdesc。
• 是否启用：该用户是否可以正常使用系统。1为启用、0为禁用，若不填写，则默认为禁用。对应t_user表中的c_isenabled。
• 用户所属组ID：用户所在组的组ID，此ID需要与“组”sheet页中的组ID对应，多个组用半角符号;分隔。若不填写，则默认为根组。对应在t_group_user表中的增加相关记录。
• 用户角色：用户所拥有的角色ID，此ID需要与“角色”sheet页中的角色ID对应，多个角色用半角符号;分隔。对应在t_user_role表中增加相关记录。

（2） 用户组，格式如下：

• 组ID：必填项，内容可随意定义，但必须保证其唯一性。对应t_group表中的c_groupid。
• 组名称：必填项，名称，必须保证其唯一性。对应t_group表中的c_groupname。
• 组别名：别名，对应t_group表中的c_groupalias。
• 组描述：描述。对应t_group表中的c_groupdesc。
• 机构编号：对应t_group表中的c_orgid。
• 父组ID：对应t_group表中的c_pgrounpid。

（3）角色，格式如下：

• 角色ID：必填项，内容可随意定义，但必须保证其唯一性。对应t_role表中的c_roleid。
• 角色名称：必填项，名称，必须保证其唯一性。对应t_role表中的c_rolename。
• 角色别名：别名，对应t_role表中的c_rolealias。
• 角色描述：描述。对应t_role表中的c_roledesc。
• 角色所属组ID：对应t_role表中的c_groupid。若此项不填写，系统自动把角色创建在根组下。