单实例多法人修改方案V08

1、山东省城市商业银行合作联盟有限公司图形前端项目图形前端单实例多法人改造方案V0.8厦门恒隆兴信息技术有限公司2012年10月22日文档版本记录文档信息主题日照村镇银行上线柜面系统升级改造创建日期2012年10月22日修订记录日期描述作者2012-10-22初稿郭正兴2012-10-262012-10-25号第一次评审后修改郭正兴2013-2-22指纹仪/客户端配置王占锋2013-3-12新增表：C001_TBANKCODEINFO,修改密钥标签，指纹仪加密方法移至S端。支付密码/影像渠道/电子验印配置移至C001_TBANKCODEINFO,同时兼容原有模式王占锋2013-3-21统一运行模式

2、变量私有客户端改造王占锋评审记录日期评审意见评审人2012-10-26李勇、余双全目录1概述42需求分析43技术实现53.1系统菜单权限模块53.1.1系统应用改造53.1.2数据库改造53.2授权复合模块改造53.2.1系统应用改造53.2.2数据库改造53.3私有业务模块改造63.3.1系统应用改造63.4文件处理模块改造63.4.1系统应用改造63.5服务端改造73.5.1多ESB服务器支持73.5.2外围服务器支持83.5.3密钥标签93.6其他93.6.1指纹仪驱动文件93.6.2ATM配钞交易103.6.3客户端配置103.6.49996交易改造104需要再确认问题111 概述图形

3、前端柜面系统支持单一实例多法人行。2 需求分析系统菜单权限存在不同法人行的菜单权限不一致的情况。简单授权中存在授权权利不一致的情况。电子验印不同机构做到不同机构连不同验印服务器。此需求在此次改造不做出来。只做到不同法人行连不同验印服务器。一个服务实例服务器允许挂多太ESBServer、多外围服务器（电子验印）。本次系统改造升级主要包括五个部分：系统菜单模块改造、授权复合模块改造、私有业务模块改造、文件处理模块改造、多ESB服务支持、多外围服务器支持。3 技术实现3.1 系统菜单权限模块3.1.1 系统应用改造Longtop.XBranch.ClientBase工程Longtop.XBranch

4、.ClientBase.BOTMenuLoader类中GetMultipleBizTradeMenuList方法从数据库取菜单。Longtop.XBranch.SCCBA.Main工程WindowMain.xaml.Partial.cs文件_menuTreeView_Init方法 加载菜单和CommonMessageHandle_PermissionsChange方法 转授权生效。9982交易修改。只能查询、修改本法人行下的权限。3.1.2 数据库改造新增C001_TMENUINFO_PRIVATE 表 私有菜单表。SHARE_RoleAndTranCode菜单权限表增加法人行列3.2 授权复

5、合模块改造3.2.1 系统应用改造Longtop.XBranch.Authorize.Client. AuthorizeHandle类中ExecAuthorize方法，授权判断时使用的SQL语句修改增加法人行条件。Longtop.XBranch.Authorize.Maintenance.FrmTauthorizesimple（简单授权判断条件）类中查询时的SQL语句增加法人行条件。Longtop.XBranch.Authorize.Client.FrmRemoteAuthorizedConfiguration（远程授权配置，没做完）类中查询、录入、修改、删除功能的SQL语句增加法人行条件。L

6、ongtop.XBranch.Authorize.Client。3.2.2 数据库改造TELLER_TAUTHORIZESIMPLE简单授权表增加法人行列TELLER_TAUTHORIZEREMOTE远程授权条件表增加多法人列TELLER_TDOUBLECHECK加多法人列TELLER_TCHECKFIELD 复合域定义表增加法人行列（暂时不错差异化处理）3.3 私有业务模块改造3.3.1 系统应用改造私有客户端：810/812客户端保持不变；811行SCCBA.Common.dll更改为SCCBA.Common811.dll，PrivateService_Interface.dll文件更改为

7、PrivateService_Interface811.dll，811行私有交易程序修改命名空间。3.4 文件处理模块改造3.4.1 系统应用改造1.esbfts.cfg配置文件格式不变根目录下esbfts.cfg保持不变，新增加Config810esbfts.cfg文件2. FtpServerCache.config，修改card/record用户名和FTPRootPath.3.ftp服务器需要按法人行创建用户（card/cup/record）（card810/card811/card812）； 4.Longtop.XBranch.SDUnion.Common.CommonCache类中Es

8、bFtsCfg属性通过传递法人行号给服务端对象查询缓存：RunInfo.Instance.ServerCacheInterface.GetEsbFtsCfgByServerCache(BranchID)；5.Longtop_Server. Remoting_Interface_Imp类的EsbFtsCfgServerCache修改成GetEsbFtsCfgByServerCache(string BranchID)方法；6.ServerCache_Interface. IServerCache_Interface接口：EsbFtsCfgServerCache 属性修改成GetEsbFtsCfg

9、ByServerCache(string BranchID);代发工资（测试）9993、9996交易（测试）AGFilePrefix 保持不变：从SHARE_TradeSetting 表中读取3.5 服务端改造3.5.1 多ESB服务器支持保持原有根目录Longtop_Server.exe.config不变新增配置文件：Config810Longtop_Server.exe.config新增公共部分的配置文件：ConfigLongtop_Server.configLongtop_Server.CommonMessageHandleServer.SendMessage,中增加通过法人行号路由不同

10、ESBserver代码。增加SendMessageToSocket方法重载：public static byte SendMessageToSocket(byte content, string bankCd, bool shutDownSend)public static byte SendMessageToSocket(byte content, string targetIP, int targetPort, bool shutDownSend)3.5.2 外围服务器支持电子验印<addkey="Seal"value="1:880

11、0"/>支付密码<addkey="Szmc"value="1:8800"/>渠道影像<addkey="CheckSeal_6851" value=":37713"/>保留根目录下Longtop_Server.exe.config:修改同ESB配置，修改配置文件存储路径：Config810Longtop_Server.exe.config服务端修改Longtop_Server.Remoting_Interface_Imp类中publi

12、cbyte SendSocketMessage(string msgID, byte msgContent, bool shutDownSend)方法，增加多法人参数。public byte SendSocketMessage(string BranchID, string msgID, byte msgContent, bool shutDownSend)：电子验印/渠道影像/支付密码会调用此方法，目标主机IP/PORT已移至C001_TBANKCODEINFO表中，同时兼容在Config810Longtop_Server.exe.config文件中的原有格式。优先取配置文件中的IP，如果不

13、存在，则去数据库表中取。IService_Interface接口中，保留原有byte SendSocketMessage(string msgID, byte msgContent,bool shutDownSend);方法，新增加重载方法，添加多法人参数。（没有被调用）byte SendSocketMessage(string bankID, string msgID, byte msgContent, bool shutDownSend);方法内增加通过法人行取Socket地址代码。（没有被调用）客户端修改Longtop.XBranch.SDUnion.Common CommonLogi类

14、中CheckSeal_6851、SendMessageToSocketForManuSeal、SendMessageToSocketForSzmc方法在触发SendSocketMessage方法时增加法人行参数3.5.3 密钥标签新建表：C001_TBANKCODEINFO：在server端配置文件中增加报文类型及对应的目标主机(OBSV)：可以根据不同的报文类型配置不同的esb目标主机，可配置不同的bmk；<add key=Common Value=ESB/>指纹仪可配置独立的bmk，目前与esb通讯主密钥相同。3.6 其他3.6.1 指纹仪驱动文件FingerService.d

15、ll1.东营的驱动文件和泰安的驱动文件文件名称一致但是需要放在根目录法人行目录下面并且它们不能通用。动态调用DLL实现方法：1) 新增DLD类来管理kernel32.dll中API函数 LoadLibrary（或MFC 的AfxLoadLibrary），装载动态库。 GetProcAddress，获取要引入的函数，将符号名或标识号转换为DLL内部地址。 FreeLibrary（或MFC的AfxFreeLibrary），释放动态链接库。2) 新增DllTypeModule类，来创建实例模型。加载DLL时可以通过DLDll.LoadDll(lpFilePath)动态加载指定目录DLL文件。3) 新

16、增DllMethod类，来实现实例模型中的方法。通过把非托管dll中函数指针转换成.net委托来实现4) 增加实例模型的析构方法，调用UnLoadDll (IntPtr hModule)释放加载的dll2.指纹仪具体调用方法：1) 法人目录下需要存放不同法人行DLL文件。Finger类中，只需把原来直接调用FingerService.dll中一些方法改为调用DLLMethod类中对应方法即可，其他调用无需修改。2) 指纹仪加密方法放到server端处理。3) 指纹仪ip/port/bmk从C001_TBANKCODEINFO中取值，目前指纹仪bmk与ESB通讯主密钥保持一致.3.6.2 ATM

17、配钞交易ATM权限配置交易9804需要修改查询时增加校验，只能查询本法人行的柜员和ATM柜员。录入、修改时只能操作本法人行的柜员和ATM柜员。0468ATM配钞时不能夸法人行配钞票（原程序已有控制，无需改动）3.6.3 客户端配置1. 修改Longtop.XBranch.SDUnion.Common.CommonCache类中1) ConfigOfClient属性需要修改，增加法人行查询条件。select * from C001_ClientConfigInformationC001_TellerLoginMode表和C001_ClientConfigInformation表合并2) Long

18、top.XBranch.SDUnion.Common. CommonCachele类中，增加ConfigOfClientofSystem变量（客户端使用的配置系统，此变量存放系统级别信息，C001_ClientConfigInformation表中机构是999的信息）修改ConfigOfClient：调用此变量是首先要确定法人行号RunInfo.Instance.UserInfo.BranchID存在，否则抛出异常。3) 运行模式（生产/测试模式）a) 在C001_ClientConfigInformation增加Key=RunMode，ValueProd/Test,此值法人行号为999，只能

19、存在一条记录。如果存在多条记录，在ConfigOfClientofSystem中加载此表示报异常。b) 增加LoginMode类，其中TellerLoginMode属性设定为最终登录模式。如果C001_ClientConfigInformation中RunMode值不为Test，则为生产模式，需要新增BankID.config文件：<configuration><appSettings><add key="bankid" value="811" /></appSettings></configurat

20、ion>2. 生产上，安装文件打包时需要增加此文件。如果此文件不存在，则弹出窗口（FrmBankID），让柜员输入法人行号，同时写入到BankID.config中。登录模式（Password，Finger,Card）1) 生产模式下，登录模式取C001_ClientConfigInformation表中TellerLoginMode；2) 测试模式下，登录模式在代码中固定为Password。需要修改的调用：WindowLogin.xaml.cs UserControl_LockSystem.xaml.cs UCAuthorizeLocalUser.cs由原来 TellerLoginMode = CommonCache.tellerCheckMode.enumTellerCheckMode;改成 TellerLoginMode = LoginMode.TellerLoginMode;3.6.4 9996交易改造C001_DIReportList表做法人行判断。3.6.5 1811交易加密改造 1811