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