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