1、Nantian南天信息BST3.0應(yīng)用軟件開發(fā)平臺用戶技術(shù)手冊云南南天電子信息產(chǎn)業(yè)股份有限公司FED軟件中心第一章 第二章 第三章 第四章 AtV 第五章 第六章 第七章 第八章 第九章 第十章 第十一章 第十二章 第十三章 第十四章 第十五章概述第一部分BST3.0應(yīng)用軟件開發(fā)平臺基本功能BST3.0軟件開發(fā)平臺的結(jié)構(gòu)和流程控制系統(tǒng)命令變量操作命令字符串操作命令文件操作命令屏幕(SCREEN)1配置和命令存折打印機(jī)(PR2)配置和命令刷卡器(BP)配置和命令FIT表配置和命令流水打印機(jī)配置和命令讀卡機(jī)命令I(lǐng)C卡命令和配置表輔助模塊命令和配置通信命令添加設(shè)備的命令接口第二部分BST3.0應(yīng)用軟

2、件二次開發(fā)第一章用戶自定義命令的開發(fā)第二章通信動態(tài)庫的開發(fā)第三章調(diào)試第三部分BST3.0SCRIPT使用手冊概述BST3.0應(yīng)用軟件開發(fā)平臺是在BST2.0應(yīng)用軟件開發(fā)平臺的基礎(chǔ)上，根據(jù)BST應(yīng)用需求，增加了屏幕部分對WE序口FLASH勺支持，增加了內(nèi)嵌的解釋器，支持SCRIPT®程模式，以及單步和屏幕重試功能。BST3.0應(yīng)用軟件開發(fā)平臺更穩(wěn)定，具有更好的擴(kuò)展性，更容易完成BST應(yīng)用系統(tǒng)的開發(fā)。為熟練使用BST3.0應(yīng)用系統(tǒng)軟件開發(fā)平臺進(jìn)行二次開發(fā)，對此平臺結(jié)構(gòu)及功能模塊應(yīng)有充分了解，為縮短二次開發(fā)周期，請有關(guān)人員仔細(xì)閱讀本手冊。因時間倉促，有不足之處，請使用者諒解，并將需要改善的

3、意見反饋給FED軟件中心，幫助BST3.0應(yīng)用系統(tǒng)軟件開發(fā)平臺的完善。第一部分BST3.0應(yīng)用軟件開發(fā)平臺基本功能第一章BST3.0開發(fā)平臺的結(jié)構(gòu)和基本功能1.1BST3.0軟件開發(fā)平臺的組成部分BST3.0軟件開發(fā)平臺功能完善、定制靈活、便于二次開發(fā)及其測試維護(hù)，它是由接口清晰且相互獨立的子功能模塊有機(jī)地結(jié)合在一起而行成的。BST3.0軟件開發(fā)平臺由以下幾個大的部分組成:1 系統(tǒng)主控模塊協(xié)調(diào)平臺內(nèi)部各功能模塊的工作。2 設(shè)備控制模塊由一系列與具體設(shè)備相應(yīng)的設(shè)備控制模塊組成，每一個設(shè)備控制模塊對應(yīng)于一個相應(yīng)的硬件設(shè)備模塊，在BST應(yīng)用系統(tǒng)中，設(shè)備是一個廣義上的設(shè)備，除傳統(tǒng)上的外部設(shè)備如打印機(jī)、

4、BR讀卡機(jī)等設(shè)備外，還有一些特殊的設(shè)備，如屏幕設(shè)備，在系統(tǒng)中稱之為“screen”，它實際上包括了顯示器、鍵盤和鼠標(biāo)的輸入輸出，這三個設(shè)備是在“screen”設(shè)備中統(tǒng)一處理的。另外，還有通信設(shè)備（實際上是通信子系統(tǒng)，它被當(dāng)作一個設(shè)備操作）和時間設(shè)備（“time”，用于檢測退出時間是否到達(dá)）等。3 設(shè)備接口模塊負(fù)責(zé)屏蔽BST應(yīng)用系統(tǒng)中設(shè)備的硬件特性，使用統(tǒng)一的方式（統(tǒng)一的接口）對設(shè)備進(jìn)行操作。應(yīng)用系統(tǒng)使用設(shè)備時通過設(shè)備接口模塊操作設(shè)備，可保證以同樣方式操作所有設(shè)備。4 流程控制模塊負(fù)責(zé)應(yīng)用系統(tǒng)的流程控制，完成特定交易控制，接受主機(jī)命令，保存程序運行狀態(tài)的文件等。5 通信處理子系統(tǒng)以操作設(shè)備的方式

5、完成BST應(yīng)用系統(tǒng)與主機(jī)間的通信HOST通信子系統(tǒng)系統(tǒng)主控模塊系統(tǒng)維護(hù)交易處理本地服務(wù)信息處理子系統(tǒng)圖一系統(tǒng)總體結(jié)構(gòu)圖1.2BST3.0應(yīng)用系統(tǒng)的流程控制BST3.0應(yīng)用系統(tǒng)是一個平臺化的產(chǎn)品，可根據(jù)客戶不同的需求加以定制，該平臺可適應(yīng)不同的聯(lián)機(jī)環(huán)境，具有定制簡單，易于擴(kuò)展、安裝和維護(hù)等優(yōu)點，BST3.0應(yīng)用系統(tǒng)是通過“表控制結(jié)構(gòu)”完成的（SCRIPT卻本作為輔助方式）。系統(tǒng)根據(jù)交易流程表（step.cfg）的定義來具體實現(xiàn)每一個相關(guān)的操作，如設(shè)備的初始化及交易的處理等。整個控制過程是通過多個配置表相互協(xié)調(diào)來完成功能的?！芭渲帽怼笔荁ST3.0應(yīng)用系統(tǒng)正常運轉(zhuǎn)的控制中心，是完成交易控制的“主動

6、脈”：1 .設(shè)備表，定義應(yīng)用系統(tǒng)中的設(shè)備特性；2 .變量表，定義在STEPS中可用的全局變量；3 .STEP表（STEP.CFG）也稱主控表，類似一種腳本語言，負(fù)責(zé)交易流程的控制；4 .屏幕表，負(fù)責(zé)屏幕顯示方式的控制；5 .通信控制表，定義通信方式和數(shù)據(jù)解釋方式；6 .PR2打印機(jī)控制表，定義PR2工作方式；7 .BP控制表，定義BP工作方式；8 .流水打印機(jī)控制表，控制流水打印機(jī)打??；9 .FIT表，負(fù)責(zé)磁條數(shù)據(jù)的解釋和組包；10 .讀卡機(jī)控制表；11 .CD出鈔模塊控制表；12 .命令控制表（COMMAND。FG需要新增設(shè)備以及相應(yīng)的命令時的接口控制表；13 .SCRIPT腳本文件，是數(shù)據(jù)

7、處理和流程控制的輔助方式。設(shè)備控制表（簡稱設(shè)備表）和變量定義表（簡稱變量表）都是定義在注冊表中的“我的電腦南大BST2下。設(shè)備表定義了各個設(shè)備的基本特性。其格式如下：設(shè)備名通道（端口）輸入緩沖區(qū)大小輸出緩沖區(qū)大小出口索引號（n）設(shè)備名：必須是唯一的，如PR2BRSCREENS,且確定后不能更改。通道（端口）：標(biāo)識設(shè)備所使用端口，如COM1、“COM2等。如果不使用計算機(jī)用口，也必須用一個字符串作為標(biāo)識，如使用TCPIP,則用“TCPIP'標(biāo)識。輸入緩沖區(qū)大?。阂宰止?jié)計的緩沖區(qū)大小，用于保存輸入數(shù)據(jù)。輸出緩沖區(qū)大?。阂宰止?jié)計的緩沖區(qū)大小，用于保存輸出數(shù)據(jù)。出口索引號n:與SynDevic

8、e命令配合使用，在設(shè)備同步狀態(tài)下，設(shè)備輸入時所指向的出口索引號（第n個出口）。注意：出口索引號可以用8之外的索引號，索引號8由系統(tǒng)保留使用，需要與SynDevice命令配合使用的設(shè)備，詳見命令SynDevice的描述變量表包括預(yù)定義變量表(PredefineVariable)和用戶定義變量表(UserdefineVariable)。變量表用于定義全局變量，這些變量在STEP表的整個流程中均可用。預(yù)定義變量表：該表定義的變量供系統(tǒng)使用，而且變量名不能改變。用戶定義的變量表：二次開發(fā)所用的變量可此表中定義，該表定義的變量是可以改變的。注意：定義變量時，以“；”號開始的部分為注釋部分，原則上在定義變

9、量時都應(yīng)該注釋其含義。STEP配置表是BST應(yīng)用系統(tǒng)的流程控制表，是完成交易的核心。它通過控制設(shè)備操作流程來完成指定的交易。它實現(xiàn)的原理是：所有交易都是由一系列設(shè)備操作的組合實現(xiàn)的。STEP配置表(step.cfg)中的內(nèi)容分為兩類：初始化表和工作表。一.初始化表的配置初始化表名是“init”，包括如下內(nèi)容：1. 用戶擴(kuò)展接口庫路徑(關(guān)鍵字userdll_path)。userdll_path=c:bst_newbst2bstuserdebugbstuser.dll缺省為運行程序BST2.EXE3前目錄下的bstuser.dll:該配置用于定義用戶擴(kuò)展接口庫的路徑。2. 調(diào)試級別(關(guān)鍵字debu

10、g_level)。debuglevel=0該配置用于定義不同的調(diào)試級別，對不同的調(diào)試級別，系統(tǒng)會提供不同范圍下的TRAC或件，該文件可供調(diào)試使用。缺省為1。=0：無調(diào)試信息，無任何trace文件，配置文件在內(nèi)存中讀寫，不等于0時，PR2控制部分和屏幕部分根據(jù)配置可以定義各自的trace文件(請參見PR2模塊和屏幕模塊的相關(guān)部分)。=1：有step的trace文件step.txt,放在trace目錄下，記錄所執(zhí)行過的命令，配置文件在內(nèi)存中讀寫；=2：有step的trace文件step.txt,放在trace目錄下，記錄所執(zhí)行過的命令和每一個命令的執(zhí)行時間，配置文件在磁盤文件中讀寫；注意：各個配置

11、文件不能超過64K,否則在寫文件時可能會丟失文件中超過64K部分的內(nèi)容，此時必須備份文件。=3：有step的trace文件step.txt,放在trace目錄下，記錄所執(zhí)行過的命令和每一個命令的執(zhí)行時間，同時記錄每一步中的所有變量的值，配置文件在磁盤文件中讀寫；=4:設(shè)置調(diào)試熱鍵，使用熱鍵X進(jìn)入單步step,Y退出；熱鍵A進(jìn)入屏幕單步，B退出。=5:單步執(zhí)行step,“DONE按鈕執(zhí)行一步，"GOTO按鈕條轉(zhuǎn)道指定STEP=6:單步執(zhí)行屏幕，“RETRY按鈕重新畫屏幕，“NEXT按鈕從指定出口執(zhí)行下一步。3. 退出時間定義（關(guān)鍵字logout_time）可最多定義三個時間檢測，出口相

12、同：logout_time=22:30logout_time2=22:50第二個時間logout_time3=22:50第三個時間該配置用于定義系統(tǒng)自動關(guān)機(jī)的時間，若要啟動該功能，需要執(zhí)行CheckTime命令（詳見CheckTime命令）。二工作表的配置。工作表的表名是“STEP_TABLE,在STEPS中，所有STEP以以下格式出現(xiàn)：step_xxxx=CommandScreenVar1Var2exit1exit2exit3exit4exit50step_xxxx:STE%,作為關(guān)鍵字。STEPS從step.cfg文件中的step_0001開始。xxXx是STEPR引號，可以由數(shù)字組成，也可以是字符串，但必須小于一40個字節(jié)，如果超過，會導(dǎo)致不能正確搜尋。Command:命令。向設(shè)備發(fā)出確定的命令指示設(shè)備工作，如PR2ReadStrap是讓打印機(jī)讀磁條。Screen：屏幕。通知屏幕按屏幕配置文件中的某個表畫屏幕。Var1Var2:變量名。在一些Command,需要用到變量，Var1,Var2是變量名。exit1exit50：出口號。在命令完成后，根據(jù)命令