# 云之家同步帮助文档

# 总述

此文档旨在帮助用户了解并使用苍穹系统中的云之家相关功能，包括云之家参数配置、云之家差异对比、组织和人员同步、聊天功能等，以及提供部分常见问题的解决方案（QA）。

苍穹启用云之家相关功能，需要配置以下信息：

Ø 苍穹管理中心（MC）

Ø 苍穹系统参数

# 名词释义

| **名词**           | **释义**                                                     |
| ------------------ | ------------------------------------------------------------ |
| **云之家管理中心** | 云之家的WEB门户，工作圈的管理员可以登录                      |
| **苍穹管理中心**   | 常说的租户管理中心、MC，包含租户管理、数据中心管理、环境配置等功能；由运维人员管理，当前苍穹运维总接口人：**王有庆****(**工号39247**)** |
| **苍穹系统参数**   | 指苍穹单个数据中心的系统参数                                 |
| **人员公开码**     | 即openId，是云之家提供给外部系统的人员识别编码，可用于登录账号的校验 |

 

# 苍穹管理中心（MC）配置

### 公共配置

需要配置云之家创建群聊接口的URI：

参数名：YunZhiJiaCreateGroupURL

参数值：/linkspace/open/imsdk/group/create

![img](images/clip_image002.jpg)

# 云之家参数配置

## 苍穹系统参数配置

### 打开系统参数配置页面

![img](images/clip_image004.jpg)

![img](images/clip_image006.jpg)

### 修改云之家参数

#### 组织

云之家参数与组织无关，但是因为是集团管控参数，需要选择根组织才能修改

![img](images/clip_image008.jpg)

#### 云之家同步模式

Ø 禁用

禁用时不能修改云之家参数

Ø 启用

启用分为两种模式：

**1.** **苍穹从云之家同步组织人员**

苍穹组织和人员的数据源自云之家，云之家修改数据不会实时同步到苍穹，可以通过【云之家差异对比】工具手工或增加定时任务同步更新。在苍穹对组织和人员的修改，将不会同步更新到云之家。

**2.** **苍穹同步组织人员至云之家**

苍穹修改组织或人员数据时，会实时同步更新云之家的数据。

当前无批量对比、同步更新组织和人员到云之家的功能。

#### 云之家部署模式

此参数无特别的意义，主要是公有云和私有云的云之家地址不同

Ø 公有云

Ø 私有云

 

#### 云之家地址

对应MC的通讯地址。默认为公有云的地址：https://www.yunzhijia.com

#### 工作圈EID

和云之家管理中心的团队EID一致。（云之家WEB门户>管理中心>团队>团队概况）

![img](images/clip_image010.jpg)

#### 只读密钥

使用云之家聊天功能时，需要从云之家管理中心获取只读密钥。（云之家WEB门户>管理中心>系统设置>系统集成）

![img](images/clip_image012.jpg)

#### 系统集成密钥

\1.  从云之家管理中心下载系统集成密钥文件。（云之家WEB门户>管理中心>系统设置>系统集成）

![img](images/clip_image014.jpg)

 

\2.  引入下载完成的密钥文件

![img](images/clip_image016.jpg)

#### 云之家差异对比参数

同步模式为【苍穹从云之家同步组织人员】时，可以编辑。

只对【云之家差异对比】功能生效

![img](images/clip_image018.jpg)

Ø 自动更新云之家数据到当前系统

手动/定时执行云之家差异对比时，启用状态下会根据差异报告自动更新苍穹的组织、人员信息；禁用状态下，只生成差异报告，不会更新苍穹的数据

Ø 自动清理云之家差异对比任务历史数据

云之家差异对比会生成报告以及备份数据，启用时会在定时任务执行后，自动清理【保留云之家差异对比历史报告天数】之前的历史报告。

Ø 保留云之家差异对比历史报告天数

默认保留同步报告是100天

Ø 禁用组织数量超过设定值时，手工处理

为了避免云之家接口返回数据异常、或者网络异常等导致组织被大量封存，故增加此参数。手动/定时执行云之家差异对比时，被禁用/封存的组织超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大

Ø 禁用人员数量超过设定值时，手工处理

为了避免云之家接口返回数据异常、或者网络异常等导致人员被大量禁用，故增加此参数。手动/定时执行云之家差异对比时，被禁用的人员超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大

 

# 云之家差异对比

同步模式是【苍穹从云之家同步组织人员】时可用。支持从云之家将组织和人员的差异信息更新到苍穹。

## 打开云之家差异对比页面

![img](images/clip_image020.jpg)

![img](images/clip_image022.jpg)

## 打开云之家差异对比报告

双击卡片打开云之家差异对比报告

![img](images/clip_image024.jpg)

## 根据差异报告手工同步更新

Ø 只有最新的差异报告，并且存在未同步的差异信息时，同步按钮才可用，否则会被锁定

Ø 选择同步

根据选中的差异信息更新数据到苍穹

Ø 一键同步

无论是否选中了数据，都会全部更新未同步的数据到苍穹

![img](images/clip_image026.jpg)

## 检查差异

Ø 根据云之家的组织和人员信息，对比苍穹当前的组织和人员信息，生产差异报

Ø 不会自动根据差异报告更新苍穹的数据，需要打开报告手工同步

## 检查差异并同步

Ø 与【检查差异】按钮不同的是，会自动根据差异报告更新苍穹的数据

## 同步云之家账号

Ø 适用场景：苍穹已存在人员，但是无法用云之家账号登录苍穹，或者无法登录云之家轻应用

Ø 对比苍穹人员涉及云之家账号的信息，包括工作圈ID（EID）、云之家UID以及云之家人员公开码（openId）

## 查看配置

打开【更多】按钮，点击【查看配置】，可以跳转到系统参数配置页面。选择系统云的基础服务的树节点就可以查看云之家配置信息。

![img](images/clip_image028.jpg)

 

## 查看历史报告

打开【更多】按钮，点击【查看历史报告】，可以查看差异对比的历史报告，不包括删除的报告

![img](images/clip_image030.jpg)

## 移除正在执行的标志

因为不允许同时执行多个云之家差异对比任务，所以加了正在执行的标志，但是任务异常结束的情况下，此标志在一个小时之后才会被重置。如果需要立即重置该标志，可以打开【更多】按钮，点击【移除正在执行的标志】。

**此操作需要谨慎执行，否则有可能导致系统增加重复的组织和人员！！！不建议执行此操作，发现提示任务正在执行时，等待任务结束即可！！！**

![img](images/clip_image032.jpg)

 

# 云之家差异对比调度任务（定时任务）

## 打开调度计划配置页面

![img](images/clip_image034.jpg)

## 新增调度作业

![img](images/clip_image036.jpg)

类名编码：YunzhijiaDiffTask

类名：kd.bos.org.yunzhijia.diff.YunzhijiaDiffTask

 

 

## 新增调度计划

![img](images/clip_image038.jpg)

# 云之家聊天

## 必备条件

Ø 安装了新版的云之家客户端

Ø 苍穹管理中心（MC）配置了云之家信息

Ø 系统启用了云之家，并在系统参数配置了【只读密钥】

Ø 已同步了用户的云之家账号信息（openId、UID）

## 人员列表发起聊天

非虚拟账号（如administrator等）可以发起沟通

![img](images/clip_image040.jpg)

## 其他列表发起聊天

基础资料列表包含人员基础资料的字段时，点击相应人员即可发起客户端聊天窗口

![img](images/clip_image042.jpg)

## 列表取消聊天

如果不希望点击人员基础资料字段即发起聊天，需要业务开发在相应应用的列表插件里取消。

![说明: https://www.yunzhijia.com/docrest/file/downloadfile/5ddfad0d28011f0fc4af559b?big](file:///C:\Users\RD_BIB~1\AppData\Local\Temp\msohtmlclip1\01\clip_image043.png)

@Override

  public void chat(ChatEvent e) {

​    System.err.println("setFilter");

​    // 取消云之家聊天

​    e.setCancel(true);

​    super.chat(e);

}

 

# QA

## Q1无法使用云之家账号登录苍穹系统

A：

\1.  可能是未在苍穹新增该用户，可进入人员列表新增

\2.  可能是登录用户未同步云之家账号信息，执行云之家差异对比的【同步云之家账号】之后重试

## Q2登录云之家轻应用提示“您的账号在系统中不存在”

![img](images/clip_image044.png)

A: 参照Q1

## Q3流程助手无法接收待办消息

A: 参照Q1

## Q4获取云之家工作圈信息失败

![img](images/clip_image046.jpg)

A：

\1.  需要参照【云之家配置】进行配置

\2.  已配置还提示上述信息，则需要重新发布或重启苍穹微服务

## Q5解析云之家配置信息失败

![img](images/clip_image048.jpg)

A：

\1.  可能是管理中心（MC）配置的密钥不正确，需要参照上述帮助文档，配置并重新发布后重试

 

## Q6新增/修改组织、人员提示：云之家新增/修改失败

![img](images/clip_image050.jpg)

A：

\1.  可能是网络连接问题，可以重复保存验证

\2.  可能是云之家的组织架构已经被调整，但是未同步到苍穹，导致系统间数据不一致。可以将云之家参数修改为【苍穹从云之家同步组织人员】，执行云之家差异对比，根据差异报告做相应调整。完成对比后，恢复云之家参数设置。

## Q7为什么看不到“云之家差异对比”菜单？

A：

\1.  系统的云之家参数为“禁用”时，该菜单不可见