概述
本章节以如下机构为例，演示如何配置用户同步计划，将机构数据同步到Smartbi系统的用户管理中。
前提
需要先了解Smartbi用户管理模块中，机构包含哪些属性。
| 机构属性 | 说明 | 属性是否 必须设置 | 属性是否 支持修改 |
|---|---|---|---|
| 机构ID | Smartbi系统中，机构的唯一标识。 | 是 | 否 |
| 机构编号 | 机构的编号，通常用于数据权限控制的场景。 | 否 | 是 |
| 机构名称 | 机构的名称。 | 是 | 否 |
| 机构别名 | 机构的别名。若设置了机构别名，则在系统用户管理模块中，默认显示的是机构别名。 | 否 | 是 |
| 机构描述 | 机构的描述信息，用于记录机构的备注、详细说明。 | 都 | 是 |
| 父机构 | Smartbi系统中，机构是以机构树的形式展示，因此除顶级机构（根组）外，所有的机构都有对应的父机构。 | 是 | 是 |
| 机构状态 | 该属性为用户同步功能增加的隐藏属性，值为0、1或空。当值为0时，标识该机构被“逻辑删除”，在机构同步完成后，对应的机构将被移动到指定的机构下。便于用户统一管理“逻辑删除”的所有机构。 | 否 | 是 |
在配置机构同步时，建议机构ID、机构名称、父机构必须配置，其余机构属性可根据实际情况进行配置。
本演示示例中将同步 机构ID、机构名称、机构别名、机构描述、父机构数据。
实现步骤
1 创建数据模型查数
创建数据模型，从第三方系统中查询出机构数据。机构数据包含机构ID、机构名称、机构别名、机构描述、父机构ID字段。
数据如下
1）“广州思迈特软件有限公司”为需要同步的机构树的顶级机构，因此其父机构ID（即OrgID）需置空。
2）机构名称、机构别名不建议带有特殊符号，Smartbi系统中只支持"_"、"@" 这两种特殊符号。
3）所有的字段都在“维度”目录下。
当保存数据模型出现以下提示时，可选择任一维度字段，双击生成度量字段，以便保存数据模型。生成的度量字段将不会被使用到。
演示数据：机构同步用例数据.xlsx
2 创建用户同步计划
1）进入用户同步界面，新建用户同步计划。步骤1 【机构同步】按照如下配置
①选择待同步的机构数据：选择上一步骤中创建的数据模型
②顶级机构：该机构用于设置将同步过来的机构树挂在哪个机构下。选择“根组”，则同步完成后，同步过来的机构树将显示在“根组”下。
注意
1、同步的机构树自身的顶级机构的“父机构”字段值必须为空。如本示例中，同步的机构树的顶级机构是“广州思迈特软件有限公司”，则在查询数据中，“广州思迈特软件有限公司”的“父机构ID”字段值为空。在进行同步时，系统会自动将“根组”作为“广州思迈特软件有限公司”的父机构。
2、若实际同步的数据中，存在父机构字段值为空的机构，则在同步时，系统会自动将所选择“顶级机构”作为这些机构的父机构。
③机构ID：选择“绑定字段”方式，并选择数据模型中的“机构ID”字段。
④机构名称：选择数据模型中的“机构名称”字段。
⑤机构别名：选择数据模型中的“机构别名”字段。
⑥机构描述：选择数据模型中的“机构描述”字段。
⑦父机构：默认为“机构ID”类型，选择数据模型中的“父机构ID”字段。
2）点击上方步骤条中的 “5 执行计划”，直接跳转到步骤5进行设置。按如下设置
①无归属管理机构：该机构用于存储 机构状态为0的机构、以及无法找到父机构节点的机构。通常建议在Smartbi系统中手工创建一个机构，专门作为无归属管理机构。
本示例中不涉及机构状态的同步，设置为“根组”即可。
②用户同步计划名称：设置用户同步计划的名称，如命名为“机构同步”。
③用户同步执行计划：设置计划的执行时间等内容。使用的是系统中的“计划”功能，各设置项介绍可参考计划功能：新建计划
3）保存用户同步计划
3 查看执行结果
按照设定的执行时间，系统会自动执行同步计划。可通过以下方式查看执行结果
1）进入“计划任务”-“计划调度日志”中搜索同步计划名称，查看调度日志
2）进入“用户管理”，查看最新的机构信息
同步逻辑说明
机构同步，以机构ID或机构名称为主要依据，在系统的t_group表中进行机构数据的插入和更新：
若机构同步设置中，机构ID设置了绑定字段，则主要依据为机构ID；
若机构同步设置中，机构ID设置为“由系统自动生成”，则主要依据为机构名称。
注意
1、Smartbi系统中，机构ID是机构的唯一标识，因此推荐配置同步计划时，机构ID绑定数据模型字段。
2、若同步的机构中，存在不同父机构下的同名机构，如“华南”机构下存在子机构名为“江苏省”，“华北”机构下也存在子机构名为“江苏省”，那么配置同步计划时，机构ID必须绑定字段，不能选择“由系统自动生成”方式，否则无法正常同步机构数据。
3、Smartbi系统中的机构ID、机构名称不允许修改，因此机构同步数据中，不能存在修改机构ID和机构名称的情况。若需要修改机构的显示名称，则建议修改机构的别名。
