Excel 服务器填报网站应用集成接口说明
目的
- 用户自己有一个Web 系统,假设为A 系统
- A 系统中的用户和Excel 服务器系统的用户有相同的账户名相同,口令不要求相同
- 希望通过A 系统能打开ESWeb 中的表单填报页面,对指定表单进行操作,允许的操作包括:
a) 指定模板名称新建该模板的表单
b) 指定表单编号打开某已存在的表单
c) 指定工作项目编号办理某项待办事宜
d) 指定工作项目编号打开某已完成工作
名词解释
名词 | 说明 |
表单 | 模板的每次填报产生一个表单。 模板上定义的数据表在帐套数据库中创建,表单数据存储在其中 |
表单编号 | 每个数据表中,都有一个 ExcelServerRcId 字段,称为表单编号,它是 一张表单的唯一标识。 |
工作项目 | 工作流实际流转的每一步,称为一个工作项目。 工作项目有状态,有“待办”、“已办”、“正打开”三种 “待办”状态的工作项目又称为“待办事宜” “已办”状态的工作项目又称为“已完成工作” 每个工作项目都有编号,它是唯一的 我们可以提供视图,显示所有工作项目的内容。 |
集成方法
步骤
把A 系统和ESWeb 集成需要做到如下两件事:
- 在A 系统中自己写一个接口页面,在此页面上访问ESWeb 提供的链入接口页面(externalLink/premain.aspx),并传递正确的参数,达到操作ESWeb 的目的
- 在ESWeb 的web.config 文件中进行配置,登记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 运算结果 |
除了上述参数外,根据所进行的操作不同,还要给出以下参数:
- 指定工作项目编号,办理待办事宜
参数名 说明 op 赋值为”doWi” wiid 工作项目编号
- 指定工作项目编号,打开已完成工作
参数名 说明 op 赋值为“readWi” wiid 工作项目编号
- 指定模板名称,新建表单
参数名 说明 op 赋值为”newCase” repName 模板名称
- 指定表单编号,打开某表单
参数名 说明 op 赋值为”readCase” rcId 表单编号
- 显示待办事宜列表
参数名 说明 op 赋值为“dowilist”
- 仅执行登录,然后显示主窗口
参数名 说明 op 赋值为“login”