云之家（苍穹-云之家）集成使用手册

注意：该方案已做过DEMO验证，客户现场需要根据实际情况进行必要的调整，并且无论是否调整都必须再次验证才可使用。

变更记录

产品版本	更新内容	更新日期
V5.0.017	初始版本	2021年01月07日
V5.0.017	优化了云之家集成方案获取方式的说明	2023年03月23日

1. 操作前准备

集成方案获取：

需要先通过集成管理解决方案中心获取云端最新方案，操作路径：【集成管理】→【方案中心】→【解决方案】；

解决方案详细说明请参考：https://vip-admin.kingdee.com/article/240792533016257280

1.1云之家连接配置

1.1.1企业ID及通讯录同步密钥

上述内容请在云之家所建团队中查询，具体路径为：

企业ID：团队概况->团队总览->注册EID

通讯录同步密钥：系统设置->系统集成->可编辑密钥

1.1.2设置对应数据源

将上述连接配置作为导入服务流程中所对应的云之家所对应数据源的连接配置

2. 服务流程解析

2.1组织初始化

2.1.1节点解析

可以通过修改“数据获取节点”中过滤条件，例如仅过滤长编码以“00!Org-00022”开头的，具体信息可以去对应组织结构表中查询T_ORG_STRUCTURE@BASEDATA，

查询方式如下，通过组织编码（fnumber）到t_org_org表中搜索相应组织主键（fid），再通过查询出的组织（id）到T_ORG_STRUCTURE表中通过搜索相应组织长编码（flongnumber）；

格式如下：

select fid from t_org_org where fnumber =' aaa ';

select flongnumber from T_ORG_STRUCTURE where forgid ='???';

注意：

1. 预置的标准方案默认同步“非封存的行政组织”单元，请不要修改“fviewid = 1（行政组织视图）”及“fisfreeze = 0（非封存）”条件。

2. 预置服务流程数据获取节点开头已默认为“//”,请针对不同需求进行实际修改；

3. 请修改预置流程通知节点中对应消息接收人。

对应最新的行政组织长名称，存在于多语言表中，因此需要通过脚本查询最新的长名称，如下：

var sql = "SELECT ffullname FROM T_ORG_STRUCTURE_L@BASEDATA WHERE fid = ? and flocaleid = 'zh_CN'";

var ffullname = query_value (tar, sql, [ORG_ID_LIST[i]], [BIGINT]);

其余即为循环逐条同步，同步成功则会在ID映射表中新建对应的源/目标ID映射关系，其中调用了通过长名称查询云之家组织ID的接口（通过集成云外部系统API实现）

将流程发布后即可立即执行，实现组织同步初始化（苍穹-云之家）

执行后可在流程实例变量中查看各信息：

2.2组织即时同步

2.2.1节点解析

通过orgId查询组织结构表中主键fid及长名称ffullname

var sql = "SELECT fid FROM T_ORG_STRUCTURE@BASEDATA WHERE forgid = ? and fviewid = 1 and fisfreeze = 0";

FID = query_value (tar, sql, [DDBF[0].id], [BIGINT]);

var sql = "SELECT ffullname FROM T_ORG_STRUCTURE_L@BASEDATA WHERE fid = ? and flocaleid = 'zh_CN'";

FFULLNAME = query_value (tar, sql, [FID], [BIGINT]);

通过源单ID去“云之家组织ID映射表列表中查询对应云之家组织ID，存在则更新即可，不存在则走新建接口；

对应更新操作接口实现：

2.3人员初始化及即时同步

2.3.1节点解析

通过源系统人员信息，构造云之家新增人员接口所需内容（目前云之家接口可能有问题，邮箱不能正常同步，经反馈得知不支持同时传手机号及邮箱，如有类似需求，请联系云之家相应人员询问）

注意：

1. 目前预置人员初始化服务流程中，数据获取节点已设置过滤条件为固定值请修改为现场实际值，全量同步请删除对应过滤条件；

2. 目前预置流程中，人员职位只会同步苍穹人员部门信息分录的首行中的职位信息，针对客户不同需求可以通过修改对应脚本来取特定条件分录，脚本修改可以联系集成服务云部门；

3. 请修改预置流程通知节点中对应消息接收人。

集成服务云使用指南：https://club.kdcloud.com/article/45312

集成服务云新特性发布汇总：https://club.kdcloud.com/article/146134

集成云常见问题处理合集: https://vip.kingdee.com/article/45556

云之家（苍穹-云之家）集成使用手册

云之家（苍穹-云之家）集成使用手册

恭喜您！