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

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

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

主畫面基本操作說明

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

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

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

A，第二碼為任何字符，但總共只有二碼之數據。

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

=：表示該字段為空白。

>n：表示大于數值n，例：>100。

<n：表示小于數值n，例：<100。

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

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

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

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

正式區(qū)、測試區(qū)、標準區(qū)的畫分

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

系統(tǒng)架構圖

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

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

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

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

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

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

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

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

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

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

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

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

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

共享程序為在TIPTOPGP中可全系統(tǒng)通用的函式；格式：cl_xxxxxxx

說明：cl_表示該程序為共享程序（CommonLibrary）

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

cl_err顯示錯誤信息

cl_opmsg顯示操作時的相關提示資料子程序命名原則

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

說明：

s_表示該程序為一般用途子程序（Subfunction）

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

s_tlf為庫存異動時，將異動資料寫入異動歷史紀錄中的子程序。

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

說明：

q_表示該程序為查詢類（Query）子程序

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

q_ima 為料件數據查詢

q_ima02料件數據查詢

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

函數命名原則

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

說明：

xxxx_為程序代碼簡稱，多以程序名稱的后4碼表示

yy為該函數的功能說明

舉例：

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

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

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

變量命名原則

整體性變量（GlobalVaribles）

格式：g_xxxxxxx

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

格式：l_xxxxxxx

傳遞性變數(ParameterVaribles)

格式：p_xxxxxxx

屏幕變量（ScreenVaribles）格式：s_xxxxxxx數據庫表格命名原則

表格名稱（TableName）格式：xxx_file

說明：

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

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

。舉例：

ima_file為料件主檔

gen_file為員工姓名檔

數據庫表格字段命名原則

字段名稱（FieldName）格式：xxx99

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

ima01為料件主檔的料件編號字段

gen01為員工姓名檔員工編號字段

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

索引名稱（IndexName）格式：xxx_01

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

。舉例：

ima_01為料件主檔的索引

gen_01為員工姓名檔的索引數據庫表格檔案命名原則

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

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

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

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

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

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

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