④内部公开请勿外传云之家同步帮助文档文档密级内部公开归属部门/项目苍穹子系统名基础服务模块名云之家同步编写人黎伟波编写日期2019-11-11金蝶软件（中国）有限公司版权所有内部资料注意保密修订记录：版本号修订人修订日期修订描述V1.0.0黎伟波2019-11-11创建初稿。V2.0.0黎伟波2019-12-31云之家相关配置迁移到苍穹的系统参数应用下管理。执行云之家同步可以不再需要在租户管理中心（MC）配置云之家信息。1/38④内部公开请勿外传目录云之家同步帮助文档...............................................................................................................................1总述...........................................................................................................................................................4名词释义...................................................................................................................................................4云之家参数配置.......................................................................................................................................4苍穹管理中心（MC）配置..............................................................................................................4打开管理中心的租户管理功能................................................................................................5打开/创建相应租户..................................................................................................................6打开/新建相应的数据中心......................................................................................................7配置相应的云之家信息............................................................................................................8公共配置.................................................................................................................................11配置生效.................................................................................................................................11苍穹系统参数配置.........................................................................................................................13打开系统参数配置页面..........................................................................................................13修改云之家参数......................................................................................................................14云之家差异对比.....................................................................................................................................17打开云之家差异对比页面..............................................................................................................17打开云之家差异对比报告..............................................................................................................18根据差异报告手工同步更新..........................................................................................................19检查差异.........................................................................................................................................19检查差异并同步.............................................................................................................................19同步云之家账号.............................................................................................................................20查看配置.........................................................................................................................................20查看历史报告.................................................................................................................................21移除正在执行的标志......................................................................................................................22云之家差异对比调度任务（定时任务）..............................................................................................23打开调度计划配置页面..................................................................................................................23新增调度作业.................................................................................................................................24新增调度计划.................................................................................................................................25云之家聊天.............................................................................................................................................25必备条件.........................................................................................................................................25人员列表发起聊天.........................................................................................................................25其他列表发起聊天.........................................................................................................................26列表取消聊天.................................................................................................................................27QA............................................................................................................................................................27Q1无法使用云之家账号登录苍穹系统........................................................................................27Q2登录云之家轻应用提示“您的账号在系统中不存在”.........................................................28Q3流程助手无法接收待办消息....................................................................................................28Q4获取云之家工作圈信息失败....................................................................................................28Q5解析云之家配置信息失败........................................................................................................292/38④内部公开请勿外传Q6新增/修改组织、人员提示：云之家新增/修改失败.............................................................29Q7为什么看不到“云之家差异对比”菜单？............................................................................29总述此文档旨在帮助用户了解并使用苍穹系统中的云之家相关功能，包括云之家参数配置、云之家差异对比、组织和人员同步、聊天功能等，以及提供部分常见问题的解决方案（QA）。苍穹启用云之家相关功能，需要配置以下信息：苍穹管理中心（MC）苍穹系统参数名词释义名词释义云之家管理中心云之家的WEB门户，工作圈的管理员可以登录苍穹管理中心常说的租户管理中心、MC，包含租户管理、数据中心管理、环境配置等功能；由运维人员管理，当前苍穹运维总接口人：王有庆(工号39247)苍穹系统参数指苍穹单个数据中心的系统参数人员公开码即openId，是云之家提供给外部系统的人员识别编码，可用于登录账号的校验V1.0.0云之家参数配置苍穹管理中心（MC）配置主要配置云之家的部署方案，包括私有云、公有云等；租户的云之家工作圈信息3/38④内部公开请勿外传需要找有权限的运维人员执行配置打开管理中心的租户管理功能4/38④内部公开请勿外传打开/创建相应租户5/38④内部公开请勿外传打开/新建相应的数据中心6/38④内部公开请勿外传配置相应的云之家信息部署方式分为启用、公有云、私有云。配置方式共享即共享其他数据中心的云之家工作圈注册注册已创建的云之家工作圈信息新建适用云之家工作圈未创建的场景，可以实时在云之家创建新的工作圈工作圈名对应云之家管理中心的团队名7/38④内部公开请勿外传工作圈ID对应云之家的团队EID8/38④内部公开请勿外传Key文件从工作圈的管理中心获取9/38④内部公开请勿外传通讯地址公有云的通讯地址都是：https://www.yunzhijia.com私有云的地址根据客户实际的云之家私有云地址配置登录方式支持选择云之家账号、苍穹账号等登录方式同步数据打开【同步数据】开关时，保存后会根据配置的云之家信息，从云之家同步组织和人员到苍穹如果已执行过同步，该开关将被锁定旧的数据中心可能被未锁定，为避免组织和人员数据被覆盖，已执行过同步的数据中心，需要关闭【同步数据】开关。系统会判断组织和人员历史表没有数据才可以执行同步。10/38④内部公开请勿外传公共配置需要配置云之家创建群聊接口的URI：参数名：YunZhiJiaCreateGroupURL参数值：/linkspace/open/imsdk/group/create配置生效新增/修改云之家信息后不会立即生效，需要选择以下处理11/38④内部公开请勿外传集群管理重新发布：不影响系统使用12/38④内部公开请勿外传重启苍穹微服务：不建议；需要停机，影响用户使用苍穹系统参数配置MC的云之家信息配置生效之后，可以根据客户实际需求，修改苍穹的系统参数打开系统参数配置页面13/38④内部公开请勿外传修改云之家参数组织云之家参数与组织无关，但是因为是集团管控参数，需要选择根组织才能修改14/38④内部公开请勿外传云之家同步模式禁用禁用时不能修改云之家参数启用启用分为两种模式：1.苍穹从云之家同步组织人员苍穹组织和人员的数据源自云之家，云之家修改数据不会实时同步到苍穹，可以通过【云之家差异对比】工具手工或增加定时任务同步更新。在苍穹对组织和人员的修改，将不会同步更新到云之家。2.苍穹同步组织人员至云之家苍穹修改组织或人员数据时，会实时同步更新云之家的数据。当前无批量对比、同步更新组织和人员到云之家的功能。云之家地址对应MC的通讯地址。默认为公有云的地址：https://www.yunzhijia.com15/38④内部公开请勿外传只读密钥使用云之家聊天功能时，需要从云之家的管理中心获取并配置云之家差异对比参数同步模式为【苍穹从云之家同步组织人员】时，可以编辑。只对【云之家差异对比】功能生效自动更新云之家数据到当前系统手动/定时执行云之家差异对比时，启用状态下会根据差异报告自动更新苍穹的组织、人员16/38④内部公开请勿外传信息；禁用状态下，只生成差异报告，不会更新苍穹的数据自动清理云之家差异对比任务历史数据云之家差异对比会生成报告以及备份数据，启用时会在定时任务执行后，自动清理【保留云之家差异对比历史报告天数】之前的历史报告。保留云之家差异对比历史报告天数默认保留同步报告是100天禁用组织数量超过设定值时，手工处理为了避免云之家接口返回数据异常、或者网络异常等导致组织被大量封存，故增加此参数。手动/定时执行云之家差异对比时，被禁用/封存的组织超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大禁用人员数量超过设定值时，手工处理为了避免云之家接口返回数据异常、或者网络异常等导致人员被大量禁用，故增加此参数。手动/定时执行云之家差异对比时，被禁用的人员超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大17/38④内部公开请勿外传V2.0.0云之家参数配置苍穹系统参数配置打开系统参数配置页面18/38④内部公开请勿外传修改云之家参数组织云之家参数与组织无关，但是因为是集团管控参数，需要选择根组织才能修改19/38④内部公开请勿外传云之家同步模式禁用禁用时不能修改云之家参数启用启用分为两种模式：1.苍穹从云之家同步组织人员苍穹组织和人员的数据源自云之家，云之家修改数据不会实时同步到苍穹，可以通过【云之家差异对比】工具手工或增加定时任务同步更新。在苍穹对组织和人员的修改，将不会同步更新到云之家。2.苍穹同步组织人员至云之家苍穹修改组织或人员数据时，会实时同步更新云之家的数据。当前无批量对比、同步更新组织和人员到云之家的功能。云之家部署模式此参数无特别的意义，主要是公有云和私有云的云之家地址不同20/38④内部公开请勿外传公有云私有云云之家地址对应MC的通讯地址。默认为公有云的地址：https://www.yunzhijia.com工作圈EID和云之家管理中心的团队EID一致。（云之家WEB门户>管理中心>团队>团队概况）只读密钥使用云之家聊天功能时，需要从云之家管理中心获取只读密钥。（云之家WEB门户>管理中心>系统设置>系统集成）21/38④内部公开请勿外传系统集成密钥1.从云之家管理中心下载系统集成密钥文件。（云之家WEB门户>管理中心>系统设置>系统集成）22/38④内部公开请勿外传2.引入下载完成的密钥文件23/38④内部公开请勿外传云之家差异对比参数同步模式为【苍穹从云之家同步组织人员】时，可以编辑。只对【云之家差异对比】功能生效自动更新云之家数据到当前系统手动/定时执行云之家差异对比时，启用状态下会根据差异报告自动更新苍穹的组织、人员信息；禁用状态下，只生成差异报告，不会更新苍穹的数据自动清理云之家差异对比任务历史数据云之家差异对比会生成报告以及备份数据，启用时会在定时任务执行后，自动清理【保留云之家差异对比历史报告天数】之前的历史报告。保留云之家差异对比历史报告天数默认保留同步报告是100天禁用组织数量超过设定值时，手工处理为了避免云之家接口返回数据异常、或者网络异常等导致组织被大量封存，故增加此参数。手动/定时执行云之家差异对比时，被禁用/封存的组织超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大禁用人员数量超过设定值时，手工处理为了避免云之家接口返回数据异常、或者网络异常等导致人员被大量禁用，故增加此参数。手动/定时执行云之家差异对比时，被禁用的人员超过此参数设置时，不会更新苍穹的数据，需要人工打开同步报告确认后，手工执行一键同步。如果觉得没必要人工确认，可见将参数范围设置更大云之家差异对比同步模式是【苍穹从云之家同步组织人员】时可用。支持从云之家将组织和人员的差异信息更新到苍穹。24/38④内部公开请勿外传打开云之家差异对比页面25/38④内部公开请勿外传打开云之家差异对比报告双击卡片打开云之家差异对比报告根据差异报告手工同步更新只有最新的差异报告，并且存在未同步的差异信息时，同步按钮才可用，否则会被锁定选择同步根据选中的差异信息更新数据到苍穹一键同步无论是否选中了数据，都会全部更新未同步的数据到苍穹26/38④内部公开请勿外传检查差异根据云之家的组织和人员信息，对比苍穹当前的组织和人员信息，生产差异报不会自动根据差异报告更新苍穹的数据，需要打开报告手工同步检查差异并同步与【检查差异】按钮不同的是，会自动根据差异报告更新苍穹的数据同步云之家账号适用场景：苍穹已存在人员，但是无法用云之家账号登录苍穹，或者无法登录云之家轻应用对比苍穹人员涉及云之家账号的信息，包括工作圈ID（EID）、云之家UID以及云之家人员公开码（openId）27/38④内部公开请勿外传查看配置打开【更多】按钮，点击【查看配置】，可以跳转到系统参数配置页面。选择系统云的基础服务的树节点就可以查看云之家配置信息。查看历史报告打开【更多】按钮，点击【查看历史报告】，可以查看差异对比的历史报告，不包括删除的报告28/38④内部公开请勿外传移除正在执行的标志因为不允许同时执行多个云之家差异对比任务，所以加了正在执行的标志，但是任务异常结束的情况下，此标志在一个小时之后才会被重置。如果需要立即重置该标志，可以打开【更多】按钮，点击【移除正在执行的标志】。此操作需要谨慎执行，否则有可能导致系统增加重复的组织和人员！！！不建议执行此操作，发现提示任务正在执行时，等待任务结束即可！！！29/38④内部公开请勿外传30/38④内部公开请勿外传云之家差异对比调度任务（定时任务）打开调度计划配置页面31/38④内部公开请勿外传新增调度作业类名编码：YunzhijiaDiffTask类名：kd.bos.org.yunzhijia.diff.YunzhijiaDiffTask32/38④内部公开请勿外传新增调度计划云之家聊天必备条件安装了新版的云之家客户端苍穹管理中心（MC）配置了云之家信息系统启用了云之家，并在系统参数配置了【只读密钥】已同步了用户的云之家账号信息（openId、UID）人员列表发起聊天非虚拟账号（如administrator等）可以发起沟通33/38④内部公开请勿外传其他列表发起聊天基础资料列表包含人员基础资料的字段时，点击相应人员即可发起客户端聊天窗口34/38④内部公开请勿外传列表取消聊天如果不希望点击人员基础资料字段即发起聊天，需要业务开发在相应应用的列表插件里取消。@Overridepublicvoidchat(ChatEvente){System.err.println("setFilter");//取消云之家聊天35/38④内部公开请勿外传e.setCancel(true);super.chat(e);}QAQ1无法使用云之家账号登录苍穹系统A：1.可能是未在苍穹新增该用户，可进入人员列表新增2.可能是登录用户未同步云之家账号信息，执行云之家差异对比的【同步云之家账号】之后重试Q2登录云之家轻应用提示“您的账号在系统中不存在”A:参照Q1Q3流程助手无法接收待办消息A:参照Q136/38④内部公开请勿外传Q4获取云之家工作圈信息失败A：1.需要参照【云之家配置】进行配置2.已配置还提示上述信息，则需要重新发布或重启苍穹微服务Q5解析云之家配置信息失败A：1.可能是管理中心（MC）配置的密钥不正确，需要参照上述帮助文档，配置并重新发布后重试37/38④内部公开请勿外传Q6新增/修改组织、人员提示：云之家新增/修改失败A：1.可能是网络连接问题，可以重复保存验证2.可能是云之家的组织架构已经被调整，但是未同步到苍穹，导致系统间数据不一致。可以将云之家参数修改为【苍穹从云之家同步组织人员】，执行云之家差异对比，根据差异报告做相应调整。完成对比后，恢复云之家参数设置。Q7为什么看不到“云之家差异对比”菜单？A：1.系统的云之家参数为“禁用”时，该菜单不可见38/38
