Tulip平台开发技巧总结

1、1.XML数据字典资源配置问题（1）建立数据字典有一个原则，就是首先要尽量使用现有的报文资源中已有的xml标签。只有在实在找不到，不合适，或避免数据覆盖的情况下，才添加自定义xml标签到数据字典中。（2）自定义的xml标签不能与现有标签重名，应该在第三级节点上有所区别，如<ap>/<Tulip>/<YCGY>/<短信息内容>。（3）现有报文资源主要是指99目录下的公用资源中的若干报文资源，包括<ABIS>、<金额类>、<标识号码>、<状态标识>等。（4）由于tulip客户端的查找功能很不完善，此处只

2、能采用手工逐个查找。如有不清楚的地方，应即时与丘工等相关负责人联系，避免因不熟悉系统而耗费大量时间来查找标签。2.报表资源配置问题（1）报表资源因与丘工讨论确认不使用Tulip自带的报表功能，故此处略过。如有需要，可以参见金融手册，介绍的比较清楚，且例证充分。3.报文抽取资源配置问题（1）报文抽取资源从数据总线中选取必要的字段，如果我们需要抽取<ap>/<Tulip>/<标志号码>/<状态标志>，那么需要在报文抽取资源中配置<ap>/<Tulip>/<标志号码>的XML路径标签，也就是需要配置具体XML路径的上

3、一级路径。4.报文资源配置问题（1）配置发送报文的时候要注意对齐填充，一般是使用11处理方式进行左对齐空格填充。在域值处理配置里面进行配置，采用11方式填充“空格”的字符代码是数字值32，因为采用的是ascii码的十进制表示。（2）配置tulip平台接收报文，如果是定长的，则一般会添加13和81处理，既去空格和存储到目标路径。13一般采用“2-两端去空格”。而81所存储的位置，一定不能是系统路径，如<ap>/<respcode>之类的系统路径是tulip系统才有权限存取的，用户只能写入4级目录。（3）特别要注意处理的先后顺序，既11，13，81等处理方式，各自配置完后还

4、要调整先后顺序，因为执行时是严格自上而下的。（4）以上都是对xml路径进行存取的情况，需要选用B模式。对非取值项或写死数值的项，采用A模式，然后填入要写入的字符串。注意此处不可再添加81处理，因为没有对应的xml路径，用81处理会报错。（5）对个别需要条件解析的域，（如返回码正确则解析三个域，否则只解析返回码），在第三、第四标签处，按照金融手册进行解析条件的配置即可。（6）对需要插入0x00等BCD码的情况，先将域长度配成转换后的ASCII码长度，如要插入一个0x00，则在“基本配置中”，“域长度”配1；然后在“域取值配置”中，改“A”，“十六进制”，“0x00”；最后，在“域值处理配置”中，

5、添加“BCD转换”，“ASCII->BCD”，“长度”为1，至此，生成的报文中，会成功插入一个0x00，长度为1，但不会显示。（7）对于需要去除字符串中特殊字符的情况，要用25的处理方法，并且，这里的ASCII是对应的“十六进制”，而不是处理方法11里对应的“十进制”。（8）配置循环报文时，要用“纪录循环”。还要特别注意，循环报文内容不要和非循环报文混杂在一起，要用独特的标签来指定路径，如在取数据的sql语句中，要把基路径设置为/<ap>/<Tulip>/<PUB>，并把循环起始标签设置为相对路径<PUB>，而循环包内各字段也均采用相对路径

6、，直接各对应字段名即可，如<流水号>。5.表结构资源配置问题（1）表结构资源要与实际数据库里的表结构保持一致。这里可以先配tulip表结构资源，然后用第二标签的sql语句，直接贴到数据库里进行建表操作，可以简化建表工作。（2）当表结构有变动时，注意除了更新表结构资源外，tulip中所有直接引用表结构资源的地方，要手动重新加载，否则不会更新。估计采用复制到方式进行引用的。6.表字段资源配置问题（1）建立表字段资源的目的是为了简化流程组件中的一些固定的sql语句，可以通过调用表字段资源的方式，省去了逐个陈列、匹配表字段的工作。（2）在写流水表时，需要写入的字段需要配置对应的表字段资源，

7、否则将写入null值。Tulip上表中的字段与XML标签的一一对应关系集合，而我们采用了一种资源来进行说明。一般来说，一个表只能有一个对应的表字段属性资源，但也可以一个表有多个对应的表字段属性资源，具体采用哪个表字段属性资源，由具体情况来定。（3）特别注意，因为表字段资源是依托与表结构资源的，所以表结构资源如果有变动，一定要在表字段资源中重新导入。（4）表字段资源中每个域的配置必须采用相对路径的方式来表达。目前我们所用的方式是设定基路径为<ap>，然后每个域从第二级路径开始配置，如<Tulip><ABIS><借方账号>。7.错误码资源配置问题（1

8、）Tulip平台调第三方交易时，不同系统返回码的格式和长度存在差异，需要对返回码进行处理，需要配置对应的Tulip返回码，如ABIS错误码0001（帐户不存在），需要配置Tulip对应的错误码，可以定义为9601。（2）因为目前开发的系统涉及多个第三方系统，导致传回的返回码千差万别，数量巨大，所以可以用变通的办法，将第三方返回码简单区分为成功和失败，然后分别给前台返回Tulip自定义的返回码，同时把第三方的返回码包含在返回信息里发送给前台，从而减少Tulip本身包含的错误码数量。8.服务方资源配置问题（1）这部分的配置主要是因为99公用配置的局限，采用自定义的方式配置本交易所用到的tulip通

9、讯参数。具体参数配置主要是由农行负责人员进行配置，我们只要检查其他相关资源正确引用到这些配置即可，故这里略过。9.流程图资源配置问题 （1）上下组件间隔距离应在三行以上，否则在不同分辨率下，流程图可能出现跳线的情况； （2）在设置形如<ap>/<Tulip>/<YCGY>/<基交易流水号>=<ap>/<Tulip>/<标识号码>/<基交易流水号>，参数类别选择XML数据字典资源，内容获取方式选择定值；在设置形如<ap>/<Tulip>/<YCGY>/<交易状

10、态>='I'时，参数类别选择XML解析字符串资源，内容获取方式选择定值。 （3）流程图起始标记后的第一个组件和结束标记前的最后一个组建习惯用BUG_PrintXml,这样方便调试。(4)在调用DB_SelectByUnIndexAndList组件时，返回的节点列表中的XML路径应为三级路径，如返回完整路径<ap>/<Tulip>/<ABIS>/<交易金额>,在节点列表中应填入<ABIS>/<交易金额>。（5）在取XML数据字典资源值时，参数内容选择XML数据字典资源，内容获取方式选择XML标签，参数内

11、容填形如<ap>/<Tulip>/<YCGY>/<网络路由号>。（6）流程配置的时候，只能有一个开始点，但可以有多个结束点，因为这样可以避免流程绘制过于复杂，多个结束点实际上都是一个结束而已，估应配置的信息在结束点之前仍然要配置完整。10.枚举资源配置问题（1）凡是需要参照码表进行内容转换的工作，都可以通过枚举资源进行配置。配置方法参见金融手册，此处略过。11.渠道资源配置问题（1）对每个交易，要配置单独的渠道资源，特别要注意渠道标识要与服务方资源的通讯配置相呼应，否则无法连通。12.外部交易标识资源配置问题（1）同样要对每个交易配置单独的外部交

12、易标识资源，内容由农行系统相关负责人提供。渠道资源和外部交易标识，以及流程资源都将在交易资源中被引用。（2）这里tulip的引用又恢复成非复制引用，既修改了被引用资源，并不需要再次导入引用，被引用资源的修改会自动在引用资源中生效。13.交易资源配置问题（1）交易资源就按照金融手册的示例内容进行配置即可。目前我们只涉及联机交易资源配置，批交易资源配置内容在电子回单箱项目开发过程中会逐步补充进来。14.其他相关问题（1）主动发起批交易配置示例。A需要配置的相关资源包括（因主动批交易不需要柜台调起，所以不涉及报文资源）：a) 表结构资源。b) 流程资源。c) 批交易流程资源。d) 交易资源。B.配置

13、大体顺序：a) 在Tulip客户端，在表字段资源中，添加批交易上送所必须的字段资源，包括摘要、收款账号、应收金额、提交日期、币种、客户编号、炒汇标志、客户账号、客户户名、交易行、交易日期。改资源的作用是为将来批处理程序自动存储提取出来的数据并打成交易包时使用。b) 在Tulip客户端，在流程资源中，增加批处理流程。主要包括字段赋值、数据抽取（需要包含表字段资源和相应的select语句）、BTC_CreateBtdSeqNo组件（只保护一个存储合约号的xml路径）、BTC_Process（默认组件，无需添加参数）。注意，在字段赋值组件里，可以用<ap>/<Tulip>/&

14、lt;用户参数1>来接收节点调度资源中提交给批处理的参数系列。另外，注意<ap>/<Tulip>/<ABIS>/<校验标志>可以控制检查证件和户名，一般都需要检查户名。在流程资源中，还需要增加一个批交易的结果处理流程，主要负责根据批交易返回的数据，配合BTC，BTD两个表，更新取数据的交易明细表的相关栏位。c) 在Tulip客户端，在批交易流程资源中，增加批交易流程。注意要检查金额合法性判断。而数据来源，可以来自文件或数据库。表字段资源和对应的select语句填入对应的栏位。94获取标志，因为我们的扣款涉及多个94账号，而非绑定于一个合约号

15、的94账号，所以选择“根据文件指定94获取”，即采用xml路径配置94账号。而在子流程配置中，自动生成的部分都不需要改动，只要在“根据主机返回的文件修改批交易数据信息表BTD”之后，加入我们自定义的结果处理流程，以便自动更新交易明细表中的处理状态、时间等栏位。d) 在Tulip客户端，添加批处理交易资源。此处主要是在交易属性页，导入流程资源中的批交易流程，并在应用渠道和操作权限中做对应的勾选即可（数据中心发起，深圳分行全部网点可用）。e) 在Tulip管理端的“批交易结点调度”目录下，新增一个批交易结点，其中，节点类型因为是主动发起而非柜台调起，所以选“总控处理”；批处理交易码填入需调用的交易

16、资源编号，而该交易资源编号对应的交易资源中，填入需调用的流程资源编号；选程序调度参数要用空格分隔；时间用“MMDD”的格式，并以逗号分隔；执行起始、结束时间，主要是看起始时间，格式为“hhmm”；节点处理状态在正常时是“执行成功”，若需即时测试，选“强制重新执行”。具体如下图所示：f) 在Tulip管理端的“批交易属性”目录下，通过“合约号”，找到刚才新建的批交易（之所以可以通过合约号来查找，是因为在添加此批交易结点时，填入的交易资源，有其对应的流程资源，而流程资源中的第一个组件中有一个固定的赋值表达式，就是提取合约号的，由此实现批交易结点调度和批交易结点属性的对应）。然后修改批交易流程属性，

17、填入需调用的“批流程资源”编号。如下图所示：g) 看日志时，在cdt0目录下的日志里，只会有一条提交批交易的记录。而详细记录存放在Tulip/log目录的diag.log中。包括批交易预处理信息，每笔的数据组包信息，上送主机的信息，以及最后每笔主机返回的信息。15.批量查询配置Tulip平台提供DB_MultSelectAndFetchByList组件实现一次可查询多条记录，并支持多次查询的功能。现以电子回单箱收费系统说明。维护日志信息表结构如下：表名代号usr00mainlog是否静态表类型journumb流水号主键VARCHAR2(20)trandate交易日期VARCHAR2(8) tr

18、antime交易时间VARCHAR2(6)payeraccount账号VARCHAR2(20)optiontype操作类型A：增加D：删除U：修改I：查询VARCHAR2(1)ratefloatratio费率浮动比DECIMAL(16,2)tellerno操作柜员VARCHAR2(4)数据查询的sql语句如下：select a.journumb,a.trandate,a.payeraccount,a.optiontype,a.ratefloatratio,a.tellernofrom USR00MAINLOG awhere a.trandate>='<ap>/<

19、Tulip>/<日期期限>/<查询开始日期>'and a.trandate=<'<ap>/<Tulip>/<日期期限>/<查询结束日期>'and journumb>'<ap>/<Tulip>/<标识号码>/<基交易流水号>'order by a.journumb ascDB_MultSelectAndFetchByList组件配置如下：1.2.其中$1= select a.journumb,a.trandate,a.payeraccount,a.optiontype,a.ratefl