最新消息:本站持续更新中,请注意添加收藏夹。搜索关键词时,多换一个同义词。比如要搜索界面,可以尝试页面,画面,PER档等词汇。善于搜索,将大大提高你的查找效率。

T100手册 命名原则

后端代码 bron1984 6396浏览

 

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手册 命名原则