电子影像平台客户端维护手册.doc

电子影像平台客户端维护手册电子影像平台客户端维护手册二0一二年三月 电子影像平台客户端维护手册文件状态： 草稿 正式发布文件标识：电子影像平台客户端维护手册当前版本：V1.0完成日期：2012年3月31日修改历史版本作者修改说明日期评审号变更号V1.0方晴新建2012年3月31日目 录1.概述31.1编写目的31.2参考资料32.安装后验证32.1安装目录检查32.2日志文件检查32.3 Path环境变量检查43.配置文件说明44.客户端传输日志说明55.客户端使用有关说明75.1导入多个文件的排序方法说明75.2影像测试工具使用说明95.2.1影像扫描测试105.2.2影像查询批注测试115.2.3影像批次状态查询功能136.客户端程序更新说明156.1自动更新156.2手动更新157.常见问题说明157.1扫描、修改操作的常见问题157.2查询批注操作中的常见问题197.3同步业务信息的常见问题201.概述1.1编写目的对维护人员在维护客户端的过程中遇到的问题给出指导及建议。1.2参考资料电子影像平台总体技术方案系统集成总体方案2.安装后验证2.1安装目录检查安装程序默认安装到C:Program FilesADBCInterFaceSetUpInterface，安装后的目录如下（图1）图1客户端程序安装目录2.2日志文件检查检查C:Program FilesADBCInterfaceSetup目录下的log.txt记录安装的时间和相应的客户端程序版本信息。如图2所示，表示于2012年4月6日14点45分8秒成功安装客户端程序，版本号为1.0.00.2。 图2 客户端安装程序日志2.3 Path环境变量检查控件安装的时候会自动在系统变量path中加入如下路径：C:Program FilesADBCInterFaceSetUpInterface检查方法：在【开始】-【运行】下输入”cmd”命令，进入控制台界面，输入”path”查看路径信息（如图3所示）。图33.配置文件说明安装目录C:Program FilesADBCInterFaceSetUpInterface下的clientconfig.xml是客户端主要用到的配置文件（如图4）。图4clientconfig.xmlclientconfig.xml中的大部分字段一般不需要改动，需要关注的字段说明如下：host上级服务器地址，指本省信息科技处提供的缓存服务器IP地址port上级服务器端口，指本省信息科技处提供的缓存服务器端口地址isdebug调试标志，1为开启客户端传输日志记录功能，0为关闭客户端传输日志记录功能。4.客户端传输日志说明客户端传输日志记录了客户端与上级缓存服务器之间交互的信息。开启该日志记录功能需要将clientconfig.xml文件中isdebug的值置为1（如图5所示）。图5 clientconfig.xml文件如果在使用客户端与上级服务器交互时出现异常情况，请在C:Program FilesADBCInterFaceSetUp路径下查看ImageTransClient.log文件（如图6所示）。图6 ImageTransClient日志文件5.客户端使用有关说明5.1导入多个文件的排序方法说明在扫描界面录入影像文件有两种方式，一种是直接采集方式，另一种是间接采集方式。直接采集方式是通过扫描仪扫描影像文件，间接采集方式从本机导入影像文件。直接采集方式下影像文件顺序是按照扫描影像的顺序排序，间接采集方式下若需对多个影像文件按照系统提供的排序方式（如名称、大小、类型等）进行排列，应按照如下操作步骤进行：（1） 首先将需要导入的多个影像文件拷贝到一个文件夹中，并对文件按照序号重命名（如图7）。图7 重命名文件（2） 导入文件时，选择打开该文件夹后，在空白处点击【右键】，选择【排列图标】，然后选择其中一种排序方式（按名称、大小、类型、如图8），对图片进行排序。图8选择文件排列方式（3） 使用【Ctrl】+【a】组合键选中全部图像（如图9所示），点击选择就可以完成影像按指定排序方式导入，注意请不要在选择过程中点选其它文件；图9 全选图像例如按照名称排序，按以上步骤操作，结果如下（图10）图10 按名称排序导入后界面5.2影像测试工具使用说明以下为客户端程序提供的扫描、查询等功能的测试工具。5.2.1影像扫描功能操作步骤：（1）双击“C:Program FilesADBCInterFaceSetUpTester”文件夹中的TestImageOcx.htm测试页面（图11）图11 客户端测试网页（2）点击“影像扫描接口”按钮，系统会弹出传输服务器设置对话框，请设置上级服务器地址（如IP 地址：2 端口：8025，如图12）。注：上级服务器地址，指本省信息科技处提供的缓存服务器IP地址；端口，指本省信息科技处提供的缓存服务器端口地址；图12 上一级服务器设置（3）服务器连接成功，进入影像扫描界面（图13），点击“扫描”按钮扫描影像。图13 影像扫描控件主界面（4） 点击“批次提交”按钮。（5）批次提交成功弹出如下图14提示。图14 批次提交成功5.2.2影像查询批注功能操作步骤：（1）上述扫描接口验证完之后，记录成功提交批次的业务号、应用号、柜员号、地区号、网点号以及业务信息（如图15所示）。图15扫描接口验证完成界面（2）用记事本编辑 “C:Program FilesADBCInterFaceSetUpTester”文件夹中的TestActiveX.html测试界面。修改对应的参数，如：appID对应应用号、operID对应柜员号、areaID对应地区号、branchID对应网点号、busiID对应业务号、busiinfo对应业务信息（如图16所示）。将以上参数修改为（1）中记录的值后保存退出。图16 TestActiveX.html（3）双击打开“C:Program FilesADBCInterFaceSetUpTester”文件夹中的TestActiveX.html测试界面，查询成功，如图17所示。图17查询批次主界面5.2.3影像批次状态查询功能使用影像批次状态查询功能可以查询特定批次在上级缓存服务器中的状态。该功能一般用作批次操作的检查与诊断。具体操作步骤如下:（1）打开“C:Program FilesADBCInterFaceSetUpTesterTestImageOcx.htm”（图18）（2）输入影像批次业务号。（3）在服务器IP地址栏中输入要查询的缓存服务器的IP地址和端口号。（4）输入该批次对应的地区号。（5）点击“影像状态查询接口” ,系统会返回一个状态数值对应影像批次在上级服务器中的状态。具体请参照下表1说明。图18 TestImageOcx.htm界面状态查询返回值返回值意义PSPF1未处理002正在处理105待迁移026正在迁移127待清理038正在清理139迁移错误3212作废21表16.客户端程序更新说明6.1自动更新客户端每天首次调用影像控件时会检查是否需要进行程序更新，当程序判断需要更新时自动从服务器端下载更新文件。当更新文件下载完毕后，会提示客户端人员是否需要立即重启电脑，点击“是”，电脑自动重启，并在开机后自动执行更新程序。(图19)。图19重启提示6.2手动更新当不使用自动更新，即更新文件下载完毕后，提示客户端人员是否需要立即重启电脑时，点击否。之后如果需要更新文件，则退出程序后，直接在C:Program FilesADBCInterFaceSetUpInterface updatetemp文件夹下双击run.bat即可。（图20）。图20 run.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:Program FilesADBCInterFaceSetUpInterface目录下的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) 磁盘空间满返回值I186 duplex scan原因分析该错误原因可能为：磁盘空间满 解决方法清理磁盘 其他(11) 识别图像的分辨率和配置图像的分辨率不一致错误定义识别图像的分辨率和配置图像的分辨率不一致原因分析1.有可能是因为客户端版本不对，识别控件的版本无法识别影像；2.影像文件元数据损坏（实物扫描一般不会有这问题）3.识别程序有缺陷解决方法1.检查影像控件目录.Interfaceconfig.ini文件，里面记录了当前影像控件的版本号，确认版本是否为生产/测试最新版本；2.如果是使用独立安装的影像客户端请运行C:Program FilesADBCInterFaceSetUpInterface 下的ImgReg.bat文件；其他如果问题无法解决，请提供：1. .Interfaceconfig.ini文件中的版本号；2. 影像文件；(12) 版面识别失败错误定义版面识别失败原因分析1.有可能是因为客户端版本太旧，识别控件的版本无法识别影像；2.影像文件元数据损坏（实物扫描一般不会有这问题）3.识别程序有缺陷解决方法1检查影像控件目录.Interfaceconfig.ini文件，里面记录了当前影像控件的版本号，确认版本是否为生产/测试最新版本；2.如果是使用独立安装的影像客户端请运行C:Program FilesADBCInterFaceSetUpInterface 下的ImgReg.bat文件；其他如果问题无法解决，请提供：1.Interfaceconfig.ini文件中的版本号；2影像文件；(13) 获取影像批次号失败错误定义影像故障，获取影像批次号失败原因分析比较有可能是系统安装了多套应用控件，而当前正在调用的影像控件并非已注册的控件；解决方法使用ImgReg.bat对影像控件进行注册；其他如果问题无法解决，请提供path变量值和错误界面截图；(14) 传输异常返回值E9 错误定义传输异常原因分析影像在传输过程中发生了异常；解决方法需提供以下信息进行分析:1、报该错误的影像批次号；2、影像缓存服务器的RunLog日志其他7.2查询批注操作中的常见问题(1) 影像查看异常错误定义IE8影像查看异常 原因分析可能原因：1.未加入信任站点；2.安全设置级别设置为低解决方法1.在IE设置中将访问的站点加入信任站点