Tulip平臺(tái)開發(fā)技巧總結(jié)

1、1.XML數(shù)據(jù)字典資源配置問題（1）建立數(shù)據(jù)字典有一個(gè)原則，就是首先要盡量使用現(xiàn)有的報(bào)文資源中已有的xml標(biāo)簽。只有在實(shí)在找不到，不合適，或避免數(shù)據(jù)覆蓋的情況下，才添加自定義xml標(biāo)簽到數(shù)據(jù)字典中。（2）自定義的xml標(biāo)簽不能與現(xiàn)有標(biāo)簽重名，應(yīng)該在第三級(jí)節(jié)點(diǎn)上有所區(qū)別，如<ap>/<Tulip>/<YCGY>/<短信息內(nèi)容>。（3）現(xiàn)有報(bào)文資源主要是指99目錄下的公用資源中的若干報(bào)文資源，包括<ABIS>、<金額類>、<標(biāo)識(shí)號(hào)碼>、<狀態(tài)標(biāo)識(shí)>等。（4）由于tulip客戶端的查找功能很不完善，此處只

2、能采用手工逐個(gè)查找。如有不清楚的地方，應(yīng)即時(shí)與丘工等相關(guān)負(fù)責(zé)人聯(lián)系，避免因不熟悉系統(tǒng)而耗費(fèi)大量時(shí)間來查找標(biāo)簽。2.報(bào)表資源配置問題（1）報(bào)表資源因與丘工討論確認(rèn)不使用Tulip自帶的報(bào)表功能，故此處略過。如有需要，可以參見金融手冊，介紹的比較清楚，且例證充分。3.報(bào)文抽取資源配置問題（1）報(bào)文抽取資源從數(shù)據(jù)總線中選取必要的字段，如果我們需要抽取<ap>/<Tulip>/<標(biāo)志號(hào)碼>/<狀態(tài)標(biāo)志>，那么需要在報(bào)文抽取資源中配置<ap>/<Tulip>/<標(biāo)志號(hào)碼>的XML路徑標(biāo)簽，也就是需要配置具體XML路徑的上

3、一級(jí)路徑。4.報(bào)文資源配置問題（1）配置發(fā)送報(bào)文的時(shí)候要注意對齊填充，一般是使用11處理方式進(jìn)行左對齊空格填充。在域值處理配置里面進(jìn)行配置，采用11方式填充“空格”的字符代碼是數(shù)字值32，因?yàn)椴捎玫氖莂scii碼的十進(jìn)制表示。（2）配置tulip平臺(tái)接收報(bào)文，如果是定長的，則一般會(huì)添加13和81處理，既去空格和存儲(chǔ)到目標(biāo)路徑。13一般采用“2-兩端去空格”。而81所存儲(chǔ)的位置，一定不能是系統(tǒng)路徑，如<ap>/<respcode>之類的系統(tǒng)路徑是tulip系統(tǒng)才有權(quán)限存取的，用戶只能寫入4級(jí)目錄。（3）特別要注意處理的先后順序，既11，13，81等處理方式，各自配置完后還

4、要調(diào)整先后順序，因?yàn)閳?zhí)行時(shí)是嚴(yán)格自上而下的。（4）以上都是對xml路徑進(jìn)行存取的情況，需要選用B模式。對非取值項(xiàng)或?qū)懰罃?shù)值的項(xiàng)，采用A模式，然后填入要寫入的字符串。注意此處不可再添加81處理，因?yàn)闆]有對應(yīng)的xml路徑，用81處理會(huì)報(bào)錯(cuò)。（5）對個(gè)別需要條件解析的域，（如返回碼正確則解析三個(gè)域，否則只解析返回碼），在第三、第四標(biāo)簽處，按照金融手冊進(jìn)行解析條件的配置即可。（6）對需要插入0x00等BCD碼的情況，先將域長度配成轉(zhuǎn)換后的ASCII碼長度，如要插入一個(gè)0x00，則在“基本配置中”，“域長度”配1；然后在“域取值配置”中，改“A”，“十六進(jìn)制”，“0x00”；最后，在“域值處理配置”中，

5、添加“BCD轉(zhuǎn)換”，“ASCII->BCD”，“長度”為1，至此，生成的報(bào)文中，會(huì)成功插入一個(gè)0x00，長度為1，但不會(huì)顯示。（7）對于需要去除字符串中特殊字符的情況，要用25的處理方法，并且，這里的ASCII是對應(yīng)的“十六進(jìn)制”，而不是處理方法11里對應(yīng)的“十進(jìn)制”。（8）配置循環(huán)報(bào)文時(shí)，要用“紀(jì)錄循環(huán)”。還要特別注意，循環(huán)報(bào)文內(nèi)容不要和非循環(huán)報(bào)文混雜在一起，要用獨(dú)特的標(biāo)簽來指定路徑，如在取數(shù)據(jù)的sql語句中，要把基路徑設(shè)置為/<ap>/<Tulip>/<PUB>，并把循環(huán)起始標(biāo)簽設(shè)置為相對路徑<PUB>，而循環(huán)包內(nèi)各字段也均采用相對路徑

6、，直接各對應(yīng)字段名即可，如<流水號(hào)>。5.表結(jié)構(gòu)資源配置問題（1）表結(jié)構(gòu)資源要與實(shí)際數(shù)據(jù)庫里的表結(jié)構(gòu)保持一致。這里可以先配tulip表結(jié)構(gòu)資源，然后用第二標(biāo)簽的sql語句，直接貼到數(shù)據(jù)庫里進(jìn)行建表操作，可以簡化建表工作。（2）當(dāng)表結(jié)構(gòu)有變動(dòng)時(shí)，注意除了更新表結(jié)構(gòu)資源外，tulip中所有直接引用表結(jié)構(gòu)資源的地方，要手動(dòng)重新加載，否則不會(huì)更新。估計(jì)采用復(fù)制到方式進(jìn)行引用的。6.表字段資源配置問題（1）建立表字段資源的目的是為了簡化流程組件中的一些固定的sql語句，可以通過調(diào)用表字段資源的方式，省去了逐個(gè)陳列、匹配表字段的工作。（2）在寫流水表時(shí)，需要寫入的字段需要配置對應(yīng)的表字段資源，

7、否則將寫入null值。Tulip上表中的字段與XML標(biāo)簽的一一對應(yīng)關(guān)系集合，而我們采用了一種資源來進(jìn)行說明。一般來說，一個(gè)表只能有一個(gè)對應(yīng)的表字段屬性資源，但也可以一個(gè)表有多個(gè)對應(yīng)的表字段屬性資源，具體采用哪個(gè)表字段屬性資源，由具體情況來定。（3）特別注意，因?yàn)楸碜侄钨Y源是依托與表結(jié)構(gòu)資源的，所以表結(jié)構(gòu)資源如果有變動(dòng)，一定要在表字段資源中重新導(dǎo)入。（4）表字段資源中每個(gè)域的配置必須采用相對路徑的方式來表達(dá)。目前我們所用的方式是設(shè)定基路徑為<ap>，然后每個(gè)域從第二級(jí)路徑開始配置，如<Tulip><ABIS><借方賬號(hào)>。7.錯(cuò)誤碼資源配置問題（1

8、）Tulip平臺(tái)調(diào)第三方交易時(shí)，不同系統(tǒng)返回碼的格式和長度存在差異，需要對返回碼進(jìn)行處理，需要配置對應(yīng)的Tulip返回碼，如ABIS錯(cuò)誤碼0001（帳戶不存在），需要配置Tulip對應(yīng)的錯(cuò)誤碼，可以定義為9601。（2）因?yàn)槟壳伴_發(fā)的系統(tǒng)涉及多個(gè)第三方系統(tǒng)，導(dǎo)致傳回的返回碼千差萬別，數(shù)量巨大，所以可以用變通的辦法，將第三方返回碼簡單區(qū)分為成功和失敗，然后分別給前臺(tái)返回Tulip自定義的返回碼，同時(shí)把第三方的返回碼包含在返回信息里發(fā)送給前臺(tái)，從而減少Tulip本身包含的錯(cuò)誤碼數(shù)量。8.服務(wù)方資源配置問題（1）這部分的配置主要是因?yàn)?9公用配置的局限，采用自定義的方式配置本交易所用到的tulip通

9、訊參數(shù)。具體參數(shù)配置主要是由農(nóng)行負(fù)責(zé)人員進(jìn)行配置，我們只要檢查其他相關(guān)資源正確引用到這些配置即可，故這里略過。9.流程圖資源配置問題 （1）上下組件間隔距離應(yīng)在三行以上，否則在不同分辨率下，流程圖可能出現(xiàn)跳線的情況； （2）在設(shè)置形如<ap>/<Tulip>/<YCGY>/<基交易流水號(hào)>=<ap>/<Tulip>/<標(biāo)識(shí)號(hào)碼>/<基交易流水號(hào)>，參數(shù)類別選擇XML數(shù)據(jù)字典資源，內(nèi)容獲取方式選擇定值；在設(shè)置形如<ap>/<Tulip>/<YCGY>/<交易狀

10、態(tài)>='I'時(shí)，參數(shù)類別選擇XML解析字符串資源，內(nèi)容獲取方式選擇定值。 （3）流程圖起始標(biāo)記后的第一個(gè)組件和結(jié)束標(biāo)記前的最后一個(gè)組建習(xí)慣用BUG_PrintXml,這樣方便調(diào)試。(4)在調(diào)用DB_SelectByUnIndexAndList組件時(shí)，返回的節(jié)點(diǎn)列表中的XML路徑應(yīng)為三級(jí)路徑，如返回完整路徑<ap>/<Tulip>/<ABIS>/<交易金額>,在節(jié)點(diǎn)列表中應(yīng)填入<ABIS>/<交易金額>。（5）在取XML數(shù)據(jù)字典資源值時(shí)，參數(shù)內(nèi)容選擇XML數(shù)據(jù)字典資源，內(nèi)容獲取方式選擇XML標(biāo)簽，參數(shù)內(nèi)

11、容填形如<ap>/<Tulip>/<YCGY>/<網(wǎng)絡(luò)路由號(hào)>。（6）流程配置的時(shí)候，只能有一個(gè)開始點(diǎn)，但可以有多個(gè)結(jié)束點(diǎn)，因?yàn)檫@樣可以避免流程繪制過于復(fù)雜，多個(gè)結(jié)束點(diǎn)實(shí)際上都是一個(gè)結(jié)束而已，估應(yīng)配置的信息在結(jié)束點(diǎn)之前仍然要配置完整。10.枚舉資源配置問題（1）凡是需要參照碼表進(jìn)行內(nèi)容轉(zhuǎn)換的工作，都可以通過枚舉資源進(jìn)行配置。配置方法參見金融手冊，此處略過。11.渠道資源配置問題（1）對每個(gè)交易，要配置單獨(dú)的渠道資源，特別要注意渠道標(biāo)識(shí)要與服務(wù)方資源的通訊配置相呼應(yīng)，否則無法連通。12.外部交易標(biāo)識(shí)資源配置問題（1）同樣要對每個(gè)交易配置單獨(dú)的外部交

12、易標(biāo)識(shí)資源，內(nèi)容由農(nóng)行系統(tǒng)相關(guān)負(fù)責(zé)人提供。渠道資源和外部交易標(biāo)識(shí)，以及流程資源都將在交易資源中被引用。（2）這里tulip的引用又恢復(fù)成非復(fù)制引用，既修改了被引用資源，并不需要再次導(dǎo)入引用，被引用資源的修改會(huì)自動(dòng)在引用資源中生效。13.交易資源配置問題（1）交易資源就按照金融手冊的示例內(nèi)容進(jìn)行配置即可。目前我們只涉及聯(lián)機(jī)交易資源配置，批交易資源配置內(nèi)容在電子回單箱項(xiàng)目開發(fā)過程中會(huì)逐步補(bǔ)充進(jìn)來。14.其他相關(guān)問題（1）主動(dòng)發(fā)起批交易配置示例。A需要配置的相關(guān)資源包括（因主動(dòng)批交易不需要柜臺(tái)調(diào)起，所以不涉及報(bào)文資源）：a) 表結(jié)構(gòu)資源。b) 流程資源。c) 批交易流程資源。d) 交易資源。B.配置

13、大體順序：a) 在Tulip客戶端，在表字段資源中，添加批交易上送所必須的字段資源，包括摘要、收款賬號(hào)、應(yīng)收金額、提交日期、幣種、客戶編號(hào)、炒匯標(biāo)志、客戶賬號(hào)、客戶戶名、交易行、交易日期。改資源的作用是為將來批處理程序自動(dòng)存儲(chǔ)提取出來的數(shù)據(jù)并打成交易包時(shí)使用。b) 在Tulip客戶端，在流程資源中，增加批處理流程。主要包括字段賦值、數(shù)據(jù)抽?。ㄐ枰碜侄钨Y源和相應(yīng)的select語句）、BTC_CreateBtdSeqNo組件（只保護(hù)一個(gè)存儲(chǔ)合約號(hào)的xml路徑）、BTC_Process（默認(rèn)組件，無需添加參數(shù)）。注意，在字段賦值組件里，可以用<ap>/<Tulip>/&

14、lt;用戶參數(shù)1>來接收節(jié)點(diǎn)調(diào)度資源中提交給批處理的參數(shù)系列。另外，注意<ap>/<Tulip>/<ABIS>/<校驗(yàn)標(biāo)志>可以控制檢查證件和戶名，一般都需要檢查戶名。在流程資源中，還需要增加一個(gè)批交易的結(jié)果處理流程，主要負(fù)責(zé)根據(jù)批交易返回的數(shù)據(jù)，配合BTC，BTD兩個(gè)表，更新取數(shù)據(jù)的交易明細(xì)表的相關(guān)欄位。c) 在Tulip客戶端，在批交易流程資源中，增加批交易流程。注意要檢查金額合法性判斷。而數(shù)據(jù)來源，可以來自文件或數(shù)據(jù)庫。表字段資源和對應(yīng)的select語句填入對應(yīng)的欄位。94獲取標(biāo)志，因?yàn)槲覀兊目劭钌婕岸鄠€(gè)94賬號(hào)，而非綁定于一個(gè)合約號(hào)

15、的94賬號(hào)，所以選擇“根據(jù)文件指定94獲取”，即采用xml路徑配置94賬號(hào)。而在子流程配置中，自動(dòng)生成的部分都不需要改動(dòng)，只要在“根據(jù)主機(jī)返回的文件修改批交易數(shù)據(jù)信息表BTD”之后，加入我們自定義的結(jié)果處理流程，以便自動(dòng)更新交易明細(xì)表中的處理狀態(tài)、時(shí)間等欄位。d) 在Tulip客戶端，添加批處理交易資源。此處主要是在交易屬性頁，導(dǎo)入流程資源中的批交易流程，并在應(yīng)用渠道和操作權(quán)限中做對應(yīng)的勾選即可（數(shù)據(jù)中心發(fā)起，深圳分行全部網(wǎng)點(diǎn)可用）。e) 在Tulip管理端的“批交易結(jié)點(diǎn)調(diào)度”目錄下，新增一個(gè)批交易結(jié)點(diǎn)，其中，節(jié)點(diǎn)類型因?yàn)槭侵鲃?dòng)發(fā)起而非柜臺(tái)調(diào)起，所以選“總控處理”；批處理交易碼填入需調(diào)用的交易

16、資源編號(hào)，而該交易資源編號(hào)對應(yīng)的交易資源中，填入需調(diào)用的流程資源編號(hào)；選程序調(diào)度參數(shù)要用空格分隔；時(shí)間用“MMDD”的格式，并以逗號(hào)分隔；執(zhí)行起始、結(jié)束時(shí)間，主要是看起始時(shí)間，格式為“hhmm”；節(jié)點(diǎn)處理狀態(tài)在正常時(shí)是“執(zhí)行成功”，若需即時(shí)測試，選“強(qiáng)制重新執(zhí)行”。具體如下圖所示：f) 在Tulip管理端的“批交易屬性”目錄下，通過“合約號(hào)”，找到剛才新建的批交易（之所以可以通過合約號(hào)來查找，是因?yàn)樵谔砑哟伺灰捉Y(jié)點(diǎn)時(shí)，填入的交易資源，有其對應(yīng)的流程資源，而流程資源中的第一個(gè)組件中有一個(gè)固定的賦值表達(dá)式，就是提取合約號(hào)的，由此實(shí)現(xiàn)批交易結(jié)點(diǎn)調(diào)度和批交易結(jié)點(diǎn)屬性的對應(yīng)）。然后修改批交易流程屬性，

17、填入需調(diào)用的“批流程資源”編號(hào)。如下圖所示：g) 看日志時(shí)，在cdt0目錄下的日志里，只會(huì)有一條提交批交易的記錄。而詳細(xì)記錄存放在Tulip/log目錄的diag.log中。包括批交易預(yù)處理信息，每筆的數(shù)據(jù)組包信息，上送主機(jī)的信息，以及最后每筆主機(jī)返回的信息。15.批量查詢配置Tulip平臺(tái)提供DB_MultSelectAndFetchByList組件實(shí)現(xiàn)一次可查詢多條記錄，并支持多次查詢的功能?，F(xiàn)以電子回單箱收費(fèi)系統(tǒng)說明。維護(hù)日志信息表結(jié)構(gòu)如下：表名代號(hào)usr00mainlog是否靜態(tài)表類型journumb流水號(hào)主鍵VARCHAR2(20)trandate交易日期VARCHAR2(8) tr

18、antime交易時(shí)間VARCHAR2(6)payeraccount賬號(hào)VARCHAR2(20)optiontype操作類型A：增加D：刪除U：修改I：查詢VARCHAR2(1)ratefloatratio費(fèi)率浮動(dòng)比DECIMAL(16,2)tellerno操作柜員VARCHAR2(4)數(shù)據(jù)查詢的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>/<日期期限>/<查詢結(jié)束日期>'and journumb>'<ap>/<Tulip>/<標(biāo)識(shí)號(hào)碼>/<基交易流水號(hào)>'order by a.journumb ascDB_MultSelectAndFetchByList組件配置如下：1.2.其中$1= select a.journumb,a.trandate,a.payeraccount,a.optiontype,a.ratefl