TOP GP命名、操作、環(huán)境架構(gòu)

TOPGP環(huán)境構(gòu)架、操作、命名、介紹

周迎春營(yíng)運(yùn)本部/中西營(yíng)運(yùn)區(qū)/T系列交付中心鼎捷軟件2015年03月01日課程大綱TOPGP相關(guān)軟件安裝配置TOPGP基本操作TOPGP5X開發(fā)環(huán)境介紹TOPGP環(huán)境架構(gòu)TOPGP命名原則準(zhǔn)備安裝CRT安裝GDC基本操作

主畫面基本操作說明

開啟主目錄方式Telnet下執(zhí)行命令udm7exe2udm_tree執(zhí)行程序方式exe2aimi100（任何目錄下都可使用此命令）r.r2aimi100（只能在程序所述模塊的目錄下使用此命令）主目錄雙擊程序名稱主目錄錄入作業(yè)編號(hào)主目錄編輯我的最愛程序界面下快捷鍵ctrl-gaimi100建檔類型類型功能參數(shù)更改單檔錄入、更改、刪除、復(fù)制、無(wú)效、打印、查詢、條件查詢、條件儲(chǔ)存單檔多欄單身、打印、匯出EXCEL、查詢、條件查詢、條件儲(chǔ)存雙檔錄入、更改、刪除、復(fù)制、單身、打印、查詢、條件查詢、條件儲(chǔ)存批處理?xiàng)l件查詢、條件儲(chǔ)存查詢查詢、打印報(bào)表?xiàng)l件查詢、條件儲(chǔ)存系統(tǒng)按鈕及功能鍵操作說明快捷鍵按鈕名稱功能說明Ctrl-l語(yǔ)言切換語(yǔ)言別F1錄入單檔建檔或雙檔建檔案新增一筆資料u更改單檔建檔案時(shí)為更改此筆資料

雙檔建檔時(shí)為更改此筆單頭資料F2刪除單檔建檔或雙檔建檔案刪除一筆數(shù)據(jù)c復(fù)制單檔建檔或雙檔建檔案復(fù)制一筆數(shù)據(jù)x無(wú)效單檔建檔或雙檔建檔案標(biāo)注此筆數(shù)據(jù)無(wú)效之功能鈕b單身在雙檔建檔或單檔多欄進(jìn)入單身錄入或更改數(shù)據(jù)o打印在建檔程序行印憑證或明細(xì)表e匯出Excel在雙檔建檔或單檔多欄將單身查詢出的數(shù)據(jù)匯入Excel系統(tǒng)按鈕及功能鍵操作說明快捷鍵圖形按鈕功能說明q查詢查詢已存在的數(shù)據(jù)Ctrl-q條件查詢查詢用戶儲(chǔ)存過的條件，帶入畫面中Ctrl-w條件存儲(chǔ)儲(chǔ)存用戶畫面上錄入的條件f第一筆當(dāng)數(shù)據(jù)查詢出來后，移到查詢出來的第一筆數(shù)據(jù)p上筆當(dāng)數(shù)據(jù)查詢出來后，移到當(dāng)前數(shù)據(jù)的前一筆數(shù)據(jù)j指定筆當(dāng)數(shù)據(jù)查詢出來后，可錄入指定跳到第幾筆數(shù)據(jù)n下一筆數(shù)據(jù)查詢出來后，移到當(dāng)前數(shù)據(jù)的下一筆數(shù)據(jù)l末一筆當(dāng)數(shù)據(jù)查詢出來后，移到查詢出來的最后一筆數(shù)據(jù)Ctrl-z必要字段在新增或更改數(shù)據(jù)時(shí)，檢查有哪些是必須錄入的字段系統(tǒng)按鈕及功能鍵操作說明快捷鍵圖形按鈕功能說明Ctrl-h幫助在線說明Esc離開離開此支程序Return確定在新增、更改完成時(shí)按確定存盤Esc退出在新增、更改時(shí)可按放棄此筆資料Ctrl-o預(yù)設(shè)上筆資料在新增時(shí)，單一字段缺省當(dāng)前數(shù)據(jù)與上一筆相同Ctrl-f開啟字段說明在新增或更改時(shí)，看某個(gè)字段的說明查詢條件的運(yùn)用*：表示任何符合的字符，例：A*，表示要找出全部為A開頭的資料。

?：表示任一符合的字符，例：A?，表示要找出第一碼為

A，第二碼為任何字符，但總共只有二碼之?dāng)?shù)據(jù)。

注：以上二功能僅可在文字字段使用。

=：表示該字段為空白。

>n：表示大于數(shù)值n，例：>100。

<n：表示小于數(shù)值n，例：<100。

<>n：表示不等于某個(gè)值，例：<>100?；?lt;>’A001’

n:m：表示介于n與m之間，例：100:200。

x|y：表示值為x或y，例：A|B、50|60。

[a-z]*：表示第一字符為由a到z的任一字母開頭的數(shù)據(jù)。TOPGP5X開發(fā)環(huán)境介紹

正式區(qū)、測(cè)試區(qū)、標(biāo)準(zhǔn)區(qū)的畫分

TOPGP在出貨時(shí)會(huì)畫分成三大區(qū)域，分別是正式區(qū)、測(cè)試區(qū)與標(biāo)準(zhǔn)區(qū)。正式區(qū)：客戶正式運(yùn)行環(huán)境。本區(qū)程序不可任意更改，以維護(hù)數(shù)據(jù)的安全性。程序要匯入本區(qū)前，必須在測(cè)試區(qū)域完成磨合測(cè)試，并經(jīng)相關(guān)用戶的認(rèn)可后才可以執(zhí)行匯入的工作。測(cè)試區(qū)：主要是提供給用戶練習(xí)數(shù)據(jù)輸入，或是有新程序匯入系統(tǒng)的磨合測(cè)試區(qū)，本區(qū)的數(shù)據(jù)將會(huì)定期由正式區(qū)覆蓋進(jìn)來，以保持測(cè)試的逼真度。標(biāo)準(zhǔn)區(qū)：標(biāo)準(zhǔn)系統(tǒng)環(huán)境，不客制，僅接受Patch更新。區(qū)域劃分的目的提供客戶獨(dú)立的正式與測(cè)試環(huán)境擁有系統(tǒng)功能自動(dòng)更新的機(jī)制【patch】完整記錄客制功能項(xiàng)目TOPGP各區(qū)路徑規(guī)劃圖/u1/topprod/正式區(qū)/topcust//tiptop/axm,aoo,lib,sub,qrycxm,coo,clib,csub/aooi010/cooi010/u1/toptest/測(cè)試區(qū)/topcust//tiptop/axm,aoo,lib,sub,qrycxm,coo,clib,csub/aooi010/cooi010/u1/topstd/標(biāo)準(zhǔn)區(qū)/topcust//tiptop/axm,aoo,lib,sub,qrycxm,coo,clib,csub/aooi010/cooi010模塊編號(hào)程序編號(hào)tiptop目錄下的程序，除測(cè)試進(jìn)行中時(shí)期外，在正式區(qū)、測(cè)試區(qū)及標(biāo)準(zhǔn)區(qū)均應(yīng)保持一致TOPGP數(shù)據(jù)庫(kù)分區(qū)/u1/topprod正式區(qū)topprodds數(shù)據(jù)庫(kù)/u1/toptest測(cè)試區(qū)toptestds數(shù)據(jù)庫(kù)/u1/topstd標(biāo)準(zhǔn)區(qū)topstdds數(shù)據(jù)庫(kù)每一區(qū)都有各自獨(dú)立的Instance每個(gè)Instance皆有獨(dú)立的ds數(shù)據(jù)庫(kù)DBServer系統(tǒng)資源分配TOTALDatabase4GBTOTALHardDisk14GBINSTANCE1正式區(qū)2G正式區(qū)6GINSTANCE2測(cè)試區(qū)300M測(cè)試區(qū)6GINSTANCE3標(biāo)準(zhǔn)區(qū)200M標(biāo)準(zhǔn)區(qū)2GTOPGP環(huán)境架構(gòu)

系統(tǒng)架構(gòu)圖

系統(tǒng)架構(gòu)說明系統(tǒng)在配置時(shí)，均以tiptop做為最上層目錄，在tiptop下掛上各種系統(tǒng)所需的工具、模塊等目錄。config目錄

本目錄下是置放程序執(zhí)行時(shí)所需參照到的設(shè)定部份。top.global：整個(gè)系統(tǒng)中都會(huì)使用到的公用變量定義（如g_user：記錄現(xiàn)行用戶代碼、g_plant：記錄用戶當(dāng)前使用工廠代碼）檔案。4ad：存放每支程序Action代碼與顯示說明轉(zhuǎn)換的數(shù)據(jù)（分系統(tǒng)別、語(yǔ)言別存放）。4tm：存放每支程序的TopMenu數(shù)據(jù)（分系統(tǒng)別存放）。4tb：存放各類程序的ToolBar設(shè)定數(shù)據(jù)。4st：存放屏幕顯示的Style設(shè)定數(shù)據(jù)。4sm：存放系統(tǒng)StartMenu（分語(yǔ)言別存放）。系統(tǒng)架構(gòu)說明程序模塊目錄

aim等：各模塊目錄lib：置放系統(tǒng)『標(biāo)準(zhǔn)公用程序（如：cl_xxx）』目錄。sub：置放系統(tǒng)『標(biāo)準(zhǔn)公用副程序（如：s_xxx）』目錄。qry：置放系統(tǒng)『標(biāo)準(zhǔn)查詢程序（如：q_xxx）』目錄。模塊下目錄4gl：程序原碼置放目錄，置于其下的程序命名均須依命名原則定名。42m：程序原碼經(jīng)編譯后的結(jié)果置放處。各程序單獨(dú)存在，未經(jīng)連結(jié)前的程序不一定可以獨(dú)立執(zhí)行。42r：編譯連結(jié)完成后的執(zhí)行檔置放處。4fd:FormDesigner使用的畫面檔。per：透過gsform工具將4fd檔案轉(zhuǎn)換成的畫面對(duì)照檔。42f：編譯完成的畫面文件數(shù)據(jù)。sch：由數(shù)據(jù)庫(kù)匯出的數(shù)據(jù)結(jié)構(gòu)文件。sdd:畫面檔案規(guī)格說明。系統(tǒng)架構(gòu)說明工作目錄

ds4gl2：置放程序執(zhí)行時(shí)所必需的執(zhí)行程序稿。bin：置放程序執(zhí)行時(shí)所必需的執(zhí)行程序稿。schema:由數(shù)據(jù)庫(kù)匯出的數(shù)據(jù)結(jié)構(gòu)文件。demo：置放參考用標(biāo)準(zhǔn)程序的目錄。doc:存放圖片，說明文件，流程文件的目錄。log:程序錯(cuò)誤訊息記錄檔。out:歷史打印報(bào)表存放目錄。tmp：存放數(shù)據(jù)庫(kù)備份及其它暫存數(shù)據(jù)。系統(tǒng)工具

在TOPGP系統(tǒng)中提供一些系統(tǒng)工具，讓用戶在自行開發(fā)程序時(shí)能有標(biāo)準(zhǔn)的執(zhí)行依循。r.c2:將4gl程序編譯為42mr.l2:讀取程序連結(jié)數(shù)據(jù)并將42m程序連結(jié)至42rr.r2:執(zhí)行42r程序r.d2+:呼叫Debugger（圖形模式板）執(zhí)行程序r.f2:將4fd畫面檔編譯成42fr.gf:預(yù)覽編譯后的42f檔案系統(tǒng)工具用法允許使用目錄r.f2r.f2xxx4fd/per/42fr.gfr.gfxxx0/2(0為繁體，2為簡(jiǎn)體)p/c(p表示標(biāo)準(zhǔn)目錄，c表示客制目錄)4fd/per/42fr.c2r.c2xxx4glr.l2r.l2xxx4gl/42m/42rr.r2r.r2xxx4fd/per/42f/4gl/42m/42rr.d2+r.d2+xxx4glTOPGP命名原則

內(nèi)容列表系統(tǒng)命名原則程序命名原則共享程序命名原則子程序命名原則函數(shù)命名原則變量命名原則數(shù)據(jù)庫(kù)表格命名原則系統(tǒng)命名原則第一碼為標(biāo)準(zhǔn)或客制識(shí)別碼：『A』：標(biāo)準(zhǔn)系統(tǒng)模塊『G』：配合兩岸三地相關(guān)規(guī)則調(diào)整模塊『C』：客制化模塊系統(tǒng)以三至四個(gè)英文字來命名

第二到三碼以系統(tǒng)英文縮寫為主，若遇到已使用的代碼，則第二碼以『X』字符或另以相關(guān)縮寫取代?？椭颇K命名原則：原有模塊客制化，替換掉前面的“A”變成“C”，后面不變；大陸版模塊則直接在前面加上“C”，以避免重復(fù)。新建模塊則以“C”開頭后，以不重復(fù)為原則命名。范例序號(hào)系統(tǒng)代碼中文說明英文名稱備注1aim庫(kù)存料件數(shù)據(jù)管理系統(tǒng)InventoryManagemen2gnm票據(jù)管理系統(tǒng)NotesManagement大陸版3cim庫(kù)存料件數(shù)據(jù)管理系統(tǒng)客制4cgnm票據(jù)管理系統(tǒng)客制5lib共享程序CommonLibrary6sub一般子程序CommonSubfunction7qry查詢子程序CommanQueryFunction程序命名原則

程序一般以四碼英文及三位數(shù)字（共七碼）組成。程序名稱的前三碼為模塊代碼，第四碼為程序類型，第五碼至第七碼為作業(yè)代碼。

格式：SSSQ999說明：SSS為模塊代碼，均以小寫字母表示Q為程序類型，其意義如下：

『i』維護(hù)作業(yè)、『r』報(bào)表作業(yè)、『s』參數(shù)設(shè)置、『p』批處理、『t』交易處理、『q』查詢作業(yè)999為流水號(hào)若程序中，包含了一個(gè)以上的副函式或子畫面，則可以再加上第四碼來表示歸屬于該主程序下的附屬資料（畫面或程序）。

范例客制化程式碼調(diào)整有需要進(jìn)行客制化程式碼調(diào)整，請(qǐng)勿在標(biāo)準(zhǔn)（package）目錄下面進(jìn)行，請(qǐng)將要客制的作業(yè)復(fù)制到對(duì)應(yīng)的客制目錄下面再修改客制原來就有的作業(yè)：保持原來的作業(yè)名稱新增加入的客制作業(yè)：請(qǐng)遵循命名原則例：Aimi100需要客制---》將此作業(yè)由$AIM復(fù)制到$CIM下新增一支aim作業(yè)---》檢查確認(rèn)原來系統(tǒng)沒有此作業(yè)，在$CIM下新增，依規(guī)定命名，如cimt345當(dāng)4gl需客制時(shí)，對(duì)應(yīng)的per也需要復(fù)制到客制目錄aimi100為料件基本數(shù)據(jù)維護(hù)作業(yè)。aim為系統(tǒng)名稱，i為維護(hù)作業(yè)，100為該作業(yè)的編號(hào)。aimi1001表示附于程序aimi100的子檔案。例外情況：

在『AZZ系統(tǒng)管理』模塊下，程序命名原則就不依照此方式進(jìn)行。該模塊下為依照『程序使用檔案名稱』或『程序用途兩方面來進(jìn)行命名』；此原則是因可讓程序便于辨識(shí)用途，以提升資管人員于調(diào)校程序的效率。例如：『p_zz程序基本數(shù)據(jù)維護(hù)作業(yè)』，因使用『zz_file』記錄。

『p_perlang畫面組件多語(yǔ)言維護(hù)作業(yè)』，因在維護(hù)畫面檔案的『Language』數(shù)據(jù)。附加檔名附加檔案名稱多分為三類：4gl原始程序部份4gl原始程序42m原始程序編譯后的目標(biāo)程序42r連結(jié)后可運(yùn)行的目標(biāo)程序屏幕格式4fdFormDesigner使用的畫面檔per透過gsform工具將4fd檔案轉(zhuǎn)換成的畫面對(duì)照檔42f編譯完成的畫面檔案數(shù)據(jù)其它格式sch檔案參考內(nèi)容舉例：aimi100.4gl,aimi100.42m,aimi100.42raimi100.4fd,aimi100.per,aimi100.42fima_file.sch共享程序命名原則

共享程序?yàn)樵赥IPTOPGP中可全系統(tǒng)通用的函式；格式：cl_xxxxxxx

說明：cl_表示該程序?yàn)楣蚕沓绦颍–ommonLibrary）

xxxxxxx最少1個(gè)字符，最多允許17個(gè)字符【因?yàn)楦骶S護(hù)作業(yè)錄入限制】。必須以有代表意義的方式命名，可加上『_』（下劃線）以資區(qū)隔。舉例：

cl_err顯示錯(cuò)誤信息

cl_opmsg顯示操作時(shí)的相關(guān)提示資料子程序命名原則

程序開發(fā)中，一般會(huì)將部份程序中，可共同使用的函式獨(dú)立出來，另外寫成一支程序，此即為『子程序』。共享程序與一般子程序的差別相同點(diǎn)：多個(gè)程序共通使用的特性。具易維護(hù)節(jié)省開發(fā)之特性。差異點(diǎn)：共享程序：每個(gè)子系統(tǒng)（模塊）皆可適用。一般子程序：只針對(duì)某個(gè)或某幾個(gè)子系統(tǒng)（模塊）。子程序分為兩類：一般子程序查詢子程序一般子程序命名原則格式：s_xxxxxxx

說明：

s_表示該程序?yàn)橐话阌猛咀映绦颍⊿ubfunction）

xxxxxxx最多可用18個(gè)字符，最少1個(gè)字符，需以有意義的方式命名，如：英文的縮寫等。舉例：

s_tlf為庫(kù)存異動(dòng)時(shí)，將異動(dòng)資料寫入異動(dòng)歷史紀(jì)錄中的子程序。

s_upimg為庫(kù)存中，更新img檔案的子程序。查詢子程序命名原則格式：q_xxxxxxx

說明：

q_表示該程序?yàn)椴樵冾悾≦uery）子程序

xxxxxxx最多18個(gè)字符，最少1個(gè)字符須以有代表意義的方式命名，多半以欲查詢的檔案（tablename）名稱命名【參考附注】。若該檔案名稱已使用，則可于后方加上流水號(hào)。舉例：

q_ima 為料件數(shù)據(jù)查詢

q_ima02料件數(shù)據(jù)查詢

q_gef 銷售系統(tǒng)單據(jù)性質(zhì)查詢

函數(shù)命名原則

函數(shù)（Function）為程序中，具有獨(dú)立性質(zhì)，而能提供特殊功能的部份組成。格式：xxxx_yy

說明：

xxxx_為程序代碼簡(jiǎn)稱，多以程序名稱的后4碼表示

yy為該函數(shù)的功能說明

舉例：

i100_a為i100作業(yè)的新增函數(shù)

特別注意：在同一個(gè)主程序名稱下，不可使用相同的函式名稱，以避免程序于連結(jié)或在運(yùn)行階段發(fā)生不可預(yù)期的錯(cuò)誤。

函數(shù)命名原則程序中通常有下列函數(shù)：_a： 處理數(shù)據(jù)新增_r： 處理數(shù)據(jù)取消_b： 處理多欄單身數(shù)據(jù)_rep： 處理報(bào)表格式_copy： 處理數(shù)據(jù)復(fù)制_show： 將數(shù)據(jù)顯示于畫面_cs（或_curs）：處理畫面上給QBE條件_x： 切換資料有無(wú)效_fetch： 處理從數(shù)據(jù)庫(kù)中取得數(shù)據(jù)_u： 處理數(shù)據(jù)更改_i： 處理數(shù)據(jù)錄入_out： 處理簡(jiǎn)表打印_menu： 單檔案程序的功能選擇_bp: 雙檔或單檔多欄（有單身的）程序之功能選擇_q： 處理數(shù)據(jù)查詢_ima01： 處理字段檢查（名稱同字段名稱）_set_entry: 處理字段的動(dòng)態(tài)開啟_set_no_entry:處理字段的動(dòng)態(tài)關(guān)閉（須含判斷式）

變量命名原則

整體性變量（GlobalVaribles）

格式：g_xxxxxxx

區(qū)域性變量（LocalVaribles）

格式：l_xxxxxxx

傳遞性變數(shù)(ParameterVaribles)

格式：p_xxxxxxx

屏幕變量（ScreenVaribles）格式：s_xxxxxxx數(shù)據(jù)庫(kù)表格命名原則

表格名稱（TableName）格式：xxx_file

說明：

xxx以小寫英文字符（可含數(shù)字）命名，可用2至4碼表示。

_file為固定字，表示此為表格

。舉例：

ima_file為料件主檔

gen_file為員工姓名檔

數(shù)據(jù)庫(kù)表格字段命名原則

字段名稱（FieldName）格式：xxx99

說明：xxx與該文件的檔案代碼相同的字符串，99為2碼流水編號(hào)，如果流水號(hào)不足則可擴(kuò)充為3至4碼。舉例：

ima01為料件主檔的料件編號(hào)字段

gen01為員工姓名檔員工編號(hào)字段

數(shù)據(jù)庫(kù)表格字段命名原則字段名稱（FieldName）·若有特殊用途欄位，則定義尾端用字以統(tǒng)一acti資料有效否post資料過賬否mksg資料簽核否conf資料結(jié)案否prsw資料列印次數(shù)prnt立即列印否Slip單別desc單據(jù)名稱type單據(jù)性質(zhì)Myno已用單號(hào)sign簽核等機(jī)conf自動(dòng)確認(rèn)否User資料建立人modu資料修改人grup建立/修改人部門Date資料維護(hù)日數(shù)據(jù)庫(kù)表格索引命名原則

索引名稱（IndexName）格式：xxx_01

說明：xxx與該文件的檔案代碼相同的字符串，01為2碼流水編號(hào)

。舉例：

ima_01為料件主檔的索引

gen_01為員工姓名檔的索引數(shù)據(jù)庫(kù)表格檔案命名原則

Schema檔案名稱（SchFiles）格式：xxx_file.sch

說明：此為表格存在于系統(tǒng)中的檔案名稱xxx為相同于檔案名稱的英文或數(shù)字字符組合而成舉例：

ima_file.sch為料件主檔的Schema檔案名稱

gen_file.sch為員工姓名檔的Schema檔案名稱

客制全新表格檔命名原則客制一個(gè)不存在的表格檔案(table)名稱，須寫

“tc_(固定用法)”+“三碼英文（可含數(shù)字）流水號(hào)”+

“_file(固定用法)”例如：