1.背景

星瀚（苍穹）向企业微信同步组织与人员需要在【企业微信后台应用管理】-【管理工具】-【通讯录同步】里设置可信IP,但是公有云星瀚场景下多租户出口IP可能存在相同，导致企业微信不能保存IP,从而影响组织人员的同步。

2.整体解决方案

在企业微信扫码安装金蝶组织同步和星瀚应用管家两个应用，并扫码将通讯录编辑授权给金蝶的服务商，配置相关信息后，集成云通过服务商中转去调用企业微信的新增组织人员接口。

3.操作步骤

3.1企业微信安装金蝶组织同步

企业微信管理员先扫码安装金蝶组织同步这个应用，刚扫码后会显示开发中，这个需要金蝶服务商配置后才能进行这个金蝶组织同步的设置，可以联系集成服务云-杨发进行配置。（服务商未配置完成，可以先进行下一步的企业微信设置，但是最后集成的时候需要这个金蝶组织同步配置完成并设置好可见范围）

上图中没有了“开发中”，可以点击这个应用后配置可见范围和授权信息，可见范围设置整个公司。

金蝶服务商配置这个金蝶组织同步后，后台会有一个应用密钥。

用户可以提供我的企业-企业id ，服务商（可联系集成服务云-杨发）根据这个明文的企业id拿到加密后的企业id 和金蝶组织同步这个应用密钥，这两个信息用户需要拿到便于后续集成。

3.2企业微信通讯录编辑权限

扫码将通讯录编辑权限授权给金蝶服务商。

授权成功后，通讯录同步显示已授权第三方服务商新增和修改。

3.3企业微信安装星瀚应用管家

具体可以查看社区文档：

https://vip.kingdee.com/knowledge/specialDetail/228892721203874816?category=378139287197786880&id=378146048381841920&productLineId=29

最后需要配置好域名后开启需要集成的数据中心。

配置成功后在星瀚的查询分析器中 可以看到有这个企业id和星瀚应用管家的密钥（版本不同可能所在的表不同）

select * from t_bas_wxqyh tbw ;

select * from t_bas_thirdapps_config tbtc ;

3.4连接配置及资源导入

• 连接配置

服务器ip填写云平台地址，一般是api.kingdee.com

端口可以不用填写

企业微信服务器ip一般是qyapi.weixin.qq.com

企业ID需要是服务商提供的加密后的企业id (向集成服务云提供企业id后生成)

金蝶组织同步应用的密钥需要服务商配置好金蝶组织同步后提供，注意删除应用后重新配置密钥会变化

当前系统账套ID可以在连接配置的列表上找到当前账套信息

星瀚应用管家密钥：通过以下sql在苍穹查询分析器进行查询

版本不同，表可能不同

select fcorpsecret from t_bas_wxqyh tbw ;

select fcorpsecret from t_bas_thirdapps_config tbtc ;

• 资源导入

把企业微信同步的服务流程和自定义api及启动方案导入后，配置好数据源就可以开始组织人员的测试了。

资源清单：

人员初始化是使用启动方案（只能新增）

组织初始化是使用服务流程（只能新增）

组织和人员即时同步是使用了服务流程（包含更新和新增）

组织即时同步需要对服务流程里的信息补充苍穹最顶级部门的编码。

组织同步还是需要扩展行政组织加上wx_id,并同步行政组织这个集成对象。

3.5方案运行

• 组织初始化
  

初始化前需要在开发平台扩展行政组织bos_adminorg的元数据，

加上企业微信组织id字段

字段标识为wx_id 数据表字段为fwx_id

选中服务流程并点击‘发布’。

点击‘立即执行’，输入想要同步苍穹的根组织编码和想要同步到企业微信的根部门ID。

注：苍穹组织同步到企业微信后会将企业微信中对应的部门ID回写到苍穹组织扩展的字段上，但是根节点因为不在同步的范围内，需要手动填写。否则根节点下的人员同步会失败。

• 人员初始化

在启动方案列表页选中人员初始化启动方案，并点击‘启用’和‘运行’，将进行人员的初始化同步。

注：当人员已经初始化以后，再次执行将报错，并提示用户ID已存在。

• 组织即时同步

修改组织即时同步服务流程中节点里苍穹和企业微信的根节点信息。

在服务流程列表页选择组织即时同步的服务流程，并点击‘发布’，此时将监听苍穹中组织的的新增和修改操作。当事件发生时自动执行服务流程，将组织同步到企业微信或更新企业微信中已同步的部门。

注：行政组织保存时如果根据企业微信部门id不为空时在企业微信进行更新，当该字段为空时将进行新增。

• 人员即时同步

在服务流程列表页选择人员即时同步的服务流程，并点击‘发布’，此时将监听苍穹中人员的的新增和修改操作。当事件发生时自动执行服务流程，将人员同步到企业微信或更新企业微信中已同步的人员信息。

注：人员保存时将根据人员的手机号判断进行更新还是新增，如果该手机号在企业微信中已存在对应人员则更新，如果不存在则新增。

• 通知发送配置
  

以下三个服务流程中可以修改通知发送节点，指定消息的接收人，当服务流程执行失败时将接收到错误信息。