一、概述
支持将系统应用集成到welink上使用，包括“通讯录同步”“应用集成到welink"”消息互通“。
二、操作说明
【开通服务器网络权限的说明】
1.如果使用本系统进行公众号集成功能，则需要调用公众号接口，并且最终用户是通过公众号来使用集成的功能，所以本系统部署的云桥服务器必须要求，能够访问外网：即开通这台服务器的上网权限，让云桥服务器能够访问互联网，如果贵公司对网络安全要求较高，至少需要让这个服务器能够访问以下地址：
WelinkAPI：https://open.welink.huaweicloud.com
2.同时请网络管理员将本系统的访问地址映射到外网。
3.可以用如下方式验证网络是否通畅：
在云桥服务器上按如下方式检查网络：
ping open.welink.huaweicloud.com 查看是否能ping通
Windows:
浏览器访问 https://open.welink.huaweicloud.com/api/auth/v2/tickets 查看是否有返回结果
Linux:
执行命令 curl https://open.welink.huaweicloud.com/api/auth/v2/tickets 查看是否有返回结果
请登录Welink开放平台https://open.welink.huaweicloud.com，进入菜单【应用开发】-【轻应用】-【创建轻应用】，选择/上传应用图标，输入应用的中文和英文名称之后，点击【提交】，如下图所示：
应用创建之后点击【基本信息】，即可获取到应用的client_id和client_secret，如下图所示：
访问云桥【Welink集成】，在当前集成的Welink企业页面，点击【添加应用】，如下图所示：
进入应用详情页面，填写Welink应用的client_id和client_secret【步骤2中获取到的应用信息】，如下图：
应用主页 是设置Welink应用的主页功能，调用模块默认为打开应用，选择应用中心已经存在的主页型应用，如下图所示：
也支持自定义链接，如下图所示：
点击应用主页地址后面的复制按钮，到Welink开放平台【开发指引】-【应用开发】-【设置首页地址】，点击前往设置，如下图所示：
将复制的链接，填到手机端和PC端，点击确定。
访问Welink开放平台菜单【开发指引】-【开发准备】-【申请应用权限】点击右侧申请权限，设置应用的权限（具体见 文章2.2章）
访问Welink开放平台【版本管理】点击发布版本，选择管理员进行审核，点击确定，发布应用到Wlink，如下图：
管理员审核应用的时候需要选择可见范围，可根据需求选择可见范围。
注意：不在范围内的用户看不到这个应用，同时如果消息推送到该应用里，不在可见范围内的消息接收人会推送失败，同步的时候若使用该应用的权限来读取Welink数据，不在可见范围内的用户也获取不到。
访问Welink开放平台选择菜单【开发指引】-【开发准备】-【申请应用权限】点击右侧申请权限，如下图：
找到第一项【身份与鉴权】，将里面的两个权限都开启，如下图：
【通讯录管理相关】执行从Welink同步
找到【通讯录】，选择获取等相关的权限申请授权，如下图：
【通讯录管理相关】执行从ecology同步
选择名称为通讯录同步的权限，申请授权，如下图：
【消息推送相关】推送待办
找到名为待办通知的权限，申请授权，如下图：
消息管理功能主要是将OA应用消息推送到Welink中，即实现在Welink中接收冰处理业务系统的消息。消息正常推送的前提是，Welink用户要关联OA系统用户账号，详情可参考4.2.3
在【云桥】-【消息推送设置】-【消息推送规则】页面，点击新建，如下图：
例如将待办流程推送到Welink：填好规则名称，消息来源选择待办，如下图：
在规则详情页面，点击【新建】，设置推送目标，第三方企业类型选择【Wlink】，企业和应用根据实际需要，选择对应的企业团队和应用，如下图：
消息类型有：通知、待办、普通卡片，可根据需求选择相应的消息类型
注意：推送目标新建之后，要点击【保存】，如下图：
消息推送规则新建之后，可点击【编辑】按钮，对规则详情进行编辑，如下图：
将 待办 的消息推送到Welink，除了第二点中所描述的将消息来源选择待办之外，还可以将消息来源选择为全部，如下图所示：
注意：若消息来源选择全部，OA其他应用的消息（例如审批，出勤等）也会通过这条消息推送规则推送到Welink。
===== 公有环境不支持自动创建消息规则和明细，需要手动新建。
将Welink的组织架构同步到云桥（不修改OA的组织架构）云桥组织架构同步分两种：
Ø将OA的组织架构同步到云桥，同时同步到Welink（默认再同步前会先执行“从企业号同步“，以保证从OA同步的时候正确比对人员和部门信息）
执行同步前，需要先配置接口参数设置
从集成的应用里选择一个（前提是选择的应用要开启权限，全量同步的话应用的可见范围要给到所有人）。
l接口权限-只读：只能执行从企业号同步到云桥，不能在云桥通讯录调整数据，一切以企业号的组织架构为准。
l接口权限-读写：可以执行从企业号同步到云桥，也可以执行从OA同步到企业号。
l选择应用：选择同步依赖的应用。
l新用户关联系统：设置本次同步过来的新成员（即云桥中不存在对应账号的成员）是否要自动建立与OA组织架构中人员的关联关系。具体使用见4.3.1章节
l是否定时同步：定时任务，开启可执行定时从钉钉同步组织架构。
l是否同步到eteams：可参考文档从云桥同步到E10 (e-cology.com.cn)
1.基本设置
l顶级部门：执行【从OA同步】，会将选择的部门以及人员，挂载到选择的顶级部门下面。
l新用户是否添加到welink：设置从OA同步过来的新成员是否要调用welink接口自动创建到welink通讯录中。
l用户所在部门是否包含兼职部门：默认只同步用户的主部门，开启后，同步范围中包含用户的兼职部门，则会同步到welink。
l用户绑定：将OA用户和welink用户关联。详情见 【4.2.3 用户绑定】
l用户字段对应关系：设置从OA同步过来的成员与welink中已有的成员（但还没有OA关联关系的那部分成员）自动关联时的字段的对应关系。
2.范围设置
系统默认会将系统中的所有部门及人员数据同步到welink的通讯录中，同步范围不需要做任何设置。 如果有特殊的需要只将一部分部门及人员同步到welink的通讯录中，则可以设置需要同步的部门及人员范围（也可以部门和人员分开设置） 不在此范围内的并且已经与系统建立关联关系的部门或人员将会被从welink中删除，并且删除操作不可逆转，所以请谨慎选择范围。
分部/部门范围：不选择特定分部/部门，默认为全部
用户范围（包含）：在此范围内的用户将被添加或者更新到welink
用户范围（排除）：在此范围内的用户不会被添加到welink，如果用户已关联welink，同步后将被删除。
注：部门和人员可以分开设置。用户范围（排除）的优先级高于 用户范围（包含）
3.安全设置和定时设置
l用户减少数量阈值：本次同步的OA用户数量和上一次相比，减少的数量超过x，将停止同步OA用户信息。x可以自己设置
l定时设置：设置是否开启定时自动执行从OA系统同步操作。
将OA用户和welink人员绑定的方式有很多种：
1.手动绑定（需要配置应用）
用户完成应用集成之后，可以直接访问应用，然后输入正确的系统账号密码后，对应集成的welink-通讯录中会记录用户的welink账号信息以及绑定关系。
2.自动绑定设置
有三个设置的地方：一个地方配置之后，其他两处也会开启自动同步；修改任意一处，也会变更其他两处的设置。用户单点->用户绑定设置
从welink同步->新用户关联系统账号（使用见4.3.1）
从OA同步->用户绑定（使用见4.3.2）
根据配置的条件，比如：welink手机号匹配OA手机号，如果匹配上了就会自动将关联关系写入，如下图所示：
3.关联导入
将已经同步到云桥本地的数据（单点写入或者从welink同步写入）导出，并且将需要绑定的OA人员的对应字段写入到文档中，上传文档，点击导入按钮，即可将关联关系写入。
例如：welink人员B要绑定OA人员的B1，选择的关联字段是【手机号】，在导出的B这一栏的关联字段中，填写B1的手机号，保存后将文件再导入，并且关联字段选择【手机号】，然后点击导入按钮即可。
4.人员卡片绑定/解绑
5.批量解绑
解除云桥本地所有人员和OA人员的关联关系
云桥主要是将welink和OA的组织架构关联起来，所以同步前需要确认组织架构以welink端为准，还是以OA端为准！
首先执行【从welink同步组织用户绑定关系】，然后把人员在welink中的身份和在OA系统中的身份关联上，具体关联方式参考4.2.3。
后续可以在 【从welink同步组织用户绑定关系】时，开启定时同步，每隔一段时间将welink的组织架构的变动更新到云桥。
如果不希望在云桥菜单中修改组织架构影响到welink的组织架构，可以开启通讯录的只读模式：只允许welink的修改同步到云桥本地。
分两种情况
（默认已执行过从welink同步）
1.无需进行人员账号绑定。
2.执行【从OA同步】，执行完成后，云桥会把OA的人员创建到welink，并且自动把人员在welink中的身份和在OA系统中的身份关联上。在创建welink人员时，可配置对应字段的值：
1.设置welink历史人员账号绑定，选择如下任意一种方式进行关联：
方法一：手动关联（见4.2.3）
方法二：自动关联，在执行同步的时候配置人员匹配字段，如下图：
注：如果自动绑定无法满足将welink人员和OA人员关联，可以在从OA同步前先使用手动绑定关联这些人员。
2.设置顶级部门
是否设置顶级部门取决于OA和welink的组织架构，也决定了同步后的组织架构。
部门关联的逻辑是：层级相同且部门名称相同，在执行同步的时候，会自动关联，否则，在云桥和welink新建部门。关联上的部门前面会有一个黑色实心原点，代表已关联
举例说明：没有设置顶级部门，默认同步OA整体组织架构
如下图所示，根据层级和名称首先进行顶级部门匹配，则OA顶级部门【演示部门】去匹配云桥顶级部门【演示部门】，可以匹配。一级部门能够匹配上的只有【部门A】，则其他没有匹配上的部门，会在云桥和welink新建。
同步后效果（可以先同步模拟同步查看效果）：橘色为匹配，紫色为新增
注：如果顶级部门的名称不相同，例如【Re部门】和【演示部门】名称不同，则顶级部门无法匹配，同步立刻中止。
提示如下：
l设置了顶级部门，默认同步OA整体组织架构。选定【其他部门】为此次同步的顶级部门：
如图所示，组织架构层级对应如下：
执行同步，会将OA【Re部门】及其下级部门，同步到云桥【其他部门】下，作为顶级部门。 根据部门匹配的原则，OA一级部门【Re部门】和顶级部门下的一级部门没有名称相同的，直接新建。 同步效果如图：
1. 当welink的组织架构发生变化之后，需要在执行【从EC同步】之前，先执行【从welink同步】。
2. 如果该welink用户已经关联OA的账号，那么从OA同步的时候，人员匹配字段的配置将不会修改原有的绑定关系，该配置只针对未关联OA的welink端人员。
3. 接口参数设置，如果设置了只读权限，所有在云桥对组织架构进行的操作（不包括人员手动关联人员），都不能操作。
此功能在企业集成--业务集成，此功能主要实现通过welink自带的扫一扫功能扫描OA。
系统首页的二维码进行登录OA系统，具体位置如下图：
如果在未集成企业和应用的情况下，直接点击后面的【设置】按钮，会提示“请先添加welink”，故配置扫码登录功能前，请先集成企业和应用，参考手册第1、2点。
点击扫码登录功能后面的【设置】按钮，进入配置页面，先点击开启按钮，再选择集成的应用后保存，如下图所示：
打开OA系统登录首页，扫码入口在右上角，如下图所示：
使用手机端welink自带的扫一扫功能，扫OA系统登录首页二维码，如下图所示：
扫完之后，需要选择租户（也就是团队名称）及集成的企业名称，如下图所示：
选择完企业之后，如果人员在集成企业的通讯录里无关联关系且未开启自动关联（如下图1），则会出现此界面（如下图2）：
需要人员建立了关联关系后才可正常登录oa系统，具体建立关联的操作方法可参考4.2.3（开启了关联设置，此时用户访问应用，也可通过关联设置自动关联）④用户卡片绑定；扫码选择完企业后，若建立了关联关系，就能正常登录oa系统页面，效果如下图所示：
