易快报插件配置手册

数据同步配置

1. 新建易快报应用

管理员登录SSO360平台，【后台管理】-->【应用管理】-->【应用中心】-->【新增应用】

• 域名——易快报环境对应的域名，参考文档https://docs.ekuaibao.com/docs/open-api/getting-started/origin

• appid——易快报平台中添加应有的appid

• appsecret——易快报平台中添加应有的appsecret

填写应用对应的参数和同步参数，然后点击”测试连通“按钮，确保应用连通成功。

2. 添加应用属性

说明：每个插件都会自动内置部分必需属性（内置的属性请勿删除），如果您的插件没有自定义属性，则无需添加，您可以跳过此步骤。

在【应用中心＞应用详情＞属性池】模块添加更多的应用同步的映射属性

3. 创建同步任务

在【应用管理】＞【同步任务】模块，创建下游易快报同步任务，任务配置信息如下：

1）用户属性映射

SSO360字段	字段名	字段类型	SSO360是否必填	易快报	字段名	字段类型	下游是否必填
email	邮箱	string	否	email	邮箱	string	否（手机号和邮箱至少填一个）
phone	手机号	string	否	cellphone	手机	string	否（手机号和邮箱至少填一个）
username	用户名	string	是	name	真实姓名	string	是
status	用户状态	enum	是	active	激活状态	string	否
jobNumber（扩展字段）	工号	string	否	code	工号	string	否

2）组织属性映射

SSO360****字段	SSO360****是否必填	易快报	下游是否必填
orgName	是	name	是
orgCode	否	code	否

4. 应用授权

给要同步的用户添加易快报应用权限

添加方式有两种：

1）直接给用户添加易快报应用权限，在用户列表中，搜索到该用户，进入用户详情进行授权

【后台管理】-->【用户服务管理】-->【用户管理】，查找用户后，点击【查看详情】

【应用信息】-->【添加应用】

勾选【易快报】，【确定】

2）给用户所关联的组织添加易快报应用权限，在【应用授权】模块批量给组织授权

说明：如果某些用户没有授权该应用，则这些应用将无法同步到下游

5. 进行数据同步

1**）增量同步**

a、新增用户或组织同步

• 新创建的用户（用户分类和根组织满足同步任务配置），必须关联有易快报应用权限的组织，进行增量同步时，才能同步成功。

• 新创建的组织（组织分类为默认分类，根组织满足同步任务配置），不用管是否有易快报应用权限，进行增量同步时，都能同步成功。

b、修改或删除用户或组织同步

• 修改或删除用户时（用户分类和根组织满足同步任务配置），用户有易快报应用权限，进行增量同步时，才能同步成功。

• 修改或删除组织时（组织分类为默认分类，根组织满足同步任务配置），不用管是否有易快报应用权限，进行增量同步时，都能同步成功。

2**）全量同步**

• 新增或修改或删除用户（用户分类和根组织满足同步任务配置），用户有易快报应用权限，进行全量同步时，才能同步成功。

• 新增或修改或删除组织（组织分类为默认分类，根组织满足同步任务配置），不用管是否有易快报应用权限，进行全量同步时，都能同步成功。

注意事项：

• 目前idaas中把用户禁用同步到易快报后(在idaas新增禁用用户同步到易快报，会先在易快报新增，再调用停用接口删除)，易快报调用停用用户接口，现象同删除用户一致都是把用户从用户列表删除，故会出现当用户在易快报中有报销流程等情况，idaas禁用或删除用户同步到易快报会失败，用户仍为正常状态的现象（此现象已反馈，待后续优化）

• 目前同步新增或修改用户时，用户的手机号不为空，邮箱为空，会出现同步到易快报的邮箱为空字符串而同步失败的情况（此现象已反馈，待后续优化）

• 目前idaas用户同步到易快报后会自动激活，idaas把禁用用户启用同步到易快报后，易快报也会自动激活用户

6. 验证同步结果

使用你的易快报管理员账号，去易快报后台查看并验证同步数据结果