一 概述
用户同步是指有多套系统（包括Smartbi系统）都拥有用户信息。当用户信息存储于第三方系统或使用第三方系统进行用户管理时，需要将第三方系统的用户数据同步到Smartbi系统中。
Smartbi提供用户同步功能，通过界面化简单配置即可实现定期同步用户数据。
二 用户同步核心概念
1 三大核心概念
在Smartbi系统中，用户管理涉及三类关键对象，需与第三方系统数据一一对应
| 对象 | 说明 | 示例 |
|---|---|---|
| 用户组 | 即“机构”，以树形结构组织，体现层级关系。
| 如广州思迈特软件有限公司->开发部->运维组 |
| 角色 | Smartbi系统中的主要权限载体，角色可分配给用 户及用户组，决定用户在系统中的权限。
| 如组长、普通组员 |
| 用户 | 系统的实际使用者。
| 如张三（登录账号zhangsan） |
2 属性映射
每个对象包含多个属性，需与第三方系统数据字段建立对应关系
1）用户组（机构）属性
| 属性 | 属性说明 | 是否必须同步 | 同步逻辑 |
|---|---|---|---|
| 机构ID | 机构在系统中的唯一ID。 | 是 | 建议同步第三方系统中机构的唯一标识作为机构ID，若无则可由系统生成唯一ID。 若第三方系统中存在同名机构（如产品部下有“运维组“，开发部下也有“运维组”），则必须同步机构ID。 |
| 机构名称 | 机构的显示名称。 | 是 | 必须从第三方系统同步，用于机构显示和使用。 |
| 父机构 | Smartbi系统中，机构以机构树的形式存在，因此机构具有“父机构”属性 | 是 | 必须从第三方系统同步，支持机构ID或名称。 若父机构数据为机构名称，系统将基于机构名称构建组织机构树。当第三方系统中存在同名机构时，机构树将无法精准构建。 若父机构数据为机构ID，系统将基于机构ID构建组织机构树。由于机构ID为机构在系统中的唯一ID，因此可以保证机构树构建的精确性。 |
| 机构编号 | 机构的编号，一般用于实现数据权限控制。 | 否 | 可从第三方系统同步，若无则为空。 |
| 机构别名 | 机构的显示别名 | 否 | 可从第三方系统同步，若无则自动采用机构名称作为机构别名。 |
| 机构描述 | 机构的描述内容 | 否 | 可从第三方系统同步，若无则为空。 |
| 机构状态 | 额外增加的属性，用于将机构进行逻辑删除处理，值为0 、1 或 NULL。 | 否 | 若机构在第三方系统中被删除，需要在Smartbi进行逻辑删除，需同步状态为0。 |
2）角色属性
| 属性 | 属性说明 | 是否必须同步 | 同步逻辑 |
|---|---|---|---|
| 角色ID | 角色在系统中的唯一ID。 | 是 | 支持从从第三方系统同步，若无则可由系统生成唯一ID。 |
| 角色名称 | 角色的显示名称 | 是 | 必须从第三方系统同步，用于角色显示和使用。 |
| 角色所属机构 | Smartbi系统中，角色是存储于机构树上的某个机构下的。 因此需要为角色指定其所属机构。 | 是 | 1）必须从第三方系统同步； 2）所属机构数据支持机构ID、机构名称 |
| 角色别名 | 角色别名 | 1）可从第三方同步； 2）也可由系统自动使用角色名称作为别名。 | |
| 角色描述 | 角色的描述内容 | 1）可从第三方同步； 2）也可不同步，默认为空。 | |
| 角色状态 | 额外增加的属性，用于将角色进行逻辑删除处理。值为0 、1 或 NULL 0：代表需要在Smartbi中将角色进行逻辑删除。逻辑删除功能请参考：【链接】 1/NULL：代表角色正常使用，不做额外处理。 | 若角色在第三方系统中被删除，也需在Smartbi系统中对角色进行逻辑删除，则需同步角色状态。 |
