GIS系统与客服系统对接的设计
摘要：地理信息系统（GIS）与客服系统的一体化建设是目前供水企业所面临的重要信息化管理问题之一，通过对GIS系统和客服系统对接的设计，探讨了一体化过程中的项目需求、对接方式和方法。
关键词：GIS系统 客服系统 对接
1.项目背景
GIS系统提出要求：客服系统中如接收到管网类的受理单时，需要将该类工单推送给GIS系统，由GIS系统对整个处理过程进行接管处理，因此需要客服系统与GIS系统进行对接。
2.项目需求
当在客服系统录入工单或工单分派时，如果选择的“处理部门”是“管网维护部”时，客服系统向GIS系统推送该工单信息(为便于描述，此类工单以下统称为“管网类”工单)
“管网类”工单不允许操作员在客服系统上添加处理进度、录入处理结果、录入回访结果等操作。
客服系统中对于“管网类”工单添加处理进度、录入处理结果、录入回访结果等，以GIS系统向接口提交的信息为准进行记录。
3.对接方式
采用http或https方式的WebApi来实现客服系统与GIS系统进行交互。具体分工如下：
A.字典类数据、新建工单、修改工单由客服系统向GIS系统推送
B.工单派工、处理结果录入、添加处理进度由GIS系统向客服系统推送
4.GIS系统WebApi(GIS系统实现，客服系统发起请求)
4.1接收工单信息
4.1.1说明
该接口由客服系统发起请求。如果超时、GIS系统没响应、或响应失败，客服系统会自动重复发起，直至成功响应为止。(随着失败响应的次数增加，客服系统重新发起的间隔时间会进行相应延长）
客服系统会在三个节点上发起请求：
1.当新增工单或修改工单中选择“处理部门”是“管网维护部”。
2.当派工时选择“处理部门”是“管网维护部”。
3.当修改工单或修改派工时，原来的“处理部门”是“管理维护部”改成其他部门时(详见注1)。
**注1**:传入的值中gisjieguan的值为true时，由gis系统接管该受理单的后续处理，为false时，表示该受理单已取消或已分派给别的部门，不需要gis接管。
工单号在客服系统中是唯一的，因此，GIS系统应以该字段作为新增或修改的依据。
4.1.2请求URL
http://xx.com/api/jieshougongdan
4.1.3请求方式
POST
4.1.4请求参数
参数名 必选 类型 说明
gongdanghao 是 string 工单号（唯一性)
huhao 是 string 户号
Lianxiren 否 string 联系人
lianxidianhua 否 string 联系电话
dizi 否 string 地址
fanyingxingsi 否 string 反应形式
fangyinlaiyuan 否 string 反应来源
biaoleixing 是 string 表类型
kuojing 否 string 口径
4.1.5返回示例
4.1.6返回参数说明
参数名 类型 说明
State int 0成功，非0不成功
Result1 string 描述(如不成功，需要在此填定不成功描述)
Result2 string 预留
Data String 或json对象 预留
4.2字典类接口
4.2.1说明
所有字典类信息一次提交
4.2.2请求URL
http://xx.com/api/jieshouzidian
4.2.3请求方式
POST
4.2.4请求参数
参数名 必选 类型 说明
leibeizhongshu 是 string 类别总数
data 是 json对象 数据
data格式形如
5.客服系统WebApi(客服系统系统实现，GIS系统发起请求)
5.1添加处理进度
5.1.1说明
将GIS系统传过来的处理进度添加到客服系统。
请求参数中的ID具有唯一性，客服系统以此作为新增或修改的判断。
5.1.2请求URL
http://xx.com/api/tianjiachulijindu
5.1.3请求方式
POST
5.1.4请求参数
参数名 必选 类型 说明
chuliriqi 是 datetime 处理日期
chulirenyuan 是 string 处理人员
chuliqingkuang 是 string 处理情况
id 是 int 唯一性
gongdanhao 是 string 必填
5.2录入处理结果
5.2.1说明
将GIS系统传过来的处理结果更新到客服系统。
5.2.2请求URL
http://xx.com/api/luruchulijieguo
5.2.3请求方式
POST
5.2.4请求参数
参数名 必选 类型 说明
chuliriqi 是 datetime 处理日期
chulijieguo 是 string 处理结果 (字典类的key)
jiluren 是 string 记录人
riqi 是 datetime 记录日期
beizhu 是 string 备注
gongdanhao 是 string 工单号
6. 结束语
地理信息系统（GIS）与客服系统统一规划设计，做好对接，是实现智慧供水企业中信息化资源有效利用的关键，不仅可以为企业节约人力和财力成本，而且为企业的长远发展提供了技术保证。
参考文献
[1] 刘光.地理信息系统二次开发教程.清华大学出版社,2003：257~276
[2] 吴信才.地理信息系统设计与实现.电子工业出版社,2002.03：118~163
