技转课程-TIPTOP GP环境架构

TIPTOP GP 登入及執行作業
程式執行方式
TIPTOP GP 有
• 建議使用 VTCP 連線工具 TELNET或 SSH 模式 • 需自行安裝 GDC • 連線時藉由設定VTCP可自動帶出GDC • 附掛於 apache web server • 使用者端不需先行安裝 GDC • 啟動時會自動安裝 Active X 版GDC
• qry 目錄下置放『查詢副程式（hard-code）』
系統模組函式名稱範例
• lib 函式名稱如 ：cl_create_qry( ) 動態建立 QUERY 函式 cl_user( ) 抓取 user 資料至全域變數內 • sub 函式名稱如：s_auto_assign_no( ) 自動編號副程式 s_chkinvoice( ) 檢查發票資料用副程式 • qry 函式名稱如 ：q_ala( ) 為查詢 ala_file 資料用副程式 q_pms( ) 為查詢 pms_file 資料用副程式 • qry 若遇到有一個 table 需要數支目的不同的查詢副程式， 可在後方加上流水號以資識別 如：q_apa、q_apa2、q_apa3、q_apa4等， 都是以查詢 apa_file 的資料為主的查詢用副程式
• 當 4gl 需客製時，對應的 per 也需要複製到客製目錄
客製函式及變數命名原則
• 依照 package 原則即可
系統模組架構及命名原則
系統模組架構圖
TIPTOP
系統(共用)模組 4gl 42m 4fd
• 僅指 lib，sub，qry 等系統 模組
• lib ：標準公用函式 如 ：cl_xxx • sub：標準公用副函式 如 ：s_xxx • qry ：標準查詢函式 如 ：q_xxx • 打包為 42x 檔，放入42m 中
函式名稱範例
• 函式名稱為 i100_out( )
– 『i100』作業名稱 (去除模組代碼) – 『_out』功能名稱 • 同一主作業下不可使用相同的函式名稱
變數名稱定義
• 全域變數 (Global Variable) 或模組變數 (Module Variable) 以 『 g_ 』 開頭命名，後方跟上功能用途 • 區域變數 (Local Variable) 以 『 l_ 』 開頭命名，後方跟上功能用途 • 傳遞用的變數 (Passive Variable) 以 『 p_ 』 開頭命名，後方跟上功能用途
4fd
42f per sdd
sch
rep
標準模組下的目錄 – 畫面
TIPTOP
標準模組 4gl 42m 42r

• 4fd ：Genero Studio 產生的畫面檔原碼 • 42f ：編譯完成的畫面檔 資料 • per ：由4fd檔匯出的 文字型態畫面檔 • sdd：畫面規格說明檔
4fd
42f per sdd
• 函式名稱須為 『程式名稱 (扣除模組名)』+『此函式功用』 • 作業中通常有下列函式 _a( ) 資料新增處理 _i ( ) 資料輸入處理 _b( ) 單身資料處理 (含輸入) _cs( ) 或 _curs( ) 處理畫面上 QBE資料條件 _fetch( ) 單身或單頭的資料抓取 _copy( ) 複製功能處理 _out( ) 報表列印功能處理 _show( ) 單檔或單頭資料呈現於畫面 _menu( ) 功能選單 _set_entry( ) 及 _set_no_entry( ) 處理欄位可否輸入變換
sch
rep
標準模組下的目錄 – 其他
TIPTOP
標準模組 4gl 42m 42r
• sch：由資料庫匯出的 資料結構檔 • rep ：存放報表範例格式
4fd
42f per sdd
sch
rep
作業、函式、變數命名原則
作業名稱定義
• 作業名稱須為 『模組名稱』+『一碼程式類別』+『三碼流水號』
• 程式類別 – 以下為常用 I：建檔 (維護作業) T：處理 (交易處理) P：批次處理 Q：查詢作業 S：參數設定 R：報表作業 – 以下很少用 M：選單 (目錄選單) O：其他 (輔助工具) U：更新 • 流水號 (概略區分，同一模組下不可有同一流水號即可) 000-400 系統參數、採購 401-700 生產作業 701-999 銷退及後端處理，系統參數
ima02 記錄料件名稱 gay02 記錄語言別名稱
• 若有特定用途欄位，則定義尾端用字以資統一
acti 資料有效碼 conf 資料結案否 slip 單別 myno已用單號 user 資料建立人 date 資料維護日 post 資料過帳否 mksg 資料簽核否 prsw 資料列印次數 prnt 立即列印否 desc 單據名稱 sign 簽核等級 modu 資料修改人 type conf 單據性質 自動確認否
•
–
『g』為大陸版修改模組
Example：ggl、gpy、gxr
•『c』為客製模組
– Example：cgl、cggl、cpy、cgpy 、clib
客製作業命名原則
• 有需要進行客製化程式碼調整，請勿在package目錄下進行， 請將要客製的作業複製到客製目錄對應模組下再修改 • 客製原來就有的作業：保持原來的作業名稱 • 新增加入的客製作業：請遵循命名原則 • 例： • aimi100 需要客製 將此作業由 $AIM 下複製到 $CIM 下 • 新增一支 aim 作業 檢查確認原來系統沒有此作業後，在 $CIM 下新增，依規定命名，如 cimt345
4fd 42f
4sm top.global
per sdd
per
sdd sch rep
標準模組架構及命名原則
標準模組架構圖
TIPTOP
標準模組 4gl 42m 42r
• 指 aim，apy，aoo 等 ERP 標準模組 • 系統目錄 ($TOP) 下以模 組別作為目錄區分 • 模組下以副檔名 (型態) 不 同作目錄之區分 • 大陸地區因法令制度與台 灣區不同，故區分不同模 組存放作業（agl，ggl）
標準模組下的目錄 – 程式
TIPTOP
標準模組 4gl 42m 42r
• 4gl ：程式原碼置放目錄 • 42m：程式原碼經編譯後 的結果置放處 各程式單獨存在，未經 連結前的程序不一定可 獨立執行。 • 42r ：編譯連結完成後的 執行檔置放處 連結採動態聯結，此目 錄下僅存連結資料，於 執行時會往 42m 目錄讀 取實際程式。
以上用於 4gl， 以下定義於 per
• 螢幕陣列變數 (Screen Array Variable) 以 『 s_ 』 開頭命名，後方跟上主要 table名稱
客製模組架構及命名原則
客製目錄模組名稱定義
•模組代碼須為三至四碼英文組成 •『a』為系統基本模組
– Example：agl、apy、axr 、azz
42f
per sdd 42r
系統模組函式名稱定義
• 由於系統模組是以函式為主體，故4gl名稱不重要，可擇一具 代表性的函式名稱作為 4gl 名稱即可 • lib 函式名稱須為 『 cl_ 』+『此函式功用』 • sub 函式名稱須為 『 s_ 』 +『此函式功用』 • qry 函式名稱須為 『 q_ 』 +『此函式查詢的主要 table 名稱』 • 函式名稱必需清楚易辨，可用『_ 』連結字串
4fd
42f per sdd
sch
rep
Package目錄模組名稱定義
• 模組代碼須為三~四碼英文組成 • 『a』為系統基本模組
– Example：agl、apy、axr 、azz
• 『g』為大陸版修改模組
– Example：ggl、gpy、gxr
• 『lib、sub、qry』三組系統函式除外 • 建立模組：模組代號維護作業(p_zmd)
客製系統模組架構及命名原則
客製全新共用函式命名原則
• 必須在客製目錄（clib、csub、cqry）下新建共用函式 • 新函式程式名稱及內含的函式名稱，不可與標準系統模組 名稱相同 如：$CLIB下，函式名稱為『 ccl_』+『 函式功用』 $CSUB下，函式名稱為『 cs_』+『 函式功用』 $CQRY下，函式名稱為『 cq_』+『 函式功用』 • 透過『程式鏈結記錄維護作業 (p_link)』登錄新函式
• 取用時應由該模組特定區段優先選用 如 im*_file 區段屬 aim 模組
• 表格檔案可利用『檔案架構記錄修整維護作業 (p_zta)』進行 開啟或毀棄工作
欄位命名原則
• 欄位（field）名稱須為 『表格名稱（去除 _file）』+『兩碼到三碼流水號』 • 例如： ima01 gay01
記錄料件代碼用 記錄語言別代碼
Web模式
執行程式的方法
• r.r2 程式代碼 【Ex：r.r2 axmt410 】 • exe2 程式代碼 【Ex：exe2 axmt410 】
執行程式的方法
執行程式的方法
TIPTOP GP 系統架構
正式區及測試區的畫分
安裝目錄
正式區 topprod
測試區 toptest
客製目錄 topcust
• 客製一個不存在的表格檔案（table）名稱，須為 『tc_（固定用法）』+『三碼英文（可含數字）流水號』+ 『_file（固定用法）』 • 例如（範例）： tc_ima_file 輔助 ima_file 用 tc_gae_file 輔助 gae_file 用 • 取用時應由該模組特定區段優先選用 如 im*_file 區段屬 aim 模組， 客製 aim 模組時，可先以 tc_ima_file 編起
grup 建立/修改人部門
索引命名原則
• 索引（index）名稱須為 『表格名稱（去除 _file）』+『 _ 』+『兩碼流水號』 • 例如： ima_01 gay_01