用友股份-LE服务支持部技术方案--《XML文件结构说明》建立日期：2013-06-01修改日期：xxxx-xx-xx文档属性：客户文控编号：LE-DY-JS-2013-00622/24文档控制创建记录审阅人姓名所属部门职位审阅签字发布人姓名所属部门发布时间日期作者所属部门邮件地址版本2013-06-01V1.03目录XML文件结构说明...................................................................................................................4一、配置文件基本结构............................................................................................4二、XML文件具体字段属性说明............................................................................51.属性列表.....................................................................................................62.属性列表......................................................................................................73.属性列表..................................................................................................10三、特殊XML配置文件说明.................................................................................101.banktype.xml银行类型设置..............................................................................102.currencymapping.xml币种转换设置.................................................................123.*_ret.xml文件.....................................................................................................144.obmconfig.properties文件..................................................................................155.obmlicenseconfig.properties文件.......................................................................17四、XML配置文件支持银行..................................................................................17五、XML配置文件功能编码..................................................................................20六、XML配置文件数据类型..................................................................................21七、XML配置文件支持公式..................................................................................214XML文件结构说明一、配置文件基本结构所有的xml配置文件的文件结构都基本相同，文件结构分为3级：、、，其中为可选。定义配置文件的基本信息，如银行标志码、功能编码、公式解析类等。定义具体的每个发送往银行的字段的各种信息属性。当中定义的数据类型为6（下拉列表）时，在中定义下拉列表内容。所有信息的属性取值都要写在双引号内。具体见工行推广版普通支付功能xml配置文件，如图：5二、XML文件具体字段属性说明注：所有属性都为小写字母61.属性列表属性取值说明bank银行代码(见附录A)对应银行唯一标识号func功能代码(见附录B)对应银行功能编码roottag[input]：输入；[output]：输出区分输入输出，没有实际作用type空值预留没有实际作用formula1设置处理公式的类名称公式处理类名称（包名+类名）例如：formula1="nc.vo.obm.formula.FormulaParser"其中nc3.5和nc5.5不同，nc3.5为：formula1="nc.bs.ebank.pub.Formula"以上为必要属性，此外还有height，width非必要属性，在pay.xml格式中可以约束网银补录界面的长宽值。72.属性列表属性取值说明bulu[N]：不需要补录；[Y]：需要补录网银补录界面，点击复制功能，是否复制此字段。datatype数据类型(见附录C)数据的类型，如字符，数值等类型，和单据模板类型相同。defaultshowname汉字显示内容defaultvalue默认值默认值digit整数用来设置数字值的精度dstitemkey发送字段NC网银字段传入网银适配器中对应的字段名称editflag[N]：不可编辑[Y]：可以编辑字段在网银补录界面是否可编辑execformula注册操作该字段NC网银对传入字段进行数据再加工时使用公式8的动作(见附录D)itemkey字段key值由不同银行来规定需要传入的字段，需要参照各银行接口文档length整数字段长度，如果不填写该属性，则默认20位（10个汉字）maxvalue一般不使用最大值minvalue一般不使用最小值newlineflag一般不使用换行标志nullflag[Y]：不可以为空[N]：可以为空字段是否可以为空reftype数据类型为参照类型时，在此注册参照类。参照类型，格式示例如：reftype="<nc.ui.bd.b23.AreaCodeRefModel>"9resid多语言资源ID系统预制，新增字段不需要填写，示例如：resid="UPP36120101-000277"，需要注册多语。showflag[N]：显示[Y]：不显示网银补录界面是否显示该字段showorder整数在网银补录界面中的显示顺序source[bill]：单据[system]：系统[dbtacc]：付款账户[crtacc]：收款账户[account_num]：账户（用于余额查询）确定NC网银字段取自哪一个数据集具体说明参考xml数据集说明。10srcitemkey数据集key值确定NC网银字段取值于对应数据集中的对应key值的value值，默认数据集为billwidth整数，默认1网银补录界面该字段显示宽度3.属性列表属性说明defaultshowname下拉列表项的显示内容defaultvalue下拉列表项的对应值resid下拉列表项的显示内容的多语言资源ID（可选）三、特殊XML配置文件说明1.banktype.xml银行类型设置银行类型设置，该文件主要用于设置银行账户档案中定义的银行类型与网银适配器中定义的银行类型之间的转换，并对银行的一些功能进行配置。11有的银行会提供两个网上银行系统，在使用时一定要分清楚，不要把网上银行类型与开户银行档案中的主办银行搞混。如：对于工商银行，其网上银行系统有三个，如下图设置中的第1，2，3行。正常使用不需要修改该配置文件，该配置文件已经预置了目前NC系统支持的网上银行，系统支持的银行列表参见()。二次开发需要增加新的网上银行类型，修改该配置文件的说明参见网上银行的增加新银行说明。banktype.xml特殊字段属性值说明12属性说明nbanktype对应的网银信息模板设置的模板编码客户化->基本档案->结算信息->网银信息模板设置banktype对应银行类别节点对应的银行类别编码客户化->基本档案->结算信息->银行类别sbanktype对应该银行接口的唯一标识码bankname银行网银接口名称jtgj是否启用集团归集接口jtzf是否启用集团支付接口maxdays对账单一次性发送网银的天数限制totaldays对账单一次性下载的天数限制2.currencymapping.xml币种转换设置如图所示：13币种转换设置，该配置文件用于将银行的币种与NC的币种互转，curr字段是NC的币种PK，transcurcode字段是银行使用的币种编码。在system目录下的currencymapping.xml文件定义的是默认的币种转换，如果某银行使用特殊的币种描述，可将该文件coyp到对应银行的配置文件目录下，将transcurcode字段值改为该银行的币种。如果需要增加币种类型，直接增加一行row元素即可，如增加美元，银行对应返回美元的编码为USD，则加入下面内容即可：currencymapping.xml特殊字段属性值说明属性说明currnc对应币种的pk值。currcode币种的描述，非必输。14transcurcode银行返回的对应币种的编码。银行返回的编码，在不同项目并不是固定的，如人民币，可能返回RMB，也可能返回01，也可能是CNY，需要根据不同项目银行的规范灵活配置。3.*_ret.xml文件银行各功能指令执行后，返回给nc指令后，从指令中取值的配置文件。每个功能都需要配置该配置文件。一般*_ret.xml文件都会配置到nchome\resources\ebank\system路径下作为默认文件，所有银行都使用改文件。如果银行要求特殊，不符合公共配置文件，则在自己对应银行内单独配置*_ret.xml文件。如图：154.obmconfig.properties文件nc网银系统参数文件。如图见：16上面只是一部分，主要内容是配置网银加密，签名等功能的注册。具体参数都有说明，不再进行详细说明。175.obmlicenseconfig.properties文件配置自定义银行license的文件。如图：根据配置自定义银行说明文档配置完毕，购买license后，在此文件中注册自定义银行唯一标志码。注意：deflicense1等参数key值，不可以更改。四、XML配置文件支持银行网银如果要支持某银行功能，则必须根据银行提供的接口文档，针对不同的接口类别，发送，返回字段配置xml文件，在nc5.6中，支持了24家银行，30个网银接口。银行代码银行名称代码北京银行bccb18交通银行jtyh中国银行cb建行重客ccb建行外联ccbn光大银行ceb兴业银行xingye中信银行zx招商银行cmb民生银行cmbc农行专线cme农行公网cmen广发银行gdb华夏银行huaxia工行普通icbc19工行推广icbcpb工行专业icbcpr日本瑞穗-日本rbrs_rb日本瑞穗-大连rbrs_dl日本瑞穗-上海rbrs_sh上海浦发spdb深圳发展sdb日本三菱btmu中国电力财务fbos农商行brcb花旗银行ctd上海银行shyh平安银行szpa中国邮政储蓄psbc20徽商银行hsb五、XML配置文件功能编码功能代码功能代码余额查询ye明细（对帐单下载）mx支付zf支付查询zfcx集团支付jtzf集团归集jtgj代理支付dlzf代理支付查询dlzfcx代发代扣（支付）dfdk代发代扣查询dfdkcx21六、XML配置文件数据类型数据类型数据类型取值字符0整数1小数2日期3逻辑4参照5下拉列表6自定义项档案7时间8七、XML配置文件支持公式Nc5.0及以后版本，公式处理类为：nc.vo.obm.formula.FormulaParser22nc3.5及以前版本，公式处理类为：nc.bs.ebank.pub.Formula支持公式公式说明trimByLen(Stringitemkey,Integerlen)从后面截取字符串len长度的字串例如：trimByLen(packageid,12)取packageid字段的后面12位getEColValue(StringtableName,StringselectFieldName,StringwhereFieldName,StringwhereFieldValue)从指定数据表中取某字段的值tableName:数据库表明selectFieldName:要查询字段名称whereFieldName:查询条件字段whereFieldValue:查询条件字段值例如：getEColValue("bd_bankarea","areaname","23areacode",rec_area_name)从银行地区表中，根据地区编码取出地区名称trancurrcode(Stringbank,Stringcurrency)将NC中的币种编码转换为银行格式的币种例如：配置文件中写下面的公式trancurrcode(bank,account_cur)系统会自动用当前bank的值和account_cur的值调用该公式，转换成该银行需要的币种格式parseNusageToReconciliationCode(Stringnusage)将对账标志码从nusage字段中解析出来parseNusageToRealNusage(Stringnusage)将真正的摘要从nusage字段中解析出来appendReconciliationCode(在摘要字段上附加对账标志码的设置24Stringbusnar,Stringreconciliationcode)
