系统架构及命名
# djc配置
# 系统架构
# 1.系统架构图
系统配置时,均以$TOP作为最上层目录,在$TOP挂上各种系统所需的工具、模块等目录,用做有效率的运作及管理。基本框架如图:
# 2.工作目录
# 3.com/cfg目录配置
本目录下是置放程序执行时所需参照的设定部分。包含工具栏(Tollbar)设定、屏幕显示样式(Window Style)设定及共享功能定义(Action Default)等数据。
# 4.模块下目录配置
模块目录下是实际置放相关数据,包含程序源码(4gl)、画面源码(4fd)、数据表结构(sch)及编译结果(42m、42r、42f)等。
# 命名原则
# 1.模块命名
模块以三个英文字来命名。(包含ERP 的模块/共享COM 的模块等)
第一码为标准标识符: 『A』:标准ERP 模块 第二到三码以系统英文缩写为主,若遇到已使用的代码,则后建者第二码以『X』字符或另以相关缩写取代。
格式:AXX 说明:XX 为ERP 模块的英文缩写代码
目前共享模块 ($COM) 代码如下:
# 2.程序命名
- 主程序编号
程序一般以四码英文及三码数字(共七码)组成。
程序名称的前三码为模块代码,第四码为程序类别,第五码至第七码为作业代码。
格式:SSSQ999
说明:SSS 为模块代码,均以小写字母表示
Q 为程序类别,其意义如下:
- i:基本数据维护作业 m:主文件数据维护作业 t:事务处理
- s:参数设定 p:批处理 q:查询作业 r:报表作业
999 为程序三码数字流水编号
- 子程序档名
若主程序需要另外撰写函式,则会增加子程序,名称前七码会与主程序一致,并再加上『_』(底线)、型态及两码流水号。
一般用途子程序 格式:SSSQ999_88
Genero Report 子程序 格式:SSSQ999_g88
Xtra Grid 子程序 格式:SSSQ999_x88
说明:
SSSQ999 为主程序代码
88 为两码数字流水编号,若为报表用子程序,则依照类型,特别增加g 或x
- 子画面档名
程序开发过程中需要一个以上的画面时,可以额外制作子画面。
格式:SSSQ999_s88
说明:
SSSQ999 为主程序代码
s88 s 为固定用法,88 为两码数字流水编号
- library 档名
共享程序为在T100 中用于系统处理的函式,例如询问开窗、画面组件处理等。
格式:cl_xxxxxxx
说明:cl_表示该程序为共享程序(Common Library)
xxxxxxx 最少1 个字符,最多允许17 个字符【因为各维护作业输入限制】。必须以有代表意义的方式命名,可加上『_』(底线)以资区隔。
- 应用组件文件名
特别商业规则,有通用性质的,可以特别拉出作为『应用组件』。应用组件可以依照功能区分,也可以依照首要调用程序进行命名
格式:s_xxxxxxx
或为:s_ SSSQ999_xxxxx
说明:
xxxxxxx 为功能说明
- 报表结构文件名(rdd 文件)
与主程序/子程序相同名称
- 报表样板文件名(4rp 档)
一份报表组件可允许应用多份报表样板,故命名与报表组件相同,若有多样版需求时,再加上两码数字流水号识别。子报表样板则为主要样板后方再增加_subrep 及流水号用以识别。
主报表 (单一样板) 格式:SSSQ999_g88
主报表 (多样板) 格式:SSSQ999_g88_77
子报表 格式:SSSQ999_g88_subrep66
范例: 主报表 axmr402_g01.4rp (单一样板)
主报表 axmr403_g01_02.4rp (多样板)
子报表 axmr402_g01_subrep01.4rp
说明:
SSSQ999_g88 为报表组件文件名
若有多样版时,后方新增两码数字流水号,以资区别
若有子样板时,后方再新增 _subrep 及两码数字流水号,以资区别
8.其他组件文件名
开窗查询组件
格式:q_xxxxxxx
说明:q_表示该程序为查询类(Query)子程序
xxxxxxx 最多18 个字符,最少1 个字符。须以有代表意义的方式命名,多半以欲查询的档案(table name)名称命名。
若该文件名已使用,则可于后方加上流水号,辨识前后顺序的不同。
范例:q_ima 为料件数据查询
q_gef 销售系统单据性质查询
注:命名时须注意不可与『动态查询子程序』名称冲突,若名称上有所冲突,则后续登录数据或进行系统管理时,都会有不可预期的困难与错误情形发生。
9.共享参数档名(inc 档)
当全局变量需要跨程序(4gl code)应用时,除可以透过程序内的GLOBALS 区块建议,也可以设定共享参数档。若有大量跨模块需求时,则可以将共享参数置放于系统 $ERP/cfg 目录下,并以设定链接方式建立于$COM/cfg 目录
一般用途共享参数档 格式:SSSQ999_88.inc (存放于4gl 目录下)
跨模块共享参数文件 格式:top_XXXXXX.inc
说明:
SSSQ999 为主程序代码
88 为两码数字流水编号
XXXXXX 为功能说明
- 附档名
附档名分为:4gl 原始程序部份、画面、报表,及其他资源文件等类别。意义如下:
4gl 原始程序部份
4gl 原始程序
inc 多个程序共享的参数档案
42m 原始程序编译后的目标程序
42r 连结后可执行的目标程序
画面档案
4fd Form Designer 使用的画面档
per 透过gsform 工具将4fd 档案转换成的画面对照档
42f 编译完成的画面文件数据