图形前端使用手册及常见问题汇总 V1.0.doc

图形终端安装文档 图形前端使用手册及常见问题汇总 山东城商联盟 2015年09月 22日 图形前端使用手册及常见问题汇总 1 前提条件与要求 1.1 硬件配置要求 配置项 具体配置 操作系统 Windows Embedded Standard，及以上版本 硬件配置 （1） CPU, 1.60GHz （2） 内存：最低512M，推荐1G； （3） 硬盘：20G； （4） 1块网卡； 软件配置 （1） .Net FrameWork 3.5 SP1； 2 卸载终端程序（如果目前终端已安装CBUS@SCCBA，执行此步骤） 2.1 卸载程序 点击“开始”->“设置”->“控制面板” 进入控制面板 点击，进入“添加或删除程序” 鼠标单击->点击，弹出 选择，卸载即可 2.2 删除安装目录 在桌面点击->-> 删除即可 3 安装终端程序 3.1 安装Net Framework 3.5 Sp1 打开控制面板-添加删除程序，检查是否存在Net Framework 3.5 Sp1，如图： 如果不存在，请点击Net framework 3.5 Sp1安装包，按照提示，一直点击下一步，直到安装完成为止。 Windows 7及以上系统点击打开“控制面板”---“程序”---“打开或者关闭windows功能”选择microsoft .net framework 3.5.1确定即可。 3.2 安装程序 方式1：从其他已安装的机器上，找到安装目录，拷贝一份。即可使用。 方式2：双击CBUS客户端安装程序.exe，点击下一步进行安装。安装完成后，桌面会出现快捷方式： 是客户端；系统菜单项“开始”->“程序”里面会增加 3.3 CBUS@SCCBA 单击该菜单，启动客户端程序； 注意：第一次启动时，客户端需要从服务端下载所有的组件，需要花费一段时间，请耐心等待； 升级完毕后，展示如下柜员登录界面： 3.4 修改连接主机 3.4.1 免安装方式下修改连接的服务器主机 1、打开图形前端程序目录找到 XBranch.SmartClient.exe.config -----------------用于版本更新 Longtop.XBranch.BOT.Main.exe.config -----------系统所连主机配置 修改里面相应IP/域名地址。端口号不要修改，只修改IP/域名 2、点击下图中的圆点，选择通讯主机设置，选择连接主机的ip地址。 3.4.2 系统安装方式下修改连接主机 如下图 点击 默认当前连接主机如下： 服务器IP地址列表里面分别是莱商、莱商村镇各自的域名，各自选择自己的域名 点击测试，测试通过后点击确定保存即可。 双击桌面快捷方式，或点击系统菜单项启动客户端，客户端自动更新到最新版本后弹出登录窗口后即可登录 3.5 设备与端口要求 3.5.1 安装前检查端口对应是否正确： 刷卡器： COM2 密码小键盘：COM3 如果图形前端的设备使用端口与本要求不一致，点击以下程序 会弹出如下界面： 密码键盘（实达通用版）一般为com3口，波特率1200，刷卡器则为com2口，波特率为9600。如果不一致，请修改串口，波特率以及型号，然后点击测试，直到密码键盘提示请输入密码，刷卡器绿灯亮即可。测试完后，点击确定后，保存设置。 3.5.2 高速流水打印机相关要求 1、 直连打印机的机器配置： 点击：开始->打印机和传真，如下图： 点击添加打印机 弹出窗口，如下图： 选择如下图，点击下一步； 选择如下图，下一步： 点击下一步： 弹窗如下：选择Epson驱动：Epson LQ-1600K，点击下一步： 打印机名默认即可，是否设置默认打印机，选择“否”： 不共享，点击下一步： 点击完成 添加的打印机会出现在打印机窗口，添加完成； 配置完成后，打印测试页，正常打印则设置成功。 否则请检查： 1）确认打印机网络正常； 2）确认配置过程与上述操作一致，如需要重新配置，删除上图打印机，重新添加； 2、 在接高速打印机的机器上（终端或PC上）把打印机设置为共享模式： 进入“控制面板”->“打印机和传真”，鼠标右键点击，或者EpsonLQ1900KII， 点击“共享”， 选择“共享这台打印机”，点击“确定”按钮。 B.在需要连高速打印机的两台终端上设置如下： 点击“开始”->“运行（R）” ， 输入该高速打印机的ip地址（188.185.3.100 替换为本网点的高速打印机的IP），如： 点击“确定”，进入 双击 （上述共享打印机的图标） 通常会有如下提示： 点击，出现以下窗口即安装成功 4 图形前端流水打印机配置及快捷键功能说明 4.1 概述 经测试人员及业务人员反映，目前图形前端系统依赖鼠标操作现象比较严重，希望图形前端能参照字符增加一些快捷键支持，可以方便柜员快速交易。系统新增部分快捷键功能，以使图形前端操作人员方便、快捷地操作系统。 4.2 功能说明 1、后台流水打印机配置 第一次进入系统时进入9996交易画面，按Ctrl+F12配置流水打印机，只需配置一次保存重新进入后续不需要再配置。具体选择流水打印机如下： 2、查询类交易查询结果为表格的，增加快捷键支持: Hom——首条记录 End——尾条记录 Pgdn或Alt+P——下一页 Alt+Q——查询 Alt+E——导出 F12——柜面打印 F11——流水打印 注意：当柜员按F12/F11的时候，系统直接进行柜面/流水打印，不再像之前那样提示。 3、F3记忆键：柜员做完某一个交易后，如需重做该交易，只需输入交易代码，然后按F3键来反显上次该栏位输入的内容。 注意：该功能只能记忆前一个交易的输入，当柜员点击提交按钮的时候触发记忆功能，紧接着再进入该交易便可采用F3来记忆上次输入。 4、9996交易快捷键优化，查询出结果后： Home/End——导向到首/尾条 Enter——浏览报表 Ctrl+F12——设置打印机--（第一次进入系统时进入9996交易画面，按Ctrl+F12配置流水打印机，只需配置一次保存重新进入后续不需要再配置） F12——柜面打印 F11——流水打印 Ctrl+T——打印选中报表 Ctrl+A——打印所有报表 Ctrl+A——打印所有报表 Ctrl+B——指定页码打印 注意：选择哪些报表必须采用鼠标来实现，因为柜员有可能只选择其中某几行数据进行打印。与其采用快捷键让柜员选择/取消，不如放给柜员采用鼠标操作。只是选择完毕可以用快捷键Ctrl+T打印选中目标集合。 5、复制快捷键：Shift+F10 进入交易后按下Shift+F10会弹出窗口 拖动此图标到要复制的栏位上就能复制该栏位的信息到粘贴板。 4.3 适用范围 本功能在使用图形前端的成员行使用。 5 柜面打印机参数调整 1、 按着退出键开机，开机后一直按着，不松手，直到显示屏上提示load paper，放入A4纸，打印打印机参数。 2、 选择打印正常打印机，打印参数，比较两台打印机不一致参数，一般是页顶即打印机中的OKI-top pos参数不一致。 3、 关闭打印机，重新长按确认键开机，直到显示屏出现online no paper提示，松开确认键，按停止键，屏幕界面显示STOP，再按确认键，屏幕提示Menu，按用户1、用户2键，调整菜单，调整到指定菜单，按确认键，进入子菜单，再按用户1、用户2调整菜单，调整到指定菜单，按确认键，进入调整界面，按用户1、用户2键上下调整，调整完成后确认。 4、 按停止键，知道停止键灯亮起，完成设定，重新打印凭证，验证打印是否正常。 6 图形前端服务端 6.1 服务器要求 数据库服务器： 配置项 具体配置 机器型号 IBM Itel® Xeon® 操作系统 Windows 2008 R2 企业版 硬件配置 （5） CPU 6C，E5506 @2.13GHz, 2.13GHz （6） 内存：16G； （7） 硬盘：500G；（C:100G D盘：100G E盘：300G） （8） 2块千兆网卡； 软件配置 （2） SQL Server2008企业版，连接数150-200 数量 1台。 应用服务器： 配置项 配置 机器型号 IBM Itel® Xeon® 操作系统 Windows 2008 R2 企业版 硬件配置 （1） CPU 6C，E5506 @2.13GHz, 2.13GHz （2） 内存：16G； （3） 硬盘：300G； C盘：100G D盘：200G （4） 1块千兆网卡； 软件配置 （1） .Net Framework 3.5 SP1. （2） xBranch服务，公有版本服务器 （3） 私有业务服务 数量 根据每台服务器带300个终端计算 建议数据库服务器、应用服务器采用部署虚拟机来实现。有服务器Down机时，可以及时备份还原。不需要单独的备机。 图形前端版本机： 配置项 配置 机器型号 PC机器 操作系统 Windows xp、2003、2008及以上版本 硬件配置 （1） 双核 （2） 内存：4G； （3） 硬盘：100G； （4） 1块千兆网卡； 软件配置 （1） .Net Framework 3.5 SP1. （2） 图形前端版本发布工具 数量 1台 LVS负载均衡服务器： 配置项 具体配置 操作系统 Redhat6.2（ 64位） 硬件配置 (1)CPU 2C (2)内存：4G； (3)硬盘：（>100G） (4)2块网卡； 数量 2台 6.2 服务端程序 服务器启动后，需要启动的程序： APP服务器： 从左至右依次是图形前端主服务，联盟网关通讯组件，图形前端私有服务，图形前端健康监控程序。 DB服务器： 从左至右依次是图形前端主服务，文件传输服务，单点登录服务，图形前端健康监控程序。 注意：数据库相应服务设置为开机自动启动，一般无需手动启动。 版本机服务器： 从左至右依次是图形前端健康监控程序，机器人探测程序。 6.3 客户端访问服务端端口 APP服务器： 8990端口。客户端telnet ip地址 8990 需要通。 8991端口。客户端telnet ip地址 8991 需要通。 DB服务器： 2300端口。客户端telnet ip地址 2300 需要通。 7 版本更新问题 1、 删除安装目录下的XBranch.SmartClient.exe.Update.inf 文件可进行全量更新。 2、 点击下图中的圆点选择更新设置，进行全量更新。 8 生产问题上报 在生产环境各网点交易报错时，为了第一时间将错误信息上报联盟相关人员确认，图形前端支持网点问题上报功能，柜员在做业务过程中如果遇到交易报错，交易失败情况，保持交易画面不要关闭。点击图形前端上端工具栏中的 “助手”按钮。如下图： 并在弹出框中描述相关信息，点击确定，可以把错误信息快速上报 前端服务器，然后电话通知联盟运维人员，这样运维支持人员可以迅速到生产环境查看相关错误信息，对问题进行快速定位。 9 客户端目录结构 10 9802权限配置 △、9802功能子码控制下拉键值 相关栏位要在9982里配置(注意：需要配置栏位FelidBingdingName必须有值才能控制下拉表) 注意：暂时不支持控制子交易的下拉菜单： 目前传入的还是主交易码，无法控制子交易的下拉菜单（9901_1）。只能控制主交易的交易码（9901）。 （Longtop.XBranch.SDUnion.ClientCommFun  LinkTx.cs） 11 9981、9982授权配置 9981 9982 9981配置授权条件，9982里配置为授权条件的栏位名称。 注意：目前系统只支持通过功能码、功能类型、币别和金额这些条件进行授权。 △、联动交易子交易需要配置授权 交易代码需要配置子交易带_的交易代码 如：9901_1 联动时候对frmSDUnionBase.OperatorCodeForAuthorize = TxCode;赋值为9901_1 授权时候 ExecAuthorizeNew  //如果是联动模式。 3001交易号就是3001_1,或者 3001_2等等。             if (frmSDUnionBase.OperatorCodeForAuthorize != null)                 opCode = frmSDUnionBase.OperatorCodeForAuthorize; 配合9982 配置相关子交易9901_1功能码栏位，可以区分功能码进行授权。 12 常见问题 12.1 前端常见报错： △、数组越界，一大串英文，999999错误码。 未将对象引用设置到对象的实例（object reference not set to an instance of an object）--需具体问题具体分析。 999999 发送主机失败：文件传输问题，主动传输不通。 999999上传文件到ftp失败：前端ftp连接不上。 exception from hresult ：缺少集中授权ocx控件。如不需要配置集中授权，9981改为本地授权。 由于目标计算机积极拒绝，无法连接。127.0.0.1:9018—通讯组件没启动或异常。 输入栏位个数于输入流的定义--版本不一致。 12.2 ESB常见报错： △、E开头的错误。 E000A703：--核心超时。 E000A515：验证MAC错误快速通道报文MAC校验失败—密钥不同步，前端同步密钥。 E000A515 Mac valid err.—校验密钥失败，程序bug 系统卡死，线路出现故障，请查询本交易是否成功。-- esb没返回数据 由于连接方在一段时间内没有正确答复或者链接主机没有反应，链接尝试失败。--esb没返回。 12.3 核心常见报错： △、G开头错误码，核心各组的错误。 cics 错误，押码值不符 SDB02：DBICALLERROR,TABLE=BECIDIY5，CQLCODE=-0911—平台报错。 STP01：程序模块不存在，PROGRAM GCROC5302 NOT FOUND!—平台报错。 12.4 双击登录快捷方式出现错误，如图 解决办法： 点击“确定”，关闭已打开的图形客户端，然后重新运行客户端程序进行版本更新。 如下图： 注意：更新过程中，更新程序不允许关闭，请耐心等待！ 12.5 存款类交易写磁或读磁不成功 解决办法： a. 检查写磁时金卡键盘的“WRITE”（写磁）或“READ”（读磁）绿灯的是否亮启：如果未亮启，检查金卡键盘的电源线连接良好；如果亮启，确认刷折时平滑，中间过程无停顿 12.6 银行卡类交易读磁不成功 解决办法： 同6.2 12.7 不能输入密码 解决办法：参见3.5.1 12.8 连线报表交易后，高速行打流水打印机不能打印 解决办法： 1、 检查控制面板---打印机下，是否有共享的高速打印机。 2、 登录进系统，进入9996交易， 按住F12，用来选择是存折打印还是流水打印。 按住F12，再按Ctrl+F12，重新设置流水打印机。 3、 如果前两个步骤还没解决请进入 D:\Program Files\SCCBA\XBranch.SmartClient 打开Longtop.XBranch.BOT.Main.exe.config配置文件，将<add key="FlowPrintName" value="" />标签删除。在连线报表中重新选择高速行打打印机。 12.9 关于签退死机或者系统报内存不足的问题 终端机器初始的时候统一的未设置虚拟内存，在程序执行一些消耗内存比较大的交易后，容易出现内存不足的问题。出现该问题后，设置我的电脑-属性-高级-设置-高级-虚拟内存（设置），设置相关的内存。 12.10 双击CBUS图形前端图标没反应 问题描述：双击CBUS图形前端图标没反应。 问题原因：未安装.net或.net被破坏。 解决方案：联系计算机管理员重新安装.net 3.5安装包。 12.11 登陆界面小黑框，界面模糊，登陆界面下拉框没有键值 显卡驱动问题，重新安装显卡驱动。 12.12 前端登陆窗口出现 口口口 乱码。 编码集丢失，重装系统。 12.13 全量更新报lpk.dll文件被占用 感染lpk病毒，全盘杀毒或者全盘搜索lpk.dll删除除了system32目录以外的所有lpk.dll 12.14 打印数据量太大（上百页）无法发送流水打印机 由于以前字符系统采用的是连接流水打印机延伸器的模式，由于延伸器缓存有限，几百页的数据量超出了延伸器缓存。 解决方法：去掉延伸器采用流水打印机直连windows系统，共享打印机的方式。设置见3.5.2。 12.15 原字符系统有特定交易清除未打印完不需在打印的任务，图形系统无此功能 由于打印方式的不同，图形系统不支持交易清除打印任务。 解决方法： 流水打印机延伸器连接：重启延伸器。 流水打印机共享连接：在与打印机直连的系统里清除打印队列，已经发送到打印机的任务重启打印机即可。 12.16 做中间业务1777交易时，联动不到字符交易界面，报错“login:TUXING ...” 键盘上按下了[Caps Lock]大写键，关闭大写键锁定。 12.17 刚开始可以正常登录图形系统，过一段时间之后再登录时，报错【应用程序正常初始化(0xc000007b)失败，请单击“确定”，终止应用程序。】 经排查，确认终端中了"Mydocument"的病毒，几乎所有终端都被感染。同样的代码生成的exe,与中病毒的exe文件的大小是不一样的，中病毒的exe一般会大几十kb。比如，smartclient.exe 正常大小504kb，感染后大小为540kb。 "对所有终端进行重装系统及环境。 (建议：其他软件exe可运行，没被篡改，cbus的exe被篡改了，大小改变了，是否可以采取措施使exe不被篡改) 安装360企业版，可以防护，但是并不能彻底清除病毒，若关闭杀毒软件，则立即会感染。" 12.18 很多交易报错"提交事件出现异常：Select * from..." 前端服务器在做交易过程中刷缓存了。缓存刷新成功后重做交易。 12.19 读卡时报错"access to the port 'COM3' is denied" com口被占用，重启系统。 12.20 交易没权限，进不去交易 有菜单进不去交易：全量更新。更新后进不去为前端数据库版本不对，重新发版。 没有菜单报没有权限：检查是否配置权限。如果权限配置正确，联系前端开发人员检查程序菜单。 12.21 打印凭证偏移，错行。 检查打印机偏移量配置。 12.22 打印凭证乱码。 检查打印机驱动是否配置正确。检查打印机连接端口和打印机连接线是否异常。 12.23 预览正常打印内容缺失 检查打印机驱动。微软自带的5330sc，如果超出打印范围的内容自动舍弃掉。换为官方驱动解决。 12.24 弹窗有授权 前端授权表里有空白行。 12.25 打印时弹出保存打印文档 没有配置柜面打印机。 12.26 刷卡器、密码键盘等待时间短。 修改前端刷卡器密码键盘等待时间。修改客户端根目录Longtop.XBranch.DeviceManager.dll.config配置文件 改为：<ReadTimeout>20</ReadTimeout> <WriteTimeout>30</WriteTimeout> 或者： 打开外设配置工具，在相应的配置点击确认，可以默认保存密码器刷卡器读取20秒，写入30。 12.27 设置打印预览（取消打印预览） 修改主配置文件Longtop.XBranch.BOT.Main.exe.config <add key="AutoPrint" value="0" /> 0：有打印预览 1：无打印预览 12.28 密码通过笔记本键盘输入 修改主配置文件Longtop.XBranch.BOT.Main.exe.config <add key="PinpadIsManualInput" value="false" /> false:密码键盘输入 true：笔记本键盘输入 12.29 授权不生效 检查9981、9982是否配置正确。 注意：9981里配置的为授权条件的栏位都需要在9982里选择配置，选择后返回值为空为程序问题，需要提需求优化。 12.30 下拉框没有键值，或者缺少键值 1.该栏位键值为前端维护： 检查客户端sd_field里是否有该键值，确定是否为版本问题。 2.该栏位键值为核心下档： 检查客户端sd_field_法人行号 里是否有该键值，确定是否为下档问题。 3.检查9802权限是否配置了该功能。 4.检查是否多法人配置，特别注意是否是数据库SHARE_TradeFieldSetting里配置的多法人。 12.31 导出excel文件时报错 客户端要安装微软office，不能安装wps。 12.32 按f11、f12不进行屏幕打印 由于键盘类型的差异，有些键盘需要按alt+f11，alt+f12进行屏幕打印。