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