# BUA同步钉钉通讯录部署说明
> 本文档是基于markdown语法编写的，请使用能支持Markdown语法的编辑器打开，或只用在线Markdown工具阅读。能支持的的编辑器（Visual Studio Code 或 Visual Studio 2015 +）
## 概述
1. 创建同步数据库
2. 部署同步管理系统
3. 部署同步管理系统的BUA同步适配服务
4. 完成
## 创建同步数据库
1. 创建一个同步的数据库，名字可以随便取，默认推荐名称（PlatformAppDB）
2. 复制PlatformAppDB.sql里面的内容，在新创建的数据库中执行。执行的结果是创建3个表【PFA_DingDing_Org、PFA_DingDingUser、PFA_DingDing_SyncLog】
## 部署同步管理系统
> 此管理系统为BUA同步扩展管理系统，可以手动一次性同步、指定机构同步、指定用户同步的功能，同时可以查看到具体的同步日志内容
> **注意**
> 此管理系统必须部署为IIS站点的虚拟站点，且站点的名称必须为[PlatformApp]。如果不是这样站点运行可能遇见错误
1. 选择一个已经存在的站点或创建一个新的站点（可以是空站点），用来作为PlatformApp站点宿主站点
2. 将PlatformAppUI文件夹复制到服务器中
3. 在第一步的宿主站点下，添加应用程序名称为PlatformApp，应用程序池的Net Framework 版本为4.5
4. 将web.config里面的数据库链接改为上面步骤中创建的数据库地址和名称
5. 将web.config里面AppSettings中的DingDing:CorpId、DingDing:CorpSecret分别填写钉钉开放平台中对应的值
6. 将web.config里面的BUAClient的配置指向需要同步对接的BUA WebService地址
7. 部署完成，可以浏览运行站点，站点的路径为 http://宿主站点HOST/PlatformApp/Web. 如：http://localhost/PlatformApp/Web
8. 站点运行效果如下，如没有显示正确，请按以上步骤检查
## 部署同步管理系统的BUA同步适配服务站点
> 此同步适配服务站点的目的是，在BUA中操作用户或机构时，可以自动的同步到钉钉中。如果不需要这样的功能，可以不部署此服务。
1. 将PlatformAppSyncWebServices文件夹复制到服务器中，放置在上一步站点文件PlatformAppUI作为兄弟文件夹
2. 在上一步IIS宿主站点下添加应用程序名称为PlatformAppWebServices，应用程序池的Net Framework 版本为4.5. 文件夹指向PlatformAppSyncWebServices文件夹
3. 在BUA同步站点配置同步信息，打开BUA站点，如下图：
4. 请按照以下小节，添加这些同步的接口。
需要添加的接口：
200001 新增组织机构
200002 修改组织机构
200004 组织机构移动
200003 删除组织机构
210001 新增用户
210012 新增用户所有信息
210002 修改用户基本信息
210013 变更用户所有信息
210006 变更主组织机构
210003 删除用户
210004 用户帐号锁定
210005 用户帐号解锁
5. 部署完成。可以修改、添加用户时，可以在管理系统中查看日志。
### 添加同步接口
1. 请在BUA中先创建一个系统，名为钉钉
2. 在上一步同步接口配置中，点击添加同步接口配置按钮
3. 同步名称请选择上面需要添加的接口
4. 同步适配请选择“.Net Web 服务”
5. 应用系统选择“钉钉”
6. Web服务地址，就是上面创建的站点里面的DingDingSyncService.asmxUrl，如：“http://localhost/PlatformAppSyncWebServices/DingDingSyncService.asmx”
7. 点击确定即可。
8. 重复2-7步骤。添加上面提到的那些接口。最终的列表和上面的图片一致即可。
同步管理.zip (4.8MB)