erp二次开发规学习手册

TIPTOP GP ERP 二次开发规范说明 TIPTOP ERP 共分三大区：topstd(标准区) + toppord(正式区) + toptest(测试区) 标准区 正式生产环境 用户测试,MIS 程序客制测试 目录结构和 topprod 完全一样 标准 tiptop（$TOP) 客制 topcust（$CUST） 目录结构和$TOP 完全一样,只不过模组目录都 是 c 开头的了 config doc ds4gl2 ora out schema 各模组目录（axm、asf.截止 5.25 已经有 47 个模组 +sub+lib+qry） config：配置文件目录(top.global 全局变量、4ad 各程序 ACTION 列表、4st 画面风格、4tb 界面按钮风格、 等) doc：帮助文档+系统图片目录 ds4gl2：一些脚本目录，如 r.c2、r.l2 等 ora：一下数据库应用查询脚本，如 q_tabFREE 等 out：临时目录 schema： 数据库 sch 文件目录 各模组目录：4fd 画面档目录、per 画面档编译后 per 目录、4gl 源码档、 42m、42r Genero Studio 文件说明 说明：$XXX 表示各个模组；：服务器必须文件； 服务器可选文件 4pw：Genero Studio 项目工程文件（位于服务器目录：$XXX/4pw） 4fd：画面档 （位于服务器目录：$XXX/4fd） per：gsform 后 4fd 画面档对照文件（4fd 经过 gsform 后的文件，位于服务器目录：$XXX/per） 42f：编译后的画面档文件（4fd 经过 r.f2 后的文件，位于服务器目录：$XXX/per） 4gl：源码档（位于服务器目录：$XXX/4gl） 42m：编译后的源码链接档（4gl 经过 r.c2 后的编译档，位于服务器目录： $XXX/42m） 42r：链接后的可执行文件（42m 经过 r.l2 后的链接档，位于服务器目录：$XXX/42r） 4rp：报表文件（位于服务器目录：$XXX/4rp ） sch：数据库表结构文件（位于服务器目录：$XXX/sch） TIPTOP ERP 客制规范命名原则 程序命名原则： XXX(3 码) X(2 码) XXX(3-5 码) 模组名 程序类型 流水号 模组名：如果为标准程序， 程序名一定是 a 开头， 程序位于对应的$AXX 模组目录 如果修改标准程序，有些公司是修改为 c 程序 有些公司还是用原来的 a 程序 但是目录一定都是对应的$CXX 模组目录 如果是新增程序， 程序名一定是 c 开头， 程序目录一定是对应的$CXX 模组目录 程序类型：r 报表类程序、i 基础资料类程序、q 查询类程序、t 交易类程序、p 批处理类程序、s 参数类程序 流水号：一般随便编录，不重复就好；专业些就是同一作用的程序流水号一类 $AZZ 程序都是 p_开头，规则不同与上 $LIB 为共用查询程序，都是 cl_开头 - $CLIB 为 客制共用查询程序，都是 ccl_开头 $SUB 为副程序，都是 s_开头 - $CSUB 为客制副程序，都是 cs_开头 $QRY 为查询程序，都是 q_开头 - $CQRY 为客制查询程序，都是 cq_开头 程序内部 FUNCTION 函数命名原则： X(2 码) XXX(3-5 码)_功能() 常见功能函数如下： _menu：action 功能菜单 _q： 开始查询，调用 _fetch 查取第一笔资料 _cs： QBE 条件查询 及 查询游标声明 _fetch：N、P 、F 、L 、/ 处理下、上、第一笔、末笔、指定笔单头资料读取，并调用_show 显示资料 _show：显示单头资料，如需要并调用_b_fill 填充单身资料 _a： 新增，并先后调用_i(a)输入单头资料 和 _b 输入单身资料 _i： 根据函数接受的参数 a 新增资料、u 更新资料 _u： 更新，调用_i(u)更新资料 _b： 单身 CRUD 业务逻辑 _b_fill： 单身资料填充 _bp： 显示单身资料，提供单身 action 功能选项 _r： 删除整笔资料 _out： 打印函数 _x： 资料无效、有效处理 _pic： 显示或刷新图片 _ef： EasyFlow 送签 _y： 确认 _z： 取消确认 _s： 过账 _w： 过账还原 _gen/_g： 一般为根据某 action 自动产生单身资料 _sub_y_chk 或 _y_chk ：一般为复杂逻辑 t 程序 “确认“动作时执行资料逻辑检查 _sub_y_upd 或 _y_upd：一般为复杂逻辑 t 程序“确认” 动作时执行资料更新 _sub_refresh： 一般为复杂逻辑 t 程序 “确认 “、“ 取消确认“、“过账“ 、“过账还原“ 动作更新后的资 料刷新 _sub_s： 一般为复杂逻辑 t 程序“过账” _set_entry： 设置单头栏位 可进入录入资料 _set_no_entry： 设置单头栏位不可进入录入资料 _set_entry_b： 设置单身栏位 可进入录入资料 _set_no_entry_b： 设置单身栏位不可进入录入资料 _set_required： 设置栏位为必须输入资料 _init： 初始化程序栏位是否可视，ACTION 是否可视 _a_default： 新增资料时赋初值 _b_move_to： 单身栏位赋值、备份 _b_move_back： 单身栏位值还原 修改数据库表栏位命名规则： .修改 现有表现有列：表列名称不变，只是旗标会自动由标准变成客制 .在现有表上增加列：表列规则 ta_原表流水号，ex：ta _ima001 .新增表：表名及表列规则都是 tc 开头，表 tc_xxx_file，表列 tc_xxx 流水号，ex：tc_lee_file，tc_lee001 TIPTOP GP ERP 二次开发流程 前提：熟悉基础的 Linux 命令+4GL 基础语法+SQL 语法,你可以看看本手册里面对应目录的 相关资料 一、p_zta 增加或修改表（如果不用改表,这步可以跳过） 修改表要数据库 DBA 的权限，如果你的账号没有这个权限可以在 Linux 服务器上用 root 执行一下脚步 usermod -a -g dba Linux 用户名（ex：为 liyihui 这个账号添加数据库 dba 组的权限 usermod -a -g dba liyihui） (注意： 是小 g 不是大 G，大 G 是标准组,会覆盖之前用户所在的组，而不是添加组了) 1、登入 p_zta DBA 2、新增或修改表 注意：你至少需要新增或修改 ds 库 和 程序业务使用的数据库，ds 库是程序编译时参照的库( 比如 LIKE ima_file.tc_ima01) . 如果是新建表，先 建立 p_zta 资料后，然后 点击 ；如果是修改表就不用做这步骤了 . 然后点击 ，根据是新增表还是修改表选择对应的选项操作 /非必须操作 . 更新 ds.sch，Linux 服务器上执行命令 r.s2 ds /非必须操作， p_zta 最后会自动 r.s2 一下 我的技巧：如果多个营运中心都需要建立同一张表，我是这么做的 .ds 帐套在 p_zta 按上面的流程建立表 .其他帐套在 PL/SQL 执行 SQL：CREATE TABLE 表 AS SELECT * FROM ds.表 .复制出 zta_file 及 ztb_file 该表的信息（将所属者改为其他帐套，每个帐套一份） .再到 p_zta 里面，修改各个帐套的表的索引就 OK 了 二、如果是将 a 标准程序 修改为 c 客制程序，这里先做；如果是新增程序直接跳过本步骤 为什么要先插入这一步：这样 r.gf 客制程序 2 c 后自动新增的 p_perlang 和 p_per 就不用维护什么资料了 1、p_perlang 复制 a 标准程序的画面档资料为 c 客制程序的画面档资料 p_perlang 先查询出标准程序的资料 - 再按 c（拷贝） - 写入客制程序的代码 + 勾选“ 客制“栏位 ex：先查询 asft620 的资料，然后 复制（按 c） 将 asft620 客制为 csft620 2、p_per 同理 三、新增或修改 4fd 画面档及 4gl 程序源码档 1、Linux 服务器上下载 ds.sch （如果做的 4fd 不用参照表就不用下载了,比如一些报表） Linux 服务器上执行 sz $TOP/schema/ds.sch 2、打开 Genero Studio 软件，开始绘制 4fd 画面档 . 建立 Genero Studio 的工程项目（注意是 .4pw 的工程项目工程文件哟） 点击 Ctrl + S 先保存项目文件，这是个人经常性按 Ctrl+S 保存文件的习惯_ . 导入前面下载的 ds.sch 文件到工程文件中(否则等下做 4fd 画面档时 会出现找不到表的情 . 将导入的 ds.sch 文件保存到工程文件中的 Databases 目录下面 . 新建或修改 4fd 画面档 对于新建 4fd 画面档时，我一般都是先摆好所有的控件，然后选择对应同一个表的所有控件（Ctrl 可多选） ，再一起修改对应的表 做画面档对于单身栏位，在单身列中间插入列时，该列在单身对应的 SR 变量里面一直摆在最后面,而不是 对应的位置，需要手动调整一下(选中上下拉就可以了)： .rz -y 上传 4fd 档到服务器上对应的 ERP 模块 4fd 路径下面（Ex ：$CSF/4fd），编译且预览画面档 r.f2 4fd 画面档 (Ex：r.f2 csft620) r.gf 4fd 画面档（Ex：r.gf csft620 2 c）(2:是语言别,表示中文简体；c:表示客制, 如果是标准模块则换成 p) . 新建或修改 4gl 源码档 写 4gl 代码说明编辑器都可以，但个人还是喜欢用 Genero Studio，因为有关键字着色、语法预警等功能 .rz -y 上传 4gl 源码档到服务器上对应的 ERP 模块 4gl 路径下面（Ex ：$CSF/4gl），编译 4gl（暂不链 接） r.c2 源码档（Ex：r.c2 csft620） .p_link 查询出原标准程序的链接档，然后按 C（复制）出客制程序的链接档，修改对应的项为客制目录下 面的文件就可以了 再新增 p_zz 里面的资料,注意 p_zz 里面的运行指令及模组都要改成客制目录 .回到服务器，链接程序 r.l2 源码档（ Ex：r.l2 csft620） . 回到 p_zz，点击 进入 p