2.1 模块命名原则
模块以三个英文字来命名。(包含 ERP的模块/共享 COM的模块等)
第一码为标准标识符:
『A』:标准 ERP模块
『B』:行业专用 ERP模块
『C』:客制 ERP模块
『D』:客制行业专用 ERP模块
『E』:客制自创 ERP模块
第二到三码以系统英文缩写为主,若遇到已使用的代码,则后建者第二码以『X』字符或
另以相关缩写取代。
格式:AXX
说明:XX为 ERP模块的英文缩写代码
范例:
料件主文件及库存管理系统『AIM』,其中『IM』为『Item Master subsystem』或
『Inventory Management subsystem』的第一个字母缩写。
销售管理系统『AXM』,其中销售应为『Sales Management subsystem』,本应为『ASM』,
但『ASM』代码已由『系统基本数据管理(System Managerment,ASM)』使用,为
不冲突,故本模块代码设定为『AXM』。
目前共享模块 ($COM) 代码如下:
系统代码
lib
中文说明
英文名称
Common Library
备注
共享程序
lng
语言数据与提速文件子程序
一般子程序
Lingual sub function
Common Sub function
Common Query Function
Web Service Subsystem
sub
qry
查询子程序
wss
整合与 web service程序
命名原则 2-1
ERP T100
2.2 程序命名原则
2.2.1主程序编号:
程序一般以三码英文及四码数字(共七码)组成。
程序名称的前三码为模块代码,第四码为程序类别,第五码至第七码为作业代码。
格式:SSSQ999_MM
说明:
SSS为模块代码,均以小写字母表示
Q为程序类别,其意义如下:
『i』基本数据维护作业、『m』主文件数据维护作业、『t』事务处理、『s』参数设定、
『p』批处理、『q』查询作业、『r』报表作业※
999为程序三码数字流水编号
_MM为行业别专用程序代码
若主程序名称后端有加上『_ic』,则表示该作业默认为 IC行业别﹝IC Design﹞专用作
业,不一定可适用于其他行业。若未加入行业别代码,则表示可以为各行业别通用。
例如:『_ic』表示 IC设计业,『_sc』表示鞋、服饰制造业『_ph』表示制药业。
※主文件数据会依照使用时间增长而有增加,基本数据文件则不一定会成长。
范例:
aimi100为料件基本数据维护作业。aim为系统名称,i为维护作业,100为该作业的代号。
架构与维护作业开发手册 2-2
cimi001为客制料件数据维护作业。cim为客制系统名称,i为维护作业,100为该作业的
代号。
bphi100_ph为食品添加物登记证维护作业。bph为行业专用模块名称,i为维护作业,100
为该作业的代号,ph 为行业代号
2.2.2子程序档名
若主程序需要另外撰写函式,则会增加子程序,名称前七码会与主程序一致,并再加上『_』
(底线)、型态及两码流水号,以资区别。
一般用途子程序
行业专用子程序
格式:SSSQ999_88
格式:SSSQ999_MM_88
Genero Report子程序 格式:SSSQ999_g88
Xtra Grid子程序
格式:SSSQ999_x88
说明:
SSSQ999为主程序代码
88 为两码数字流水编号,若为报表用子程序,则依照类型,特别增加 g或 x
_MM为行业别专用程序代码
范例:
aimi100_01为 aimi100的子程序
cimi100_01为 cimi100的子程序
2.2.3子画面档名
程序开发过程中需要一个以上的画面时,可以额外制作子画面。
格式:SSSQ999_s88及 SSSQ999_88_s88
说明:
SSSQ999为主程序代码
SSSQ999_88为子程序代码
s88 s为固定用法,88为两码数字流水编号
范例:
aimi100_s01为 aimi100的子画面
aimi100_01_s01为 aimi100_01的子画面
命名原则 2-3
ERP T100
2.2.4 library檔名
共享程序为在 T100中用于系统处理的函式,例如询问开窗、画面组件处理等。
格式:cl_xxxxxxx
说明:
cl_表示该程序为共享程序(Common Library)
xxxxxxx最少 1个字符,最多允许 17个字符【因为各维护作业输入限制】。必须以有
代表意义的方式命名,可加上『_』(底线)以资区隔。
举例:cl_err
显示错误讯息
cl_about 显示程序信息
格式:ccl_xxxxxxx
说明:
ccl_表示该程序为客制共享程序(Common Library)
xxxxxxx 最少 1个字符,最多允许 17个字符
举例:ccl_trim 表示为去掉前后空白功能客制共享程序
2.2.5 应用组件文件名
特别商业规则,有通用性质的,可以特别拉出作为『应用组件』。应用组件可以依照功能区分,
也可以依照首要调用程序进行命名
格式:s_xxxxxxx
或为:s_SSSQ999_xxxxx
说明:
s_表示为该程序为应用组件
xxxxxxx为功能说明
举例:s_transaction
表示为交易检查
格式:cs_xxxxxxx
或为:cs_SSSQ999_xxxxx
说明:
cs_表示为该程序为客制应用组件
xxxxxxx为功能说明
举例:cs_date
表示为处理日期相关
架构与维护作业开发手册 2-4
2.2.6 报表相关文件名
报表主程序主要处理画面的字段控制,命名请参考『2.2.1主程序编号』。
报表组件主要处理报表的逻辑与运算,分为凭证与查询报表两种类型。一支报表主程序依应
用需求可呼叫多支不同逻辑的报表组件。
标准格式
行业专用格式
凭证报表
查询报表
SSSQ999_g88
SSSQ999_x88
SSSQ999_MM_g88
SSSQ999_MM_x88
说明:
SSSQ999为报表主程序代码
g代表凭证报表,x代表查询报表
88 为两码数字流水编号
_MM为行业别专用程序代码
报表结构文件(.rdd):凭证报表独有。命名与报表组件同,例如:axmr500_g01
报表样板文件(.4rp) :凭证报表独有。一支报表组件允许应用多份报表样板,命名与报表组件
相同,若有多样版需求时,再加上两码数字流水号识别。子报表样板则为主样板加
上’_subrep’及流水号,用以识别
主报表 (单一样板) 格式:SSSQ999_g88
主报表 (多样板)
格式:SSSQ999_g88_77
子报表
格式:SSSQ999_g88_subrep66
说明:
SSSQ999_g88为报表组件文件名,88 为两码数字流水编号
若有多样版时,后方新增两码数字流水号(即_77),以资区别
若有子样板时,后方再新增 _subrep及两码数字流水号(即_subrep66),以资区别
命名原则 2-5
ERP T100
范例:
主程序
报表组件
报表样板(4rp)
标准报表
axmr500
axmr500_g01
axmr500_g01
axmr500_g01_subrep01
axmr500_g02
标准报表(多个报表 axmr500
axmr500_g02
axmr500_g01
bxmr500_ph_g01
组件)
axmr500_g02_subrep01
axmr500_g01_02
标准报表(多个报表 axmr500
样板)
axmr500_g01_02_subrep01
bxmr500_ph_g01
行业别报表
axmr500_ph
(报表组件无引用) bxmr500_ph_g01_subrep01
客制标准报表
新增客制报表
axmr500
cxmr501
axmr500_g01
axmr500_g01
axmr500_g01_subrep01
cxmr501_g01
cxmr501_g01
cxmr501_g01_subrep01
2.2.7 其他组件文件名
开窗查询组件
格式:q_xxxxxxx
说明:
q_表示该程序为查询类(Query)子程序
xxxxxxx最多 18个字符,最少 1个字符。须以有代表意义的方式命名,多半以欲查询的
档案(table name)名称命名【参考附注】。若该文件名已使用,则可于后方加上流水
号,辨识前后顺序的不同。
范例:q_imaa001 为料件代号数据查询
q_ooea001 为组织(门店)编号查询
格式:cq_xxxxxxx
说明:
cq_表示该程序为查询类(Query)客制子程序
xxxxxxx最多 17个字符,最少 1个字符。
格式:q_ xxxxxxx _mm
说明:
xxxxxx最多 15个字符,最少 1个字符。
mm表示为行业别代码
架构与维护作业开发手册 2-6
范例:q_ooea001_ph 为制药业组织(门店)编号查询
【附注】:命名时须注意不可与『动态查询子程序』名称冲突,若名称上有所冲突,则后续登
录数据或进行系统管理时,都会有不可预期的困难与错误情形发生。
2.2.8 Web Service主程序文件名
提供其他整合系统呼叫的外部 Web service主程序。存在于$COM/WSS模块内。
格式:wssp999
说明:
wssp 为固定用法,标示为 web service主程序
999为程序三码数字流水编号
格式:cwssp999
说明:
cwssp 为固定用法,标示为 web service客制主程序
999为程序三码数字流水编号
2.2.9 Web Service子程序档名
提供 Web service主程序专用的相关子程序。存在于$COM/WSS模块内。不提供给一般 ERP程
式进行连结呼叫。
格式:wssp999_88
说明:
wssp999为主程序文件名
88为二码数字流水编号
格式:cwssp999_88
说明:
cwssp999为客制主程序文件名
88为二码数字流水编号
2.2.10 共享参数档名(inc檔)
当全局变量需要跨程序(4gl code)应用时,除可以透过程序内的 GLOBALS区块建议,也可以
设定共享参数档。若有大量跨模块需求时,则可以将共享参数置放于系统 $ERP/cfg目录下,
命名原则 2-7
ERP T100
并以设定链接方式建立于$COM/cfg目录
一般用途共享参数档
跨模块共享参数文件
格式:SSSQ999_88.inc (存放于 4gl目录下)
格式:top_XXXXXX.inc
说明:
SSSQ999为主程序代码
88 为两码数字流水编号
XXXXXX为功能说明
2.2.11附檔名
附档名分为:4gl原始程序部份、画面、报表,及其他资源文件等类别。意义如下:
4gl原始程序部份
4gl 原始程序
inc 多个程序共享的参数档案
42m 原始程序编译后的目标程序
42r 连结后可执行的目标程序
画面档案
4fd Form Designer 使用的画面档
per 透过 gsform 工具将 4fd 档案转换成的画面对照档
42f 编译完成的画面文件数据
报表档案
rdd 报表结构文件
4rp 报表样板文件
资源文件
str 多语言翻译原始文件 (透过 azzi902产生)
42s 多语言翻译编译文件
sch 档案参考内容
4tm/4ad/4tb Genero支援的 TopMenu/ActionDefault/ToolBar配置文件
4pw Genero Studio专案配置文件
2.3 函数命名原则
函数(Function)为程序中,具有独立性质,而能提供特殊功能的部份组成。
架构与维护作业开发手册 2-8
格式:xxxxxxx_yyyy
说明:xxxxxxx_ 为程序文件名的 7码表示
yyyy
为该函数的功能完整叙述
范例:azzi100_insert为 azzi100作业的新增函数
程序中通常有下列函数:
_insert:
_delete:
_show:
处理数据新增
处理数据取消
将数据显示于画面
处理从数据库中取得数据
处理数据更改
_fetch:
_modify:
_input:
_query:
_set_entry:
处理数据输入
处理数据查询
处理字段的动态开启
_set_no_entry: 处理字段的动态关闭(须含判断式)
须特别注意:在同一个主程序名称下,不可使用相同的函式名称,以避免程序于链接或
在运行时间发生不可预期的错误。
2.4 变数命名原则
在程序中使用的变量,依其在程序中所出现及使用的特性,可以分为总体性变量,区域性变
数,传递参数及屏幕变量。
整体性变量(Global Varibles)
格式:g_xxxxxxx
说明:g_ 表示该变量具整体性(Global)
xxxxxxx为变量名称
范例:
g_gui_type:为定义 gui的样式为哪一种
g_errno:为错误讯息代码
整体性变量通常定义在整体性变量文件中,该档案为『$TOP/cfg/top_global.inc』。
区域性变量(Local Varibles)
格式:l_xxxxxxx
说明:l_表示该变量为区域性(Local)变量,仅限于某 Function中有效。
命名原则 2-9
ERP T100
xxxxxxx为变量名称,请以有意义之方式命名
传递性变数(PARAMETER VARLABLES)
格式:p_xxxxxxx
说明:p_表示该变量具传递性(PARAMETER)
xxxxxxx为变量名称,请以有意义之方式命名。
屏幕变量(SCREEN VARIABLES)
格式:s_detailN 或 s_detailN_info 或 s_browser
说明:s_表示该变量为屏幕变量
N以流水号方式定义。注意:当异动时,可能会影响产生的程序代码。
2.5 数据库表格命名原则
表格的命名以 4个英文字符命名,不同的系统,有配属不同的表格名称使用区段,建议在开
启新表格前,先行了解系统原始启用的表格名称范围。
表格名称(Table Name)
格式:xxxx_t说明:xxxx 为 4码小写英文流水号。
_t为固定字,表示此为 T100专用 Schema表格
表格名称的前二码以【模块名称】后二码为优先取用区段,表格名称的后二码为英文流
水号。
范例:imaa_t为料件主文件,【im】为 aim模块,【aa】为流水号。r.t会管控模块
行业包辅助表格命名原则:
行业包所需表格命名为:xxxxmm_t。其中 mm表示行业包名称,例如:imaaic_t,
imaasl_t。
客制表格命名原则:
标准出货表格不可删除。新建表格在原有命名规则后加上“uc”代表客制表格。例
如: imaauc_t。域名(Field Name)
格式:xxxx999z
说明:
xxxx为表格编号 999 为 3码数字流水号 z特别阶层码,一般不需使用,
特别有阶层关系的字段可增一码小写英文流水号,表示阶层关系
范例:imaa001为在 imaa_t记录料件编号的字段
imaa001a 为 imaa001的子阶字段
客制字段命名原则
客制表格的客制字段范例:apqquc001
标准表格的客制字段范例:apqqua001
架构与维护作业开发手册 2-10
行业包辅助字段命名原则:
行业包所需辅助字段命名为:xxxxmm099。其中 mm表示行业包名称,例如:
imaaic001,imaasl002。
若有特定用途字段,则定义尾端用字以资统一
建立(CREATE) crtid / crtdt / crtdp 建立数据员工/建立日期/建立部门
拥有(OWNER)
ownid / owndp 拥有数据员工/拥有部门
修改(MODIFY) modid / moddt 修改员工/修改日期
确认(CONFIRM) cnfid / cnfdt 确认员工/确认日期 (由 adp负责修改)
过账(POST)
pstid / pstdt 过账员工/过账日期 (由 adp负责修改)
字段
固定字尾
stus
字段型态
C001
C203
D001
N004
N004
N004
N802
C813
C813
C501
C007
C007
C007
D003
程序内部应控卡需求及备注
状态代码
单号
docno
docdt
seq
单据日期
项次
T 类 table 单号后一定要跟着单据日期
项次 1
seq1
seq2
ent
要有 seq 才可建 seq1
要有 seq1 才可建 seq2
项次 2
企业编号
法人
comp
site
营运据点
帐别
ld
注:是 LD(小写)
应用执行组织对象
帐务归属组织
核算组织
时间戳
unit
orga
legl
stamp
不可设为 KEY 值字段
必要字段:
主文件、参数文件、基础数据文件必要字段为:crtid、crtdp、crtdt、ownid、owndp、modid、
moddt、stus。
交易文件必要字段为:crtid、crtdp、crtdt、ownid、owndp、modid、moddt、stus、
cnfid、cnfdt。
自定义字段命名原则:
数据表属于『主档』、『明细文件』、『交易文件』等类型,则依照字段命名原则加入“ud”
代表提供客制字段需求。例如: imaaud001、imaaud002…。
自定义字段须依序新增 001-010属于文字类型字段﹝使用型态 C003﹞,011-020属
命名原则 2-11
ERP T100
于数值字段﹝使用型态 N101﹞,021-030属于日期时间字段﹝使用型态 D002﹞。
索引名称(Index Name)
格式:xxxx_Qy
说明:xxxx与该文件的档案代码相同的字符串,Q为索引种类(normal或 unique),y不管控(y为
0~多码)
范 例:imaa_n01为在 imaa_t的 normal索引代码。imaa_u01为在 imaa_t的 unique索引代码
客制索引命名原则:
新客制表格与原有标准表格的索引命名相同。
例如:imaauc_t客制表格建立的 normal索引即为 imaauc_n01
标准表格另建立客制索引时,则在前加上“tic_”。
例如:imaa_t下原有 normal索引为 imaa_n01,新增客制 normal索引则可建为
tic_imaa_n01
行业包辅助表索引命名原则
例如:imaaic_t建立的 normal索引即为 imaaic_n01
Primary Key名称(Primary Key)
格式:xxxx_pk
说明:xxxx与该文件的档案代码相同的字符串,_pk为固定字。Primary Key由 r.t自动命名,
只有一组而且无法更换名称。
范例:imaa_pk为在 imaa_t的 Primary Key代码。
客制 Primary Key命名原则:
新客制表格与原有标准表格的 Primary Key命名相同。
例如:imaauc_t客制表格建立的 Primary Key即为 imaauc_pk
行业包辅助表 Primary Key命名原则
行业包辅助表与原有标准表格的 Primary Key命名相同。
例如:imaaic_t建立的 Primary Key即为 imaaic_pk
Footing Data名称(FD)
格式:xxxx_fdy
说明:xxxx与该文件的档案代码相同的字符串,_fd为固定字,y不管控(y为 0~多码)。Footing
Data由 r.t自动命名,可建立多组但无法更换名称;此字段信息仅提供 r.a及产生器
参考用,并不会在数据库实际建立。
范例:imaa_fd为在 imaa_t的 Footing Data代码。
客制 Footing Data命名原则:
新客制表格与原有标准表格的 Footing Data命名相同。
例如:imaauc_t客制表格建立的 Footing Data即为 imaauc_fd
行业包辅助表 Footing Data命名原则
架构与维护作业开发手册 2-12
行业包辅助表与原有标准表格的 Footing Data命名相同。
例如:imaaic_t建立的 Footing Data即为 imaaic_fd
命名原则 2-13
转载请注明:赫非域 » T100手册 命名原则