Excel Server Tutorial

30.1 Excel服务器企业微信集成指南

30.1.1 安装要求：

要使用微信功能，对服务器机器有如下要求：
1) 此机器需能连接互联网，拥有一个域名（此域名须通过ICP备案的验证，至少是二级或二级以上域名），该域名指向此机器
2) 要求安装 .net framework 4.7.2，如未安装过，则安装过程中会自动从微软网站下载安装包进行安装

30.1.2 安装Excel Server 2022

使用Excel Server 2022（或者 CAD Server 2022）安装包进行安装
安装时选择“完全安装”（勾选“移动服务端（多平台）”）如下图

图 30 ‑1
注：安装完毕后IIS管理台中能看见名为 iESWeb2 的虚拟目录，其对应的应用程序池需为 .net framework 4.7.2集成，"高级设置"中 "标识"选择LocalSystem,"启用32位应用程序"选择True。

30.1.3 申请企业微信

若已有企业微信，可跳过此节，直接阅读第30.1.4 节。

1.用浏览器访问 https://work.weixin.qq.com/

正确打开网页后，点 [立即注册]。

图 30-2

2.填写企业基本信息

按企业实际性质填写对应的企业信息。
例如：
企业名称输入“excelserver”。
输入管理员信息、验证码后，打开管理员手机上的微信，点右上角的“+”，选择扫一扫，扫描页面的二维码。

图 30-3

微信中点击【登录】。

图 30-4
勾选【我同意并遵守】点击【注册】。

3.申请成功

申请成功后会弹出如下窗口。

图 30-5
点击【进入后台管理】，可进入企业对应的后台管理页面。

图 30-6
注册成功后登录，可以使用浏览器访问 https://work.weixin.qq.com/ 网址，打开如图30-2所示的页面，点击【企业登录】，弹出下图页面：

图 30-7
用管理员微信扫一扫其上的二维码，跳转到下图所示页面。选择已注册成功的企业如：“excelserver”，点击【登录】则打开如图30-9所示的企业后台管理页面进行设置。

图 30-8

30.1.4 微信中建立应用

在企业微信管理界面https://work.weixin.qq.com上创建与Excel服务器帐套对应的应用

1.在微信中新建应用

在企业微信管理界面“应用管理”-“应用”，点击“自建”中的【创建应用】。

图 30-9

2.填写应用信息

应用名称会出现在被允许访问的人员的企业微信中。
应用名称和功能介绍在应用创建完毕后可以再修改。
应用可见范围：此处选择通讯录中的机构名，属于此机构的人员接受邀请后，打开手机企业微信端就能看见此应用（如何邀请和设置通讯录将在后面讲述，此处不细说）

图 30-10
点击【创建应用】进入如下所示页面：

图 30-11

3.设置可信域名

点击上图中【网页授权及JS-SDK】下的“设置可信域名”。在弹出窗中填写可信域名。

图 30-12

1）若可信域名有指定的端口号，需要写上端口号( 此域名为ES服务器微应用中的本网域名)。
2）点击【申请检验域名】并且点击【下载文件】链接，保存文件到本地。

图 30-13

3）打开管理器，选中iesweb2所在根目录右键点击【浏览】

图 30-14

4.）将下载的文件拷贝至打开的目录中。

图 30-15

5. 点击【确定】按钮。完成可信域名设置。

4.添加成员

企业微信管理界面选择【通讯录】点击【添加成员】可手动添加成员，如添加系统管理用户：“Admin”。也可依30.1.5将Excel服务器用户导入微信。

图 30-16

5.通讯录同步

若希望通过初始化配置页面导入Excel服务器用户到企业微信，则需要设置【通讯录同步】。开启后则不可进行手动添加成员操作。
设置步骤如下：
1. 点击【管理工具】下的【通讯录同步】。

图 30-17

2. 开启API接口同步。

图 30-18

3. 点击【编辑】设置权限。

图 30-19

4. 选择编辑通讯录权限，点击【保存】。

图 30-20

30.1.5 ES中企业微信初始化配置

企业微信号设置

1.登录ES微信配置页面

1)如初次登录，则依12.1中步骤操作，
2)再次登录时，在浏览器中输入访问网址 http://127.0.0.1/iESWeb2
如下图所示在应用处输入应用名，用户名输入Excel服务器管理员账户（Admin为超级管理员账户，Excel服务器安装后默认存在），然后点【登录】按钮。

图 30-21

2.设置应用

1) 登录成功后，点击【企业微信设置】，初次设置时会直接进入设置界面，如下图所示，以后创建其他应用时需点击添加链接

图 30-22
这里需要填写CorpID 、应用Secret和通讯录Secret ，请到下图所示的企业微信管理界面中查看后填入30-22页面，其中CorpID为【我的企业】下的”企业ID“信息。

图 30-23

“应用Secret”为【应用管理】中对应的应用“Secret”的查看信息。

图 30-24

“通讯录Secret”是【管理工具】-【通讯录同步】中的“Secret”信息，填写完毕后点击【下一步】。

图 30-25

2) 设置应用信息
设置应用ID，应用名称

图 30-26
此处需填入“应用Id”和“应用名称”，这两个信息也是在企业微信管理页面中，进入企业微信管理界面中【应用管理】查看对应应用后填入当前页面，查看位置如下图所示，填写完毕后点击【下一步】。

图 30-27

3)然后将如下页面上自动生成的URL，Token，EncodingAESKey 填到企业微信管理界面上【应用管理】中对应应用的【接收消息】的【设置API接收】中。

注意：在微信管理界面未设置完成前，一定不要点此页面上的 “完成” 按钮。

图 30-28
具体操作步骤如下：
在企业微信的管理界面选择【应用管理】-【应用】-【自建】，点击应用：“essample”：

图 30-29
点击【接收消息】下的【设置API接收】

图 30-30
填入 URL，Token，EncodingAESKey 后点【保存】按钮

图 30-31
4) 在企业微信管理界面填写完URL，Token，EncodingAESKey并保存之后，在Excel服务器设置页面上点“完成”，如下图所示

图 30-32

至此完成了初始化设置

3.微信用户导入

1)点击【微信用户导入】：

图 30-33
2)点击【向企业微信中导入新用户】。

图 30-34
3)页面显示微信中通讯录里已有的组织结构和人员，选择要导入至的机构，点【下一步】。

图 30-35
4) 此页面列出Excel服务器中的用户，选择要导入进微信的部门，点【下一步】

图 30-36

5) 点击【开始导入】。

图 30-37

6) 导入后结果页面如下

图 30-38

此表格第一列为Excel服务器登录名，将作为微信通讯录的UserId导入，第二列为姓名，将作为微信通讯录姓名导入，第三列为导入结果
其中绿色的为成功，红色为导入失败，导入失败的将在第三列显示失败原因，“userid existed” 的意思是用户已存在。
“invalid userid”的意思是使用了不合法的userId，比如带了空格，使用了中文等
说明：未导入的用户无法通过微信收到待办等消息

邀请导入人员

在企业微信的管理界面选择【通讯录】按下图操作

图 30-39
选择通讯录，在表格上勾全选（则所有人员都会被选中），或者单独勾选要操作的人，选好要操作的人之后点击 “邀请”、“立即邀请”或“微信邀请”
1) 有邮箱的用户会收到一封邮件，邮件中会有一个企业微信下载链接，用户下载企业微信客户端。
2) 有手机的用户会收到含有下载企业微信客户端链接的短信。

对于企业微信通讯录中已经存在的用户，如需要使用我们的企业微信应用，进行消息推送和免认证登录，用户较少时可手动进行如下设置：
1. 登录应用系统，找到已存在于企业微信通讯录当中的用户“张三”。

图 30-40

2. 点击【属性】,选择【互联网应用属性】。

图 30-41

3. 这里需要修改“企业微信账号” ，请按如下步骤查看企业微信管理页面中信息后修改对应内容。
a. 登录企业微信后台管理界面选择通讯录。
b. 点击对应的用户“张三”查看账号信息，输入到上图的“企业微信账号”中。

图 30-42

4. 点击【确定】。

若用户较多，可通过IESWeb2配置网站中的【关联企业微信中已有用户】进行同步通讯录，具体操作如下：
1. 点击图30-34中【关联企业微信中已有用户】菜单，打开如下页面：

图 30-43

2. 点击【下一步】，完成企业微信用户的关联。

图 30-44

30.1.6. 配置消息提醒

通过此配置，对于使用应用的企业微信用户，其手机可收到微信的提醒，提醒内容包括工作流待办提醒、预警提醒和表间公式生成的提醒

前提条件：需参照15.4.2节内容，开启消息提醒。
1) 将名为ServerConfigWS.xml的文件拷贝入Excel服务器的安装目录下, 例如：如果使用默认安装目录，则改目录名为C:\Program Files (x86)\Cesoft\Excel Server 2021
此文件内容如下：

<?xml version="1.0" encoding="utf-8"?>


<SendMsgToWS enable="1" logenable="1" logpath="">
<interfaces>
<interface name="WorkItemSubmited">
<ws url="http://127.0.0.1/iESWeb2/api/mbopeninterface" namespace ="http://tempuri.org/" protocol="post2webapi" lang="ASP.NET">
<method name="submitwi">
<inparams>
<param i="1" name="wiId" type="string" field="wiId" />
<param i="2" name="db" type="string" field="db" />
</inparams>
<outparams>
<param i="1" name="out" type="int"/>
</outparams>
</method>
</ws>
</interface>

注：
a) 此文件需保存为utf-8 格式，用记事本打开文件，另存为时将编码选择为 “utf-8”
b) http://127.0.0.1/iESWeb2是移动端服务的访问网址，供Excel服务访问的，如果安装在不同的机器上，则127.0.0.1 需改为实际的ip或域名
c) 此配置文件修改完毕后需重新启动Excel服务器服务

经过上面的配置，手机微信已经可以收到系统发送的“微信钉钉待办提醒”了