TIPTOP GP 5X 客制规范手册 (Ver.5.02) TIPTOP GP 客 制规范 -2 - 易拓研 发部 目录 1. TIPTOP GP 客制文档更改规范.3 1.1 、新增 Table 的规则 .3 1.2 、现有 Table 中新增字段的规则.4 1.3 、Table 中新增或更改 Index 的规则.5 1.4 、Table 中新增或更改 Constraint 的规则.5 1.5 、现有 Package Table 中更改字段的 Data Type 及长度.6 1.6 、现有 Package Table 中更改字段的用途.6 2. TIPTOP GP 客制程式更改规范. 7 2.1 、系统安装时即已设置的环境变量说明.7 2.2 、 .profile 中需更改.8 2.3 、客制与更改程序规则.9 2.4 、客制程式步骤.17 2.5 、客制与更改程序示范.26 1 、TIPTOP GP 客制文档【Table Schema】更改规范 前言 为了让产品因客户特殊需求功能，而必须个案调整 TIPTOP 应用程序，或 Table Schema 的同时，也保有产品版本的完整性及未来升级的便利性，在此将对于客制化的方式及环境， 给予正确且完整的建议。 1.1. 新增 Ta b l e 1. 保留 ga 开头的文档编号给 TIPTOP GP 以上的版本运用 【Ex ：gaa_file 、gab_file 】 。 2. 因个案新增的文档建议其命名方式为：tc_?_file ，用于区别 package 所使用的文档 【调整 tc_?_file 】 。 格式： t c _ i m a _ f i l e 其中，1、2 码固定为tc ，411 码为文件名称。如：ima_file 。 3. 字段命名方式为 tc_?sss ： ? 代表该字段依 TIPTOP 标准命名原则，亦即文件名称的前三码。 sss 为流水号。 例如：要在 tc_ima_file 【料件基本资料档】录入字段，可以将该字段命名为 tc_ima010 ，其它依此类推。 格式： t c _ i m a 0 1 0 其中，1、2 码固定为tc ，46 码为文件名称的前三码，如 ima ；79 码 010 为流 水号，流水号可以为两码。 4. 必须通过文档架构修整记录维护作业【p_zta 】 录入以便留下记录。 TIPTOP GP 客 制规范 -3 - 易拓研 发部 1.2. 现有 Ta b l e 中新增字段 1. 字段命名原则为： ta_?sss 其中， ta 代表个案新增的字段。 ? 代表该字段依 TIPTOP 标准命名原则定订，即文件名称的前三码。 sss 为流水号。 例如： 要在 ima_file 【料件基本资料档】 新增一字段， 可以将该字段命名为： ta_ima010 ， 依此类推。 格式： t a _ i m a 0 1 0 其中 1、2 码固定为ta ；46 码为文件名称的前三码，如 ima ；79 码 010 为流水号，流水号可以为两码。 2. 必须通过文档架构修整记录维护作业【p_zta 】 录入以便留下记录。 TIPTOP GP 客 制规范 -4 - 易拓研 发部 1.3. Table 中新增或更改 Index 1. 建议 Index 命名原则为： tic_?_sss 其中， tic 代表个案新增或更改的 index 。 ? 代表该 Index 依 TIPTOP 标准命名原则，亦即文件名称的前三码。 sss 为流水号。 格式： t i c _ i m a _ 0 0 1 其中 13 码固定为tic ；57 码为文件名称的前三码如 ima ；911 码 001 为流水号， 流水号可以为两码，但不得为其它文字。 2. 必须通过文档架构修整记录维护作业【p_zta 】 录入以便留下记录。 1.4. Table 中新增或更改 Primary Key 1. 建议 Primary Key 命名原则为： tpc_?_pk 其中， tpc 代表个案新增或更改的 Primary Key 。 ? 代表该 Primary Key 依 TIPTOP 标准命名原则，亦即文件名称的前三码。 pk 表示 Primary Key 的固定缩写。 格式： t p c _ i m a _ p k 其中 13 码固定为tpc ；57 码为文件名称的前三码如 ima ；910 码固定为pk 。 2. 必须通过文档架构修整记录维护作业【p_zta 】 录入以便留下记录。 TIPTOP GP 客 制规范 -5 - 易拓研 发部 TIPTOP GP 客 制规范 -6 - 易拓研 发部 1.5. 现有 Package Table 中更改字段的 Data Type 及长度 1. 不允许就现有 Package Table 更改字段的 Data Type 2. 字段长度也不要更动。若有必要也只能对字段长度放大。 1.6. 现有 Package Table 中更改字段的用途 1. 不允许更改字段用途。 2. 不得使用【No Use】字段。 TIPTOP GP 客 制规范 -7 - 易拓研 发部 2 、TIPTOP GP 客制程式更改规范 2.1、系统安装时即已设置的环境变量说明 A、 客制目录：topcust 【与 tiptop 建在同一层】 ： $CUST：指向客制目录 $TOP ：指向标准模块目录 B、 $CUST 目录下的 config 以及 bin 目录： config ：目录下录入 4ad 、4tm 、include （客制时请检查是否有遗漏） bin ：目录存放环境变量设置文件cust_sys ，必须通过 p_zmd( 模块编号维护作业) 来维护。 注： a. $CUST/config 目录下不得放置 top.global 文档， 以免上 patch 后， 因为与 package 区环境变量不一致时，导致程序 link 不成功。 b. 若因为客制必须新增 global 变量， 则可在$CUST/config 下新增一 cust.global 文 档，惟内容中所定义之变量名称，不得与$TOP/config/top.global 内容之变量名 称相同。 C、 客制区的环境变量设置文件： $TOP/bin/tiptop_sys：标准 TIPTOP 的环境变量设置文件 $CUST/bin/cust_sys ：录入客制区各个模块的环境变量 如：$COO、$COOi 、$CIM、$CIMi 、$CSF 、$CSFi、$CZZ、$CZZi 注：a. 正式区与测试区的目录结构相同，皆有 tiptop（标准模块）及 topcust （客制区） 目录。 D、 客制区各模块开头名称由 a 改为 c 开头： 如：cim 、cxm. g 开头各模块名称，及 lib 、sub 、qry 等皆多加一字符c ： 如：cggl 、clib 、csub 、cqry. 【注：模块名称限制为 34 码 ，其目录结构同$TOP 下的各模块】 E、 CR 主机客制目录： topprod 的实际路径topcust 模块(cim.cxm) 程序编号语言别 例如:aimr100 的 CR 客制 D:topprodtopcustcimaimr1000aimr100_0_icd.rpt TIPTOP GP 客 制规范 -8 - 易拓研 发部 2.2、 .profile中需确认 【绿色 字 为说明】 CUST=/u2/topprod/topcust; export CUST #客制区环境变量 CUSTCONFIG=$CUST/config; export CUSTCONFIG #新增客制区环境变量 CDPATH=.$CUST:$TOP;export CDPATH #先搜寻$CUST DBPATH=.$CUST:$TOP;export DBPATH #先搜寻$CUST .$TOP/bin/tiptop_sys .$CUST/bin/cust_sys #读取客制区环境变量设置文件 cd $TOP #标准目录的 FGLLDPATH 定义，程序运行 42m 搜寻路径 sys=ls -d a? g? lib qry sub 2/dev/null for m in $sys FGLLDPATH=$TOP/$m/42m:$FGLLDPATH export FGLLDPATH cd $CUST #客制目录的 FGLLDPATH 定义，程序运行 42m 搜寻路径 custsys=ls -d c? c? 2/dev/null for m in $custsys FGLLDPATH=$CUST/$m/42m:$FGLLDPATH export FGLLDPATH TIPTOP GP 客 制规范 -9 - 易拓研 发部 2.3、客制与更改程序规则 区分客制区的目的在： 清楚区分哪些程序客制、无客制 清楚知道程序更改的部分、为什么更改、更改的段落、谁更改、何时更改 可快速取得被更改过的程序清单 故统一客制区更改规则。 A . 规则 规则如下所述： 标准区程序不更改 【包含 4gl、4fd 】 ， 要客制就是搬到该模块对应的客制路径， 所有 的调整皆在客制区（$CUST ）中完成，并留下客制记录。 客制程式时，就算毋需调整画面，也务必将相关 4fd 档复制至客制区。 ( 以防止 patch 进行后，客制程式与 package 画面无法搭配的情况。) 若为完全新增之程序， 程序编号以 c开 头 ， 若为现有程序之客制， 则仅需复制至 客制区更改，但程序名称不变。 例如：