技术支持

Excel 服务器填报网站应用集成接口说明

目的

1. 用户自己有一个Web 系统，假设为A 系统
2. A 系统中的用户和Excel 服务器系统的用户有相同的账户名相同，口令不要求相同
3. 希望通过A 系统能打开ESWeb 中的表单填报页面，对指定表单进行操作，允许的操作包括：
   a) 指定模板名称新建该模板的表单
   b) 指定表单编号打开某已存在的表单
   c) 指定工作项目编号办理某项待办事宜
   d) 指定工作项目编号打开某已完成工作

名词解释

名词	说明
表单	模板的每次填报产生一个表单。 模板上定义的数据表在帐套数据库中创建，表单数据存储在其中
表单编号	每个数据表中，都有一个 ExcelServerRcId 字段，称为表单编号,它是 一张表单的唯一标识。
工作项目	工作流实际流转的每一步，称为一个工作项目。 工作项目有状态，有“待办”、“已办”、“正打开”三种 “待办”状态的工作项目又称为“待办事宜” “已办”状态的工作项目又称为“已完成工作” 每个工作项目都有编号，它是唯一的 我们可以提供视图，显示所有工作项目的内容。

集成方法

步骤

把A 系统和ESWeb 集成需要做到如下两件事：

1. 在A 系统中自己写一个接口页面，在此页面上访问ESWeb 提供的链入接口页面（externalLink/premain.aspx），并传递正确的参数，达到操作ESWeb 的目的
2. 在ESWeb 的web.config 文件中进行配置，登记A 系统的接口页面。

因此，要想做到集成有一个前提，就是，执行集成的人员，有权利对A系统进行操作，并且懂得如何在A系统中增加网页或者改写A系统中现有网页。

ESWeb 链入接口页面的调用方法及参数说明

链入页面为 <安装目录>\ESWeb\External\preMain.aspx
通过A 系统调用此链入页面时，需要根据要进行的操作，传递参数
四种操作都需要给出的参数有4 个：login、DB、verify 和 pwd，说明如下：

参数名	说明
login	账户名，即希望此操作以Excel 服务器中哪个账户的身份进行
db	应用系统名，即希望操作Excel 服务器中哪个应用系统，如果此参数不提供，则默认为 “ESApp1”
verify	是否对账户进行密码验证，可能取值如下 1： 进行密码验证 0 ：不进行密码验证 若缺少此参数，则使用默认值1
pwd	若verify 参数给了0，不需要此参数 若verify 参数给了1，则，此参数要给账户的密码的MD5 运算结果

除了上述参数外，根据所进行的操作不同，还要给出以下参数：

1. 指定工作项目编号，办理待办事宜
   

   参数名	说明
   op	赋值为”doWi”
   wiid	工作项目编号

   
   
2. 指定工作项目编号，打开已完成工作
   

   参数名	说明
   op	赋值为“readWi”
   wiid	工作项目编号

   
   
3. 指定模板名称，新建表单
   

   参数名	说明
   op	赋值为”newCase”
   repName	模板名称

   
   
4. 指定表单编号，打开某表单
   

   参数名	说明
   op	赋值为”readCase”
   rcId	表单编号

   
   
5. 显示待办事宜列表
   

   参数名	说明
   op	赋值为“dowilist”

   
   
6. 仅执行登录，然后显示主窗口
   

   参数名	说明
   op	赋值为“login”