总述
此文档旨在帮助用户了解并使用苍穹系统中的云之家相关功能，包括云之家参数配置、云之家差异对比、组织和人员同步、聊天功能等。
功能 | 菜单 | 操作前置条件 | 操作结果 |
云之家参数配置 | 系统服务云》基础服务》系统参数 | 取得云之家管理中心权限，获取集成密钥等信息 | 1、完成集成所需配置信息 |
云之家差异对比 | 系统服务云》基础服务》组织管理》云之家差异对比 | 已完成云之家参数配置，且“同步方向”是“从云之家同步组织人员”（该参数是“禁用”时，菜单不可见） | 1、生成云之家和苍穹的组织、人员差异报告 2、同步更新组织、人员的差异信息到苍穹 3、可以单独执行“同步云之家账号”，同步人员EID、UID以及openID（发送云之家消息、工作流消息等必需条件） |
组织同步 | 系统服务云》基础服务》组织管理》行政组织 | 已完成云之家参数配置，且“同步方向”是“同步组织人员至云之家” | 1、同步在云之家新增、修改、封存、移动组织（修改上级） |
人员同步 | 系统服务云》基础服务》人员管理》人员 | 已完成云之家参数配置，且“同步方向”是“同步组织人员至云之家” | 1、同步在云之家新增、修改、删除人员，包括同步修改姓名、工号、兼职、部门负责人、直接上级…… |
聊天（发起沟通） | 无 | 1、安装了云之家客户端 2、人员已通过云之家差异对比或者人员同步了云之家账号信息（openId、UID） 3、发起沟通的本方以及对方，都需要同步云之家账号信息 | 1、弹出云之家客户端，并进入和沟通对象的聊天界面 |
云之家参数配置
一、 配置入口
1. 系统服务云》基础服务》系统参数
2. 系统服务云》配置工具》系统参数
二、 参数修改
1. 修改条件
云之家参数与组织无关，但是因为是集团管控参数，需要选择根组织才能修改
2. 参数说明
1) 云之家系统集成参数（必须）
参数名称 | 必须 | 参数值 | 参数值说明 |
同步方向 | 是 | 禁用 | 禁用时不能修改云之家参数，且不同步云之家数据。 |
从云之家同步组织人员 | 苍穹组织和人员的数据源自云之家，云之家修改数据不会实时同步到苍穹，可以通过【云之家差异对比】工具手工或增加定时任务同步更新。在苍穹对组织和人员的修改，将不会同步更新到云之家。 | ||
同步组织人员至云之家 | 苍穹修改组织或人员数据时，会实时同步更新云之家的数据。 （当前无批量对比、同步更新组织和人员到云之家的功能。需要从云之家管理中心批量导入，再修改参数为“从云之家同步组织人员”后执行云之家差异对比，将云之家的组织ID和人员ID等信息同步到苍穹） | ||
云之家部署模式 | 是 | 公有云 | 此参数无特别的意义，主要是公有云和私有云的云之家地址不同 |
私有云 | |||
云之家地址 | 是 | 公有云 | 全部使用https://www.yunzhijia.com |
私有云 | 客户具体的云之家地址 | ||
工作圈EID | 是 | 云之家“注册EID” | 请填写云之家“管理中心”的“注册EID”（云之家WEB门户>管理中心>团队概况>团队总览>注册EID）。工作圈EID |
只读密钥 | 是 | 请填写云之家“管理中心”的“只读密钥”（云之家WEB门户>管理中心>系统设置>系统集成>只读密钥）。只读密钥 | |
IM服务密钥 | 是 | 请填入云之家“管理中心”的“IM服务”密钥（云之家WEB门户>管理中心>系统设置>系统集成>资源授权>IM服务）。IM服务密钥 | |
系统集成密钥
| 是 | 请从云之家“管理中心”下载旧版系统集成密钥文件，并将文件上传（云之家WEB门户>管理中心>系统设置>系统集成>通讯录同步>旧版系统集成密钥）。系统集成密钥 |
工作圈EID
请填写云之家“管理中心”的“注册EID”（云之家WEB门户>管理中心>团队概况>团队总览>注册EID）。
只读密钥
使用云之家聊天功能时，需要从云之家管理中心获取只读密钥。（云之家WEB门户>管理中心>系统设置>系统集成）
IM服务密钥
系统集成密钥
1. 从云之家管理中心下载系统集成密钥文件。（云之家WEB门户>管理中心>系统设置>系统集成）
2. 引入下载完成的密钥文件
2) 云之家差异对比参数（非必须）
同步模式为【从云之家同步组织人员】时，可以编辑。并且只对【云之家差异对比】功能生效。
参数名称 | 必须 | 参数值 | 参数值说明 |
组织同步时不执行的操作 | 否 | 根据差异报告执行同步时，此参数里选中的操作不执行。如执行差异对比时，在报告里可看到需要“新增”组织到苍穹，此参数勾选了“新增”操作后，执行数据同步时，会忽略该差异，不会新增组织到苍穹 | |
人员同步时不执行的操作 | 否 | 根据差异报告执行同步时，此参数里选中的操作不执行。参照上述组织的参数值说明。 | |
人员同步时不更新的属性 | 否 | 根据差异报告执行同步时，此参数里选中的属性不更新到苍穹。此参数在人员修改时生效，从云之家新增人员时忽略此参数。 | |
自动根据差异报告更新数据到当前系统 | 否 | 是 | 执行“云之家差异对比”调度任务时，根据差异报告自动更新数据到当前系统。 |
否 | 执行“云之家差异对比”调度任务时，只生成差异报告，不会自动更新数据到当前系统。 | ||
自动清理云之家差异对比任务历史数据
| 否 | 是 | 云之家差异对比会生成报告以及备份数据，启用时会在定时任务执行后，自动清理【保留云之家差异对比历史报告天数】之前的历史报告。 |
否 | 不自动清理历史报告 | ||
保留云之家差异对比历史报告天数 | 否 | 默认保留同步报告是100天。历史报告生成时间超过设置时间后，会根据“自动清理云之家差异对比任务历史数据”进行清理。 | |
禁用组织数量超过设定值时，手工处理 | 否 | 为了避免云之家接口返回数据异常、或者网络异常等导致组织被大量封存，故增加此参数。手动/定时执行云之家差异对比时，被禁用/封存的组织超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大
| |
禁用人员数量超过设定值时，手工处理 | 为了避免云之家接口返回数据异常、或者网络异常等导致人员被大量禁用，故增加此参数。手动/定时执行云之家差异对比时，被禁用的人员超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大
|
云之家差异对比
同步方向是“从云之家同步组织人员”时可用。支持从云之家将组织和人员的差异信息更新到苍穹。
一、 云之家差异对比任务列表
操作 | 说明 |
查询 | 从菜单打开后，可看到差异对比任务的卡片视图列表。默认最新执行的任务排在前面。 |
检查差异 | 1、 根据云之家的组织和人员信息，对比苍穹当前的组织和人员信息，生产差异报告 2、 不会自动根据差异报告更新苍穹的数据，需要打开报告手工同步 |
检查差异并同步 | 与“检查差异”操作不同的是，会自动根据差异报告更新苍穹的数据 |
同步云之家账号 | 1、 适用场景：苍穹已存在人员，但是无法用云之家账号登录苍穹，或者无法登录云之家轻应用 2、 对比苍穹人员涉及云之家账号的信息，包括工作圈ID（EID）、云之家UID以及云之家人员公开码（openId） |
删除 | 删除差异对比任务以及相应报告 |
查看配置 | 跳转到云之家参数配置页面 |
查看历史报告 | 查看、搜索差异对比的全部历史报告 |
移除正在执行的标志 | 因为不允许同时执行多个云之家差异对比任务，所以加了正在执行的标志，但是任务异常结束的情况下，此标志在一个小时之后才会被重置。如果需要立即重置该标志，可以打开【更多】按钮，点击【移除正在执行的标志】。 此操作需要谨慎执行，否则有可能导致系统增加重复的组织和人员！！！不建议执行此操作，发现提示任务正在执行时，等待任务结束即可！！！
|
报告链接 | 列表为“卡片视图”时，可以通过双击卡片打开差异报告列表； “列表视图”时，可以通过点击“名称”链接打开差异报告列表 |
二、 云之家差异对比报告列表
操作 | 说明 |
选择同步 | 根据选中的差异信息更新数据到苍穹（选择同步组织时，需保证关联组织被同时选中，如新增组织时，需保证其上级组织也被选中同步） |
一键同步 | 无论是否选中了数据，都会全部更新未同步的数据到苍穹。需谨慎操作。 |
组织架构参照 | 打开“组织架构参照列表” |
按列表引出 | 按照列表字段引出报告内容 |
按模板引出 | 按照模板引出报告内容 |
差异对象链接 | 通过链接可以打开差异对象同步前后的横向对比页面 |
三、 差异对象同步前后对比
四、 组织架构参照列表
支持查看当前任务备份的，云之家、苍穹同步前、同步后的组织和人员信息。
云之家差异对比调度任务（定时任务）
一、 打开调度计划配置页面
二、 新增调度作业
类名编码 | 类名 |
YunzhijiaDiffTask | kd.bos.org.yunzhijia.diff.YunzhijiaDiffTask |
三、 新增调度计划
云之家聊天
一、 人员列表发起聊天
非虚拟账号（如administrator等）可以发起沟通
二、 其他列表发起聊天
基础资料列表包含人员基础资料的字段时，点击相应人员即可发起客户端聊天窗口
三、 列表取消聊天
如果不希望点击人员基础资料字段即发起聊天，需要业务开发在相应应用的列表插件里取消，如下重写chat方法即可
@Override
public void chat(ChatEvent e) {
// 取消云之家聊天
e.setCancel(true);
}
推荐阅读