# WPS协作集成

来源快照：`result_data_new_260518.json`

- 来源 ID：`1206916334648754235`
- 模块：云桥
- 目录：未分组
- space ID：`1159147935877833073`
- 原文链接：未提供
- 产品基线：未提供

## 正文

**WPS协作集成**

#  一、功能背景及价值

目前有不少客户同时使用OA系统和WPS协作进行企业日常办公，为了更好地服务客户满足客户的需求，将我们OA系统的功能接入WPS协作。首先需要在系统：后台管理中心->所有服务->平台引擎->云桥->WPS协作集成，配置集成WPS协作的相关信息。系统支持与WPS协作集成，包括“应用集成到WPS协作”、“消息推送”、“通讯录同步”、“扫码登录”，即实现在WPS协作上使用我们的应用，包括在WPS协作接收系统消息处理待办事宜。通过该功能可增加移动办公便利性、统一通讯录管理、统一消息推送管理。

[点击查看云桥整体介绍](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159148125032554582&space_id=1159147935877833073 "点击查看云桥整体介绍")

# 二、业务流程图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206917399882817541&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

# 三、功能详细说明

## 1.云桥外网地址

     云桥外网地址即EC系统的外网地址，在【云桥】-【基础参数设置】配置当前EC系统的外网地址（例如https://www.oa.com），配置好之后点击保存。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206919006013669393&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**【开通服务器网络权限的说明】**

如果使用本系统进行WPS协作集成功能，则需要调用WPS协作接口，并且最终用户是通过WPS协作来使用集成的功能，所以本系统部署的云桥服务器必须要求，能够访问外网：即开通这台服务器的上网权限，让云桥服务器能够访问互联网，如果贵公司对网络安全要求较高，至少需要让这个服务器能够访问以下地址：  
WPS协作API：https://openapi.wps.cn  
（如果是私有的WPS协作，需要把openapi.wps.cn换成私有WPS协作的服务地址）

同时请网络管理员将本系统的访问地址映射到外网。

可以用如下方式验证网络是否通畅：  
WPS协作（如果是私有的WPS协作，需要把openapi.wps.cn换成私有WPS协作的服务地址测试）  
在云桥服务器上按如下方式检查网络：  
ping openapi.wps.cn 查看是否能ping通  
Windows:  
浏览器访问 https://openapi.wps.cn/v7/users/current 查看是否有返回结果  
Linux:  
执行命令 curl https://openapi.wps.cn/v7/users/current 查看是否有返回结果

正常的返回

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206922450687320076&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 2.企业集成

    WPS协作接入功能主要是在云桥中建立WPS协作接入信息，将基本的企业信息写入云桥中；

①

点击后台管理中心，在所有服务中选择云桥或者平台引擎里点击云桥，即可进入云桥页面，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206922785803821063&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

访问【WPS协作集成】菜单，点击右上角【新建WPS协作】，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206922906026696717&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

输入企业名称，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206925706215350287&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 3.应用集成

### 3.1WPS协作开放平台创建应用

①

请登录[WPS开放平台](https://open.wps.cn/developer/home)，点击【创建应用】，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206927617438048259&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

应用模式选择【企业自建应用】

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206927892416618507&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

创建应用后，即可获取到APPID、APPKEY，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206928395005116430&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

点击应用能力，开启【WPS协作网页应用】，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206929034789838868&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

④

开启通讯录相关权限，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206930297589915660&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤

开启消息与群组相关权限，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206930649647210508&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑥

开启待办相关权限，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206930881673740290&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑦

点击数据权限，配置通讯录权限范围，后续云桥的通讯录同步功能依赖此处的【通讯录权限范围】，不在范围内的无法同步到云桥，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206931611958960139&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.3云桥集成应用

①

访问云桥【WPS协作集成】，在当前集成的WPS协作页面，点击【添加应用】，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206933316861476873&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

进入应用详情页面，填写WPS协作应用的应用名称、APPID、APPKEY【步骤3.1中获取到的应用信息-应用凭证】，配置后点击保存，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206934184420532232&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

应用主页，是设置WPS协作应用的主页功能，调用模块默认为打开应用，选择应用中心已经存在的主页型应用，设置好主页，点击保存：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206937702165692423&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

   或者填写自定义链接的地址：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206936735825584138&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

④

把应用主页地址配置到WPS应用主页地址中，访问[WPS开放平台](https://open.wps.cn/developer/home)，找到对应的应用；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206937281152212992&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206938548305977359&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206939025058390017&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤

设置用户授权回调配置；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206940369391542277&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑥

设置H5可信域名；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206940742900047886&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑦

发布WPS协作应用，填写版本号，版本说明，申请说明；

注意：需要编辑维护应用的可用范围，不在范围内的用户无法使用该应用，设置后点击保存；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206942598472720395&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑧

创建版本后，需要申请发布；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206943672145068044&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑨

登录WPS协作[管理后台](https://work.wps.cn/xz/app/audit)，审核应用；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206944354928254988&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑩

应用审核通过后，需要在WPS协作[管理后台](https://work.wps.cn/xz/app/audit)-安全管控-聊天安全，设置聊天客户端内打开链接域名，填写当前OA系统的域名即可。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1211761912414986252&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.5应用模板

应用模板已经提供了标准的应用，可以通过以下的应用模板快速创建应用，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206944672740597761&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 4.消息推送

    消息通过云桥推送，需要确保【消息推送设置】-【基本设置】-【消息渠道】开启了往云桥推送：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206945038028554243&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 4.1消息规则配置

    消息管理功能主要是将OA应用消息推送到WPS协作中，即实现在WPS协作中接收并处理业务系统的消息。消息正常推送的前提是，WPS协作用户要关联OA系统用户账号。

①

在消息中心找到需要提醒的业务事件，例如流程的待处理流程-提醒 ，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207390430241521668&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

若流程模块的所有提醒都需要推送，可以在流程的总入口配置：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207390477567598595&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

配置推送到云桥的消息推送规则，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207390541925302276&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

③

推送到WPS协作，设置推送目标后保存：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206945368563048456&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    消息类型有：文字、图文、待办，可以根据需求选择相应的消息类型；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206945557661704194&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

④

消息推送规则新建之后，数据会同步到云桥的消息推送规则里，可以点击【设置】按钮，对规则详情进行编辑，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207390606425006082&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207390670782709763&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤

除了在消息中心创建消息推送规则，还可以在云桥创建消息推送规则，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207390748217647106&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207390786902007822&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 4.1.1文字

①

消息推送规则设置，消息类型选择【文字】消息：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206946876275384321&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

文字消息内容默认推送消息标题和详细描述：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206947528966979587&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

#### 4.1.2图文

①

消息推送规则设置，消息类型选择【图文】消息：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206947687958634500&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

云桥上传了图片：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206948031478980610&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

云桥没有上传图片：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206948241981882377&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

④

注意：业务模块有图片，默认优先展示业务图片；若业务模块没有图片，默认展示云桥设置的图片。

 

#### 4.1.4待办

①

消息推送规则设置，消息类型选择【待办】消息：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206948662727467009&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

是否推送提醒：开启推送提醒，会在待办中心发送新待办通知；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206949968526008324&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206949118130872332&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

关闭则不会收到通知，只能在待办中心应用列表里面查看待办：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206949616463691778&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206949719308853255&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

待办消息示例：

   消息到达：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206950144587653122&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    审批后效果：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206950312133320711&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

    消息中心撤回消息、流程强制收回、流程删除、流程退回，按钮状态都会变成待办已删除：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206985367627030536&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

   流程强制结束：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206985663950413830&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

④

**注意事项：**

 

    需要推送待办类型的消息，必须保证推送的消息是【待办规则配置】里系统默认的 ，否则会推送失败。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206986011771461639&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 

## 5.通讯录同步

### 5.1同步功能入口

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206987678231355405&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    云桥组织架构同步分三种：

①

将 WPS协作 的组织架构同步到 云桥（不修改OA的组织架构）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206987802923819013&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

将 WPS协作 的组织结构同步到 云桥 同时同步到OA（修改OA的组织架构）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206989258802946062&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

将OA 的组织架构同步到 云桥，同时同步到 WPS协作（默认在同步前会先执行“从WPS协作同步组织用户绑定关系”，以保证从OA同步的时候正确比对用户和部门信息）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206989477963718657&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 5.2同步功能配置

①

执行同步前，需要已经集成过对应应用；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206989572362264586&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

②

进入【通讯录管理】，未进行过配置，在执行【从WPS协作同步组织用户绑定关系】时，首先会提示配置【接口参数设置】，切换到【接口参数设置】页面，选择集成的应用，点击保存；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206991011209863183&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意：【从WPS协作同步组织用户绑定关系】同步的部门和用户范围，就是 接口参数设置 的 应用 在 WPS协作开放平台-权限管理-数据权限-通讯录权限范围维护的范围！！！不在范围内的无法同步到云桥！！！

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206990822315188258&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

接口权限-只读：只能执行【从WPS协作同步组织用户绑定关系】同步到云桥，不能在云桥通讯录调整数据，一切以企业号的组织架构为准；

④

选择应用：选择同步依赖的应用；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206991324662784005&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤

接口权限-读写：可以执行【从WPS协作同步组织用户绑定关系】同步到云桥，也可以执行【同步通讯录到WPS协作】；

 

#### 5.2.1 从WPS协作同步组织用户绑定关系

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206991870142234627&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

①

同步部门id：如果同步WPS协作所有组织架构，可以不填；如果只同步部分部门，填WPS协作的部门id。

②

是否删除本地未添加用户：云桥存在的用户，在WPS协作中不存在，是否删除云桥本地用户。

③

用户自动绑定：设置本次同步过来的新成员（即云桥中不存在关联关系员）是否要自动建立与OA组织架构中用户的关联关系。具体使用见5.3.1章节

④

用户减少数量阈值：当基础设置【是否删除云桥未添加用户】选择【是】的情况下，此次同步，云桥被删除的未添加用户数量超过阈值200，将不执行删除用户的操作。

⑤

是否定时同步：定时任务，开启可执行定时从WPS协作同步组织架构。

#### 5.2.2是否同步到OA

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206992737912545290&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    是否同步到OA：总开关，决定是否将云桥本地的数据同步到E10组织架构，默认关闭。

   具体可参考：[从云桥同步到E10](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1172472406387802184&space_id=1159147935877833073 "从云桥同步到E10")

#### 5.2.3同步通讯录到WPS协作

①

基本设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206993089938939914&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

顶级部门：执行【同步通讯录到WPS协作】，会将选择的部门以及用户，挂载到选择的顶级部门下面，OA系统的分部/部门跟选择的顶级部门下的部门按层级和名称匹配；如果没选，表示把OA系统的分部/部门直接跟当前云桥通讯录里的部门按层级和名称匹配，当前云桥通讯录第一层部门就应该跟OA系统部门名称一样才能匹配。

是否实时同步到WPS协作：开启实时同步后，e-cology用户字段发生改变，将会自动同步到WPS协作（注意需要执行过【同步通讯录到WPS协作】）。

分部/部门名称类型：是按照OA分部/部门的简称或者全称，匹配、新建、更新WPS协作的部门。

新用户是否添加到WPS协作：设置从OA同步过来的新成员是否要调用WPS协作接口自动创建到WPS协作通讯录中。

用户所在部门是否包含兼职部门：默认只同步用户的主部门，开启时，用户在系统中有兼职部门，并且同步范围设置中包含了该兼职部门，同步后会在WPS协作中用户处于对应的两个部门下；关闭时，同步后在WPS协作中将用户从兼职部门中移除。

用户所在部门是否包含次账号部门：开启时，用户在系统中有次账号部门，并且同步范围设置中包含了该次账号部门，同步后会在WPS协作中用户处于对应的两个部门下；关闭时，同步后在WPS协作中将用户从次账号部门中移除。

用户所在部门是否完全以本系统为准：

当用户在WPS协作端所在的部门存在多个时：例如，用户在WPS协作端在部门A、B下，而在系统端在部门C下，如果选是，同步效果就是该用户在WPS协作端只在部门C下；如果选否，同步效果就是该用户在WPS协作端同时在A、B、C三个部门下；

当用户在WPS协作端所在的部门只有一个时：不受此配置控制，同步效果始终以系统为准。

用户绑定：将OA用户和WPS协作用户关联。详情见 【5.2.4 用户绑定/解绑】

用户字段对应关系：该配置可以将成员在EC系统的里个人信息，同步到成员在WPS协作里的个人信息里。

 

②

范围设置

    系统默认会将系统中的所有部门及用户数据同步到WPS协作的通讯录中，同步范围不需要做任何设置；

 如果有特殊的需要只将一部分部门及用户同步到WPS协作的通讯录中，则可以设置需要同步的部门及用户范围（也可以部门和用户分开设置）；

 不在此范围内的并且已经与系统建立关联关系的部门或用户将会被从WPS协作中删除，并且删除操作不可逆转，所以请谨慎选择范围。

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325908401807374&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

范围类型：默认全量同步，全量更新，不在此范围内的并且已经与系统建立关联关系的部门或用户将会被从WPS协作中删除；增量同步，只更新范围内的用户，不在此范围内的并且已经与系统建立关联关系的部门或用户不会更新，也不会在WPS协作中删除。

分部/部门范围：不选择特定分部/部门，默认为全部。

用户范围（包含）：默认勾选【与分部和部门设置相同】，即同步【分部/部门范围】所选择的部门和部门下的用户，在此范围内的部门和用户将被添加或者更新到WPS协作；

    也可单独设置用户范围，取消勾选【与分部和部门设置相同】，然后根据需要选择需要同步的用户；例如同步部门选择 release，同步用户选择 用户一和 用户二，实现的效果就是将部门 release（不包含该部门下的用户）和 用户一、用户二 同步到WPS协作。不在此范围内的并且已经与系统建立关联关系的部门或用户将会被从WPS协作中禁用或者删除，并且删除操作不可逆转，所以请谨慎选择范围。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325912571772931&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

用户范围（排除）：在此范围内的用户不会被添加到WPS协作，如果用户已关联了WPS协作用户，同步后将被删除，谨慎选择。

 注：用户范围（排除）的优先级高于 用户范围（包含）；例如用户范围（包含）有用户A，用户范围（排除）也有用户A，实现的效果是 同步时排除用户A（即不同步用户A）。

③

安全设置和定时设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325912696774671&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

用户减少数量阈值：本次同步的OA用户数量和上一次相比，减少的数量超过x，将停止同步OA用户信息，x可以自己设置。

定时设置：设置是否开启定时自动执行同步通讯录到WPS协作的操作。

#### 5.2.4 用户绑定/解绑

    将OA用户和WPS协作用户绑定的方式有多种：

①

手动绑定（需要配置应用）

    用户完成应用集成之后，可以直接访问应用，然后输入正确的系统账号密码后，对应集成的WPS协作集成-通讯录管理中会记录用户的WPS协作账号信息以及绑定关系。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325912571772950&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

自动绑定设置

    有三个设置的地方：一个地方配置之后，另外两处也会开启自动同步；修改任意一处，也会变更另外两处的设置。

从WPS协作同步组织用户绑定关系\-->用户自动绑定 （使用见5.3.1）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206994829375528973&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

同步通讯录到WPS协作\-->用户自动绑定（使用见5.3.2）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206995190108184579&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

用户绑定设置\-->用户自动绑定

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206995361940430852&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意：若任意一处开启了关联设置，此时用户访问应用，也可通过关联设置自动关联；

③

关联导入

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206995718397550596&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    将已经同步到云桥本地的数据导出，并且将需要绑定的OA用户的对应字段写入到文档关联字段那一列，上传文档，点击导入按钮，即可将关联关系写入。

    例如：WPS协作用户B要绑定OA用户的B1，选择的关联字段是【手机号】，在导出的B这一栏的关联字段中，填写B1的手机号，保存后将文件再导入，并且关联字段选择【手机号】，然后点击导入按钮即可。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206996616125407238&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

④

用户卡片绑定/解绑

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206996156477653022&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206995989099757570&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤

批量解绑

    解除云桥本地所有用户和OA用户的关联关系；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206996908147261447&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 5.3同步场景说明

    云桥主要是将WPS协作和OA的组织架构关联起来，所以同步前需要确认组织架构以WPS协作端为准，还是以OA端为准！

#### 5.3.1 以WPS协作组织架构为准

    首先执行【从WPS协作同步组织用户绑定关系】，然后把用户在WPS协作中的身份和在OA系统中的身份关联上，使用如下任何一种方式：

    方法一：手动关联（见5.2.4）。

    方法二：在 从WPS协作同步时进行自动关联：需要在【从WPS协作同步组织用户绑定关系】时，开启【用户自动绑定】，配置关联字段之后，进行同步。

    例如：用户在 WPS协作的身份 和OA身份 使用 WPS协作手机 匹配OA系统手机 进行关联。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206997638242197508&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    后续可以在 【从WPS协作同步组织用户绑定关系】时，开启定时同步，每隔一段时间将WPS协作的组织架构的变动更新到云桥。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206998450142011395&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    如果不希望在OA修改组织架构或者在云桥菜单中修改后影响到WPS协作的组织架构，可以开启通讯录的只读模式：只允许WPS协作的修改同步到云桥本地。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206998574655660042&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    是否同步到OA可以参考章节5.2.2；

#### 5.3.2 以OA组织架构为准

    分为两种情况：

5.3.2.1 WPS协作没有组织架构

（默认已经执行过从WPS协作同步组织用户绑定关系）

①

无需进行用户账号绑定。

②

执行【同步通讯录到WPS协作】，执行完成后，云桥会把OA的用户创建到WPS协作，并且自动把用户在WPS协作中的身份和在OA系统中的身份关联上。在创建WPS协作用户时，WPS协作用户的账号是调用WPS接口自动生成的，后续无法修改：

5.3.2.2 WPS协作有组织架构

（默认已经执行过从WPS协作同步组织用户绑定关系）

①

设置WPS协作历史用户（即WPS协作已存在的用户）账号绑定，选择如下任意一种方式进行关联：

    方法一：手动关联（见5.2.4）

   方法二：在 从WPS协作同步时进行自动关联：需要在【从WPS协作同步组织用户绑定关系】时，开启【用户自动绑定】，配置关联字段之后，进行同步。

    例如：用户在 WPS协作的身份 和OA身份 使用 WPS协作手机 匹配OA系统手机 进行关联。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206997638242197508&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    方法三：在执行 同步通讯录到WPS协作的时进行自动关联。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1206999541021761538&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    注：如果自动绑定无法满足将WPS协作用户和OA用户关联，可以在从OA同步前先使用手动绑定关联这些用户。

②

设置顶级部门

    是否设置顶级部门决定了同步后的组织架构；

    部门关联的逻辑是：层级相同且部门名称相同，在执行同步的时候，会自动关联，否则，在云桥和WPS协作新建部门。关联上的部门前面会有一个黑色实心原点，代表已关联；

    举例说明：分为两种情况，没有设置顶级部门和设置了顶级部门；

没有设置顶级部门，默认同步OA整体组织架构

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207000773643821059&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    如下图所示，根据层级和名称首先进行顶级部门匹配，则OA顶级部门【演示部门】去匹配云桥顶级部门【演示部门】，可以匹配。一级部门能够匹配上的只有【部门A】，则其他没有匹配上的部门，会在云桥和WPS协作新建。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325934110687242&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    同步后效果（可以先同步模拟同步查看效果）：橘色为匹配，紫色为新增；

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325934256324617&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    注：如果顶级部门的名称不相同，例如【Re部门】和【演示部门】名称不同，则顶级部门无法匹配，同步立刻中止。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325934263885839&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    提示如下：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325934256324630&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

设置了顶级部门，默认同步OA整体组织架构。选定【其他部门】为此次同步的顶级部门：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207001469589446664&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    如图所示，组织架构层级对应如下：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325938360451080&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    执行同步，会将OA【Re部门】及其下级部门，同步到云桥【其他部门】下，作为顶级部门。

    根据部门匹配的原则，OA一级部门【Re部门】和顶级部门下的一级部门没有名称相同的，直接新建。

    同步效果如图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325938374303763&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 5.3.3 其他注意事项

①

当WPS协作的组织架构发生变化之后，需要在执行【同步通讯录到WPS协作】之前，先执行【从WPS协作同步组织结构绑定关系】。

②

如果该WPS协作用户已经关联OA的账号，那么从OA同步的时候，用户匹配字段的配置将不会修改原有的绑定关系，该配置只针对未关联OA的WPS协作用户。

③

接口参数设置，如果设置了只读权限，所有在云桥对组织架构进行的操作（不包括用户手动关联用户），都不能操作。

## 

## 6.扫码登录

    此功能主要实现通过WPS协作自带的扫一扫功能扫描OA系统首页的二维码进行登录OA系统，具体位置如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207003247634604044&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    如果在未集成WPS协作和应用的情况下，直接点击后面的【设置】按钮，会提示“请先添加WPS协作”，故配置扫码登录功能前，请先集成WPS协作和应用，参考手册第2、3点【2.企业集成、3.应用集成】。

①

点击扫码登录功能后面的【设置】按钮，进入配置页面，先点击开启按钮，再选择集成的应用后保存，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207003385006448647&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

打开OA系统登录首页，扫码入口在右上角，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207004020699357189&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

使用手机端WPS协作自带的扫一扫功能，扫OA系统登录首页二维码，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207003913431859206&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

④

扫完之后，需要选择租户（也就是团队名称）及集成的企业名称，如下图所示：

**     此处需要注意：**

**当人员处于单租户及单企业的情况下，扫描之后可直接登录****OA****系统。**

**当人员处于多租户或多企业情况之下才需要选择租户或选择企业。**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207010424610668547&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

**设置为默认表示扫码登录的时候登录当前组织，无需二次选择需要登录的组织以及第三方企业，始终是用当前企业的身份登录当前租户。**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207010609128857612&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤

选择完企业之后，如果人员在集成企业的通讯录里无关联关系且未开启自动关联，则会跳转到绑定账号的页面：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207010810950377476&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163325959826898961&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑥

需要人员建立了关联关系后才可正常登录oa系统，具体建立关联的操作方法可参考此文档【5.2.4用户绑定/解绑】中的①手动绑定②自动绑定设置（开启了关联设置，此时用户访问应用，也可通过关联设置自动关联）④用户卡片绑定；扫码选择完企业后，若建立了关联关系，就能正常登录oa系统页面，效果如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1207011326300315653&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 

# 四、更多场景示例

暂无

# 五、上下游关联功能点

暂无

# 六、注意点

见第五点功能详细说明的红字标注
