二、TIPTOP命名原则和目录配置—TIPTOP GP ERP二次开发新手教程

命名原则

系统命名原则

系统以三至四个英文字母来命名，第一码为标准或客制的识别码，后面几码为有意义的英文缩写。

（系统代号）格式：

AXX 标准系统模块
GXX 配合两岸三地相关规则调整的模块
CXX 客制（客户定制）化模块

说明：

XX为系统英文缩写代码

例子：

AIM 料件主档（Item Master）、库存(Inventory Management)管理系统
ASM 系统基本数据管理（System Management）

程式（程序）命名原则

1、主要档名

格式：

SSSP999

说明：

SSS为系统代号（要以小写字母表示）
P为程序类型

i       维护作业        r       报表作业
m       目录选单        s       参数设定
p       批次处理        t       交易处理
q       查询作业        u       辅助工具

999为作业代码

在使用作业代码时，第一码表示处理阶段，如：０表示参数设定、１表示基本资料的维护。第二、三码为流水号。
如果在程序中，包含了一个以上的副函式或者子画面，则可以在加上第四码来表示归属于该主程序下的附属资料（画面或程序）。

举例：

aimi100：

aim：料件主档系统代号
i:作业类型为维护作业
100：作业代码

aimi1001(作业代码包括第四码):这个程式名表示程式aimi100的子档案

列外：

比如在AZZ系统管理代号，程序命名原则就不按照此方式进行。
命名原则：依照[程序使用档案名称]或者[程序用途两个方面来进行命名]

2、附加档名

附加档案名称分为三类：4gl原始程序部分、画面格式、其他格式

(1).4gl原始程序部分

4gl:原始程序
42m:原始程序编译后的目标程序
42r:连接后可运行的目标程序

(2).画面格式

4fd:Form Designer使用的画面档
per:透过gsform工具将4fd档案转换成画面对照档
42f:编译完成的画面档案数据

(3).其他格式

sch:档案参考内容
rep:

共享程式（程序）命名原则

共享程序为在TIPTOP GP中可全系统通用的函式，子程序为只有部分子系统可以使用的函式。

格式：

cl_XXXXXXX

说明：

cl_：表示该程序为共享程序（Common Library）
XXXXXXX：最少一个字符，最多17个字符（因为各维护作业录入限制）。命名必须有代表意义，可以加上“_”来区隔。

举例：

cl_err：用来显示错误信息
cl_null：检查输入的值是否为空

共享程序存放的位置：

放置在TIPTOP GP系统中的$TOP/lib目录下，依扩展名的不同分类归放。

子程序命名原则

子程序：

指在程序开发中，一并会将限定在部分程序中，将共同使用的函式独立出来，另外写成一段程序。

子程序的特性：

容易维护、正确、节省开发时间。

子程序分类：

一般子程序；
查询子程序；

1、一般子程序

格式：

s_XXXXXXX

说明：

s_：表示该程序为一般用途子程序（Subfunction)
XXXXXXX:最多18个字符，最少1个字符。需以有意义的方式命名。如：英文缩写等。

举例：

s_upimg为库存系统中，更新img_file的子程序。

一般子程序存放的位置：

放置于TIPTOP GP系统中的$TOP/sub目录下，依据扩展名不同分类归放。

2、查询子程序

格式：

q_XXXXXXX

说明：

q_：表示该程序为查询类（Query)子程序
XXXXXXX：最多18个字符，最少1个字符。需以有意义的方式命名，多半以欲查询的数据库表格（table name）名称命名。
注意：如果该数据库表格名称已被使用，则可以在后面加流水号，辨识前后顺序的不同。

举例：

q_ima为料件数据查询
查询子程序存放的位置：
放置于TIPTOP GP系统中的$TOP/qry目录下，依扩展名不同分类归放。

注意：

查询子程序命名不能与【动态查询子程序】名称冲突，若名字上有冲突，则后续登录数据或者进行系统管理时，会有不可预期的困难和错误情形发生

实际操作指导：

编写简单的查询子程序建议不要自行撰写程序，可参照【AZZ系统管理】模块中队【p_qry】的介绍。自行定义【动态查询子程序】，填写完相关欲查询的表格、字段数据后即可使用，较自行撰写查询子程序简易，于后续管理上也较方便。

3、一般子程序和共享程序的差别

相同点：

多个程序共同使用的特性；
具有易维护、正确、节省开发时间的特性；

不同点：

共享程序【cl_XXXXXXX】每个子系统（模块）皆可适用；
一般子程序【s_XXXXXXX】只针对某个或者某几个子系统（模块）；

函数命名原则

函数（functioin)：

在程序中，具有独立的性质，而且能够提供特殊功能的部分组成。

格式：

XXXX_yy

说明：

XXXX_:为程序代码简称，多与系统（模块)代号后的4码表示
yy：为该函数的功能说明

举例：

i100_a为该作业的新增函数

程序中包含以下函数功能：

注意：

在同一个主程序名称下，不可使用相同的函数名称，以避免程序于连结或在运行阶段发生不可预期的错误。

变量命名原则

依照变量在程序中出现和使用的特性，可以将变量分为总体性变量、区域变量、传递参数及屏幕变量。

1、整体性变量（Global Varibles)

格式：

g_XXXXXXX

说明：

g_：表示该变量具有整体性（Gobal)

XXXXXXX:为变量的名称

举例：

g_gui_type为定义gui的样式为哪一种

整体性变量定义的位置：

整体性变量定义在整体性变量档案中，该档案为$top/config/top.global。

2、区域性变量（Local Varible)

格式：

l_XXXXXXX

说明：

l_：表示该变量具有区域性（Local），仅限与某Function中有效。
XXXXXXX：为有意义的名称，请以有意义的方式命名。

3、传递性参数（Parameter Varlables)

格式：

p_XXXXXXX

说明：

p_：表示该变量具有传递性（parameter)
XXXXXXX：为变量名称，请以有意义之方式命名。

4、屏幕变量（Screen Varlables)

格式：

s_XXXXXXX

说明：

s_:表示该变量为屏幕变量（Screen)
XXXXXXX:为变量名称，请以有意义的方式命名。

使用范围：

在单档多栏中会使用到屏幕变量（Screen varlables）

注意：

屏幕变量（Screen)以字段来命名，以方便和字段做对比。而且，只有使用多栏式数组的程序才需以此方式定义。

数据库表格命名原则

表格命名长度以3至4个英文字符命名，不同的系统，配置了不同的表格名称使用区段，建议在开启新的表格前，先行了解系统原始启动的表格名称范围。

1、表格名称（Table Name)

格式：

XXX_file

客制（客户定制）表格命名格式：

tc_XXX_file

说明：

XXX:用2码至4码表示，以小写英文字符（可含数字）命名。
_file:固定字，表示为表格。

举例：

aim_file为料件主档
gef_file为销售单据性质档

注意：

在开启新表格前，须在【p_zta档案架构修整记录维护作业】中注册该支表格的相关数据及使用方法，始纳入管理。

2、字段名称（Field Name)

格式：

XXX99

客制（客户定制）字段命名格式：

(1).在客制表格中添加客制字段的命名原则：

格式：

tc_XXX99

举例：

tc_ima_file下的客制字段为：tc_ima001、tc_ima002….。

(2).在标准表格中添加客制字段的命名原则：

格式：

ta_XXX99

举例：

ima_file下的客制字段为：ta_ima001、ta_ima002…。

说明：

XXX：与表格名称XXX_file的XXX名称一致。
99：为2码流水编号，如果流水号不足可以扩充为3至4码。

举例：

zz32为表格zz_file中的字段。

注意：

在开启新字段前，须在【p_zta档案架构修整记录维护作业】中注册该支表格的相关数据及使用方法，始纳入管理。

3、索引名称（Index Name)

格式：

XXX_01

客制（客户定制）索引命名格式：

tic_XXX_01

举例：

ima_file表格下的客制索引为tic_ima_01。

说明：

XXX:与表格名称XXX_file的XXX名称一致。
01：为2码流水编号。

举例：

zz_01为在zz_file的UNIQUE INDEX代码。

注意：

在开启新索引前，须在【p_zta档案架构修整记录维护作业】中注册该支表格的相关数据及使用方法，始纳入管理。

4、存放TIPTOP系统中存放的Schema档案（Sch Files)

格式：

XXX_file.sch

说明：

此为表格存在系统中档案名称
XXX:与表格名称XXX_file的XXX名称一致。

例子：

ima_file.sch为料件主档的Schema档案名称。

目录配置

1、TIPTOP目录配置

2、Config目录配置

参考文献下载：http://download.csdn.net/download/wahaa591/8796431