电子影像平台客户端维护手册.docx
《电子影像平台客户端维护手册.docx》由会员分享，可在线阅读，更多相关《电子影像平台客户端维护手册.docx（24页珍藏版）》请在冰点文库上搜索。
电子影像平台客户端维护手册
电子影像平台
客户端维护手册
二0一二年三月
电子影像平台客户端维护手册
文件状态：
[]草稿
[√]正式发布
文件标识：
电子影像平台客户端维护手册
当前版本：
V1.0
完成日期：
2012年3月31日
修改历史
版本
作者
修改说明
日期
评审号
变更号
V1.0
方晴
新建
2012年3月31日
目录
1.概述3
1.1编写目的3
1.2参考资料3
2.安装后验证3
2.1安装目录检查3
2.2日志文件检查3
2.3Path环境变量检查4
3.配置文件说明4
4.客户端传输日志说明5
5.客户端使用有关说明7
5.1导入多个文件的排序方法说明7
5.2影像测试工具使用说明9
5.2.1影像扫描测试10
5.2.2影像查询批注测试11
5.2.3影像批次状态查询功能13
6.客户端程序更新说明15
6.1自动更新15
6.2手动更新15
7.常见问题说明15
7.1扫描、修改操作的常见问题15
7.2查询批注操作中的常见问题19
7.3同步业务信息的常见问题20
1.概述
1.1编写目的
对维护人员在维护客户端的过程中遇到的问题给出指导及建议。
1.2参考资料
《电子影像平台总体技术方案》
《系统集成总体方案》
2.安装后验证
2.1安装目录检查
安装程序默认安装到C:
\ProgramFiles\ADBC\InterFaceSetUp\Interface，安装后的目录如下（图1）
图1客户端程序安装目录
2.2日志文件检查
检查C:
\ProgramFiles\ADBC\InterfaceSetup\目录下的log.txt记录安装的时间和相应的客户端程序版本信息。
如图2所示，表示于2012年4月6日14点45分8秒成功安装客户端程序，版本号为1.0.00.2。
图2客户端安装程序日志
2.3Path环境变量检查
控件安装的时候会自动在系统变量path中加入如下路径：
C:
\ProgramFiles\ADBC\InterFaceSetUp\Interface
检查方法：
在【开始】-【运行】下输入”cmd”命令，进入控制台界面，输入”path”查看路径信息（如图3所示）。
图3
3.配置文件说明
安装目录C:
\ProgramFiles\ADBC\InterFaceSetUp\Interface下的clientconfig.xml是客户端主要用到的配置文件（如图4）。
图4clientconfig.xml
clientconfig.xml中的大部分字段一般不需要改动，需要关注的字段说明如下：
host上级服务器地址，指本省信息科技处提供的缓存服务器IP地址
port上级服务器端口，指本省信息科技处提供的缓存服务器端口地址
isdebug调试标志，1为开启客户端传输日志记录功能，0为关闭客户端传输日志记录功能。
4.客户端传输日志说明
客户端传输日志记录了客户端与上级缓存服务器之间交互的信息。
开启该日志记录功能需要将clientconfig.xml文件中isdebug的值置为1（如图5所示）。
图5clientconfig.xml文件
如果在使用客户端与上级服务器交互时出现异常情况，请在C:
\ProgramFiles\ADBC\InterFaceSetUp\路径下查看ImageTransClient.log文件（如图6所示）。
图6ImageTransClient日志文件
5.客户端使用有关说明
5.1导入多个文件的排序方法说明
在扫描界面录入影像文件有两种方式，一种是直接采集方式，另一种是间接采集方式。
直接采集方式是通过扫描仪扫描影像文件，间接采集方式从本机导入影像文件。
直接采集方式下影像文件顺序是按照扫描影像的顺序排序，间接采集方式下若需对多个影像文件按照系统提供的排序方式（如名称、大小、类型等）进行排列，应按照如下操作步骤进行：
（1）首先将需要导入的多个影像文件拷贝到一个文件夹中，并对文件按照序号重命名（如图7）。
图7重命名文件
（2）导入文件时，选择打开该文件夹后，在空白处点击【右键】，选择【排列图标】，然后选择其中一种排序方式（按名称、大小、类型、…如图8），对图片进行排序。
图8选择文件排列方式
（3）使用【Ctrl】+【a】组合键选中全部图像（如图9所示），点击选择就可以完成影像按指定排序方式导入，注意请不要在选择过程中点选其它文件；
图9全选图像
例如按照名称排序，按以上步骤操作，结果如下（图10）
图10按名称排序导入后界面
5.2影像测试工具使用说明
以下为客户端程序提供的扫描、查询等功能的测试工具。
5.2.1影像扫描功能
操作步骤：
（1）双击“C:
\ProgramFiles\ADBC\InterFaceSetUp\Tester”文件夹中的TestImageOcx.htm测试页面（图11）
图11客户端测试网页
（2）点击“影像扫描接口”按钮，系统会弹出传输服务器设置对话框，请设置上级服务器地址（如IP地址：
140.29.1.92端口：
8025，如图12）。
注：
上级服务器地址，指本省信息科技处提供的缓存服务器IP地址；
端口，指本省信息科技处提供的缓存服务器端口地址；
图12上一级服务器设置
（3）服务器连接成功，进入影像扫描界面（图13），点击“扫描”按钮扫描影像。
图13影像扫描控件主界面
（4）点击“批次提交”按钮。
（5）批次提交成功弹出如下图14提示。
图14批次提交成功
5.2.2影像查询批注功能
操作步骤：
（1）上述扫描接口验证完之后，记录成功提交批次的业务号、应用号、柜员号、地区号、网点号以及业务信息（如图15所示）。
图15扫描接口验证完成界面
（2）用记事本编辑“C:
\ProgramFiles\ADBC\InterFaceSetUp\Tester”文件夹中的TestActiveX.html测试界面。
修改对应的参数，如：
appID对应应用号、operID对应柜员号、areaID对应地区号、branchID对应网点号、busiID对应业务号、busiinfo对应业务信息（如图16所示）。
将以上参数修改为
（1）中记录的值后保存退出。
图16TestActiveX.html
（3）双击打开“C:
\ProgramFiles\ADBC\InterFaceSetUp\Tester”文件夹中的TestActiveX.html测试界面，查询成功，如图17所示。
图17查询批次主界面
5.2.3影像批次状态查询功能
使用影像批次状态查询功能可以查询特定批次在上级缓存服务器中的状态。
该功能一般用作批次操作的检查与诊断。
具体操作步骤如下:
（1）打开“C:
\ProgramFiles\ADBC\InterFaceSetUp\Tester\TestImageOcx.htm”（图18）
（2）输入影像批次业务号。
（3）在服务器IP地址栏中输入要查询的缓存服务器的IP地址和端口号。
（4）输入该批次对应的地区号。
（5）点击“影像状态查询接口”,系统会返回一个状态数值对应影像批次在上级服务器中的状态。
具体请参照下表1说明。
图18TestImageOcx.htm界面
状态查询返回值
返回值
意义
PS
PF
1
未处理
0
0
2
正在处理
1
0
5
待迁移
0
2
6
正在迁移
1
2
7
待清理
0
3
8
正在清理
1
3
9
迁移错误
3
2
12
作废
2
1
表1
6.客户端程序更新说明
6.1自动更新
客户端每天首次调用影像控件时会检查是否需要进行程序更新，当程序判断需要更新时自动从服务器端下载更新文件。
当更新文件下载完毕后，会提示客户端人员是否需要立即重启电脑，点击“是”，电脑自动重启，并在开机后自动执行更新程序。
（图19）。
图19重启提示
6.2手动更新
当不使用自动更新，即更新文件下载完毕后，提示客户端人员是否需要立即重启电脑时，点击否。
之后如果需要更新文件，则退出程序后，直接在C:
\ProgramFiles\ADBC\InterFaceSetUp\Interface\updatetemp文件夹下双击run.bat即可。
（图20）。
图20run.bat文件
7.常见问题说明
根据客户端返回值及返回信息总结以下常见问题。
7.1扫描、修改操作的常见问题
（1）获取影像批次号失败
返回值
E-10
错误定义
获取影像批次号失败
原因分析
该错误为参数错误，原因可能为：
1．连接的影像服务器上并没有配置当前交易涉及的应用；
2．数据库用户被锁；
解决方法
1．联系相应的影像服务器管理员，确认试图连接的影像服务器上是否配置了对应的应用；比如您正在做CM2006的交易，那么对应的应用号就是0008，则联系影像服务器的管理员确认影像服务器上是否已经配置了0008这个应用；
2．联系相应的影像服务器管理员，将数据库用户解锁；
其他
（2）影像服务器连接失败
返回值
-20
错误定义
服务器连接失败
原因分析
1．客户端与服务器端网络不通
2．客户端配置的服务器地址错误
解决方法
1．检查服务器地址配置，确认地址配置是否正确；
2．使用ping命令看与影像服务器网络是否连通，使用telnet命令看配置端口上的影像服务是否开启；
其他
如果问题无法解决，请提供：
影像控件安装路径下的log_D日志和影像控件安装路径下的host_port.ini文件
（3）用户校验失败
返回值
-21
错误定义
用户校验失败
原因分析
1．连接的影像服务器磁盘空间不足；
2．影像服务器服务运行过程中系统时间被修改
解决方法
1．检查磁盘空间是否不足；
2．重启影像服务器上的影像服务；
其他
如果问题无法解决，联系电子档案管理员
（4）待上传批次文件不存在
返回值
-30
错误定义
待上次批次文件不存在
原因分析
上传的文件名中有影像服务器不支持的字符
解决方法
避免文件名名中的生僻字和特殊字符
其他
1．如果问题无法解决，联系电子档案管理员；
2．或提供待上传影像的文件名；
（5）批次索引文件解析错误
返回值
-34
错误定义
批次索引文件解析错误
原因分析
终端上xml文件解析器异常
解决方法
1.重装C:
\ProgramFiles\ADBC\InterFaceSetUp\Interface目录下的msxmlchs.msi；
2.如果msxmlchs.msi安装失败，检查机器上是否安装了智能卡或特别的USB设备，禁用此类设备后再安装；
其他
如果问题无法解决，联系电子档案管理员；
提供安装msxmlchs.msi时的错误截图或错误现象描述；
（6）批次锁定
返回值
E-50
错误定义
批次锁定
原因分析
1.可能是批次在修改过程中发生了异常，导致再次以“非只读”方式调影像时候报-50操作；
2.影像后台服务器对影像批次进行了加锁操作进行处理，暂时不允许对该影像进行修改；
解决方法
确认连接的影像服务器地址是否正确，如果问题依旧提供：
1.影像控件安装路径下的log_D日志
2.影像控件安装路径下的host_port.ini文件
其他
（7）数据库异常
返回值
E-52
错误定义
更新待处理批次列表失败
原因分析
影像数据库异常；
解决方法
联系相应的影像服务器管理员，确认影像数据库是否正常，异常则重启
其他
（8）业务信息文件不存在
返回值
-61
错误定义
业务信息文件不存在
原因分析
该错误原因可能为：
连接的影像服务器上并没有配置当前交易涉及的应用；
解决方法
联系相应的影像服务器管理员，确认试图连接的影像服务器上是否配置了对应的应用；比如您正在做CM2006的交易，那么对应的应用号就是0008，则联系影像服务器的管理员确认影像服务器上是否已经配置了0008这个应用。
其他
（9）CCF下载影像异常
返回值
CCF-99
错误定义
CCF下载影像异常
原因分析
可能原因：
存放下载文件的目录下文件太多，导致文件下载异常
解决方法
清理文件
其他
（10）磁盘空间满
返回值
I186duplexscan
原因分析
该错误原因可能为：
磁盘空间满
解决方法
清理磁盘
其他
（11）识别图像的分辨率和配置图像的分辨率不一致
错误定义
识别图像的分辨率和配置图像的分辨率不一致
原因分析
1.有可能是因为客户端版本不对，识别控件的版本无法识别影像；
2.影像文件元数据损坏（实物扫描一般不会有这问题）
3.识别程序有缺陷
解决方法
1.检查影像控件目录.\Interface\config.ini文件，里面记录了当前影像控件的版本号，确认版本是否为生产/测试最新版本；
2.如果是使用独立安装的影像客户端请运行C:
\ProgramFiles\ADBC\InterFaceSetUp\Interface下的ImgReg.bat文件；
其他
如果问题无法解决，请提供：
1..\Interface\config.ini文件中的版本号；
2.影像文件；
（12）版面识别失败
错误定义
版面识别失败
原因分析
1.有可能是因为客户端版本太旧，识别控件的版本无法识别影像；
2.影像文件元数据损坏（实物扫描一般不会有这问题）
3.识别程序有缺陷
解决方法
1．检查影像控件目录.\Interface\config.ini文件，里面记录了当前影像控件的版本号，确认版本是否为生产/测试最新版本；
2.如果是使用独立安装的影像客户端请运行C:
\ProgramFiles\ADBC\InterFaceSetUp\Interface下的ImgReg.bat文件；
其他
如果问题无法解决，请提供：
1．.\Interface\config.ini文件中的版本号；
2．影像文件；
（13）获取影像批次号失败
错误定义
影像故障，获取影像批次号失败
原因分析
比较有可能是系统安装了多套应用控件，而当前正在调用的影像控件并非已注册的控件；
解决方法
使用ImgReg.bat对影像控件进行注册；
其他
如果问题无法解决，请提供path变量值和错误界面截图；
（14）传输异常
返回值
E9
错误定义
传输异常
原因分析
影像在传输过程中发生了异常；
解决方法
需提供以下信息进行分析:
1、报该错误的影像批次号；
2、影像缓存服务器的RunLog日志
其他
7.2查询批注操作中的常见问题
（1）影像查看异常
错误定义
IE8影像查看异常
原因分析
可能原因：
1.未加入信任站点；
2.安全设置级别设置为低
解决方法
1.在IE设置中将访问的站点加入信任站点；
2.安全级别设置为低
其他
如果问题按上述方法处理后问题依然无法解决：
1.提供path路径；
2.提供错误截图；
3.提供IE安全设置中各项设置；
注：
IE的安全设置请参考《电子影像平台客户端安装手册》中的3.2浏览器设置。
（2）指定的服务器无此批次
返回值
-43
错误定义
指定的服务器无此批次
原因分析
指定服务器此批次不存在
解决方法
1.查询失败的对应影像批次号，审核端连接的影像服务器IP和端口；
2.检查影像批次在缓存上是否存在和批次状态；；
其他
无
（3）其他错误
返回值
E5
错误定义
批次状态不允许操作
原因分析
可能原因：
对应的影像批次在服务器端的状态为待迁移状态，此时不允许进行修改
解决方法
如果是刚提交的影像批次，不建议立即做修改操作，因为服务器有可能对该影像批次做一些处理；
其他
如果问题按上述方法处理后问题依然无法解决：
1.提供path路径；
2.提供错误截图；
3.提供连接的测试环境（生产环境无需提供）
4.提供报此问题的影像批次号，如果是生产环境请联系分行的影像服务器管理员获取该批次的状态，以及RunLog日志；
5.提供客户端Interface\Log_D文件夹下的日志
7.3同步业务信息的常见问题
（1）同步业务信息模板失败
返回值
-13
错误定义
同步业务信息模板失败
原因分析
可能原因：
系统安装了智能卡的驱动导致无法安装msxmlchs.msi，从而导致程序无法解析业务信息模板报-13
解决方法
1.在系统中禁用智能卡
2.重新安装msxmlchs.msi
其他
升级会员 