摘要由AI智能服务提供本文档旨在指导用户了解并使用苍穹系统中的云之家相关功能，包括参数配置、差异对比、组织人员同步及聊天功能。文档详述了操作前置条件、操作结果及具体步骤，如获取集成密钥、生成差异报告、同步更新组织人员信息、聊天功能的使用等，并提供了配置入口、参数修改、差异对比任务及报告管理的详细操作说明。
总述
此文档旨在帮助用户了解并使用苍穹系统中的云之家相关功能，包括云之家参数配置、云之家差异对比、组织和人员同步、聊天功能等。
功能 | 菜单 | 操作前置条件 | 操作结果 |
云之家参数配置 | 系统服务云》基础服务》系统参数 | 取得云之家管理中心权限，获取集成密钥等信息 | 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）。 |
只读密钥 | 是 | 文本 | 请填写云之家“管理中心”的“只读密钥”（云之家WEB门户>管理中心>系统设置>系统集成>只读密钥）。 |
IM服务密钥 | 是 | 文本 | 请填入云之家“管理中心”的“IM服务”密钥（云之家WEB门户>管理中心>系统设置>系统集成>资源授权>IM服务）。 |
系统集成密钥（可编辑密钥）
| 是 | 文本 | 请填写云之家“管理中心”的“可编辑密钥”（云之家WEB门户>管理中心>系统设置>系统集成>通讯录同步>可编辑密钥） |
工作圈EID
请填写云之家“管理中心”的“注册EID”（云之家WEB门户>管理中心>团队概况>团队总览>注册EID）。
只读密钥
使用云之家聊天功能时，需要从云之家管理中心获取只读密钥。（云之家WEB门户>管理中心>系统设置>系统集成）
IM服务密钥
系统集成密钥（可编辑密钥）
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);
}
赞 0
打赏推荐阅读